DEFINE FITS

        [SIC\]DEFINE FITS Var File [HEADER] [ [index] [T] [B] ]  [/GLOBAL]

    Define  variables  associated  to  the keywords and data of a FITS file.
    The defined variables depend on the FITS file content. Both "basic" FITS
    files and FITS extension (XTENSION) are handled.

    The  HEADER  keyword  indicates to read only the FITS Headers (which in-
    cludes any Extension), not the main data array.

    An 'index' value may be added to read only the 'index'-th extension.

    With 'B' code (stands for Basic): define only the  basic  keywords,  not
    proprietary  keywords. In particular suppress HIERARCH keyword structure
    present in ESO FITS headers.

    The 'T' code may be added to get all multidimensional arrays  transposed
    (depending on how the FITS file was written, sometimes the dimensionali-
    ty of the SIC variables created from the FITS structure  is  not  handy.
    Using the transposition code can be a solution then).

    The 'index', 'T' and 'B' codes can appear in any order.

    For basic FITS data, the following variables are defined
       VAR%NDIM       Integer        Number of dimensions
       VAR%DIM        Integer[4]     Dimensions
       VAR%CONVERT    Double[3,4]    Conversion formulae for the 4 axes:
                                     Reference pixel, Value at reference
                                     pixel, Increment
       VAR%DATA       Real           FITS data array
    The  variables  are  defined as part of a structure. GreG command LIMITS
    /RGDATA A recognizes such a basic FITS structure in much the same way as
    GILDAS images.

    The  DEFINE FITS  command tries to define a SIC structure which contains
    all FITS keywords, as well as all binary and  ASCII  tables  located  in
    FITS extensions.

    Support  for  Random groups (although this is an obsolescent FITS struc-
    ture, it is still widely used) is also available.

    DEFINE FITS only works to read FITS files, but not to create them.   See
    VECTOR\FITS  to  write FITS files (and also read them, but only the main
    array so far).