RGDATA

##
RGDATA

            [GREG2\]RGDATA  [Name|Array_X Array_Y Array_Z]  [/SUBSET NXmin NYmin
        NXmax NYmax] [/VARIABLE] [/FORMAT Fmt  [code]]  [/INCREMENT  IncX  IncY]
        [/BLANKING Bval]

        This  command  optionally creates, then loads a two-dimensional map into
        the Regular Grid array (to be contoured by RGMAP, plotted  by  PLOT...).
        This is THE basic command needed for subsequent 2-dimensional treatment.
        "Regular Grid" means that data is internally stored as a two-dimensional
        array,  thus  lies on a Regularly sampled Grid. The user-provided "pixel
        values" may come from various "descriptions" of such  regularly  sampled
        (but possibly uncompletely sampled) data:
           1) Three  1-dimensional arrays, say, X Y and Z, that contain Z=f(X,Y)
            at regular intervals in X and Y.
           2) A preexisting internal 2-D array (possibly a section of a 3D or 4D
            array).
           3) An external, specially formatted, file.

        For  data  NOT  REGULARLY ("randomly") sampled, use the GREG2\RANDOM_MAP
        command instead. The Regular Grid is itself a 2D SIC variable under  the
        name  "RG".  Its  extrema are available in the variables RGMIN and RGMAX
        (values) and RG_XMIN, RG_XMAX, RG_YMIN,  and  RG_YMAX  (position).  Once
        loaded, the RG can be saved on a file with the command GREG2\WRITE.

        The  following  command  syntax is used to deduce which "description" is
        provided:

          - With 0 or 3 arguments, RGDATA will try to assemble  Z=f(X,Y)  either
            from  the  X,Y  and  Z arrays (as defined by command COLUMN) or from
            "Array_X Array_Y Array_Z", that should be 1D SIC variables previous-
            ly  created. The option /INCREMENT is used to force the X and Y sam-
            pling interval to (IncX,IncY) in case of roundoff  errors.  Defining
            twice  the  same pixel is an error. If a blanking value is currently
            defined, non-sampled pixels will be attributed this value, which  is
            overriden by the Bval value of the /BLANKING option. Note that, if a
            blanking value is currently defined, pixels for which X or Y are  in
            the blanking range are themselves blanked.

          - With ONE argument (Name) following the command, Name is taken as the
            name of an existing SIC 2D variable if option /VARIABLE is  present.
            Otherwise,  Name  is  a  specially  formatted  file  (see HELP RGDA-
            TA FILE_FORMAT) from which the Regular Grid array must be read in.

        A rectangular subset of the array defined by the  pixel  coordinates  of
        the  Bottom  Left  Corner and Top Right Corner can be selected thanks to
        the /SUBSET option.

Subsections

- RGDATA FILE_FORMAT
- RGDATA /FORMAT