next up previous contents index
Next: RGDATA /FORMAT Up: GREG2 Language Internal Help Previous: RESAMPLE

   
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". 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:
      - Without arguments following the command, or with 3 arguments, RGDATA
        will  try  to assemble Z=f(X,Y) either form 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 previously created by command SIC\DEFINE.
        The option /INCREMENT is used to force the X and Y sampling interval
        to  (IncX,IncY)  in  case of roundoff errors. 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  RGDATA
        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.  RGDATA
    allocates virtual memory according to the map size, so that there is  no
    limit  on the array dimensions. Beware however that handling maps larger
    than 512 by 512 pixels may be slow...


 

Gildas manager
1999-03-12