Provided by: libmath-planepath-perl_113-1_all bug

NAME

       Math::PlanePath::DigitGroups -- X,Y digits grouped by zeros

SYNOPSIS

        use Math::PlanePath::DigitGroups;

        my $path = Math::PlanePath::DigitGroups->new (radix => 2);
        my ($x, $y) = $path->n_to_xy (123);

DESCRIPTION

       This path splits an N into X,Y by digit groups separated by a 0.  The default is binary so
       for example

           N = 110111001011

       is split into groups with a leading high 0 bit, and those groups then go to X and Y
       alternately,

           N = 11 0111 0 01 011
                X   Y  X  Y  X

           X = 11      0    011 = 110011
           Y =    0111   01     =  11101

       The result is a one-to-one mapping between numbers N>=0 and pairs X>=0,Y>=0.

       The default binary is

           11  |   38   77   86  155  166  173  182  311  550  333  342  347
           10  |   72  145  148  291  168  297  300  583  328  337  340  595
            9  |   66  133  138  267  162  277  282  535  322  325  330  555
            8  |  128  257  260  515  272  521  524 1031  320  545  548 1043
            7  |   14   29   46   59  142   93  110  119  526  285  302  187
            6  |   24   49   52   99   88  105  108  199  280  177  180  211
            5  |   18   37   42   75   82   85   90  151  274  165  170  171
            4  |   32   65   68  131   80  137  140  263  160  161  164  275
            3  |    6   13   22   27   70   45   54   55  262  141  150   91
            2  |    8   17   20   35   40   41   44   71  136   81   84   83
            1  |    2    5   10   11   34   21   26   23  130   69   74   43
           Y=0 |    0    1    4    3   16    9   12    7   64   33   36   19
               +-------------------------------------------------------------
                  X=0    1    2    3    4    5    6    7    8    9   10   11

       N=0,1,4,3,16,9,etc along the X axis is X with zero bits doubled.  For example X=9 is
       binary 1001, double up the zero bits to 100001 for N=33 at X=9,Y=0.  This is because in
       the digit groups Y=0 so when X is grouped by its zero bits there's an extra 0 from Y in
       between each group.

       Similarly N=0,2,8,6,32,etc along the Y axis is Y with zero bits doubled, plus an extra
       zero bit at the low end coming from the first X=0 group.  For example Y=9 is again binary
       1001, doubled zeros to 100001, and an extra zero at the low end 1000010 is N=66 at
       X=0,Y=9.

   Radix
       The "radix => $r" option selects a different base for the digit split.  For example radix
       5 gives

           radix => 5

           12  |  60  301  302  303  304  685 1506 1507 1508 1509 1310 1511
           11  |  55  276  277  278  279  680 1381 1382 1383 1384 1305 1386
           10  | 250 1251 1252 1253 1254 1275 6256 6257 6258 6259 1300 6261
            9  |  45  226  227  228  229  670 1131 1132 1133 1134 1295 1136
            8  |  40  201  202  203  204  665 1006 1007 1008 1009 1290 1011
            7  |  35  176  177  178  179  660  881  882  883  884 1285  886
            6  |  30  151  152  153  154  655  756  757  758  759 1280  761
            5  | 125  626  627  628  629  650 3131 3132 3133 3134  675 3136
            4  |  20  101  102  103  104  145  506  507  508  509  270  511
            3  |  15   76   77   78   79  140  381  382  383  384  265  386
            2  |  10   51   52   53   54  135  256  257  258  259  260  261
            1  |   5   26   27   28   29  130  131  132  133  134  255  136
           Y=0 |   0    1    2    3    4   25    6    7    8    9   50   11
               +-----------------------------------------------------------
                 X=0    1    2    3    4    5    6    7    8    9   10   11

   Real Line and Plane
       This split is inspired by the digit grouping in the proof by Julius Koenig that the real
       line is the same cardinality as the plane.  (Cantor's original proof was a "ZOrderCurve"
       style digit interleaving.)

       In Koenig's proof a bijection between interval n=(0,1) and pairs x=(0,1),y=(0,1) is made
       by taking groups of digits stopping at a non-zero.  Non-terminating fractions like
       0.49999... are chosen over terminating 0.5000... so there's always infinitely many non-
       zero digits going downwards.  For the integer form here the groupings are digit going
       upwards and there's infinitely many zero digits above the top, hence the grouping by zeros
       instead of non-zeros.

FUNCTIONS

       See "FUNCTIONS" in Math::PlanePath for behaviour common to all path classes.

       "$path = Math::PlanePath::DigitGroups->new ()"
       "$path = Math::PlanePath::DigitGroups->new (radix => $r)"
           Create and return a new path object.  The optional "radix" parameter gives the base
           for digit splitting (the default is binary, radix 2).

       "($x,$y) = $path->n_to_xy ($n)"
           Return the X,Y coordinates of point number $n on the path.  Points begin at 0 and if
           "$n < 0" then the return is an empty list.

OEIS

       Entries in Sloane's Online Encyclopedia of Integer Sequences related to this path include

           <http://oeis.org/A084471> (etc)

           radix=2 (the default)
             A084471    N on X axis, bit 0->00
             A084472    N on X axis, in binary
             A060142    N on X axis, sorted into ascending order

SEE ALSO

       Math::PlanePath, Math::PlanePath::ZOrderCurve, Math::PlanePath::PowerArray

HOME PAGE

       <http://user42.tuxfamily.org/math-planepath/index.html>

LICENSE

       Copyright 2011, 2012, 2013 Kevin Ryde

       This file is part of Math-PlanePath.

       Math-PlanePath is free software; you can redistribute it and/or modify it under the terms
       of the GNU General Public License as published by the Free Software Foundation; either
       version 3, or (at your option) any later version.

       Math-PlanePath is distributed in the hope that it will be useful, but WITHOUT ANY
       WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.  See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with Math-
       PlanePath.  If not, see <http://www.gnu.org/licenses/>.