NEX2GINI creates a GINI format image composite of NEXRAD level III products.

INPUT PARAMETERS
 
    GRDAREA   Area covered by grid
    PROJ      Map projection/angles/margins|drop flag
    KXKY      Number of grid points in x;y
    CPYFIL    Grid file whose navigation is to be used in new grid file | subare
    GFUNC     Scalar grid
    RADTIM    Radar composite current/dattim
    RADDUR    Radar time window (minutes prior to RADTIM)
    RADFRQ    Update Frequency
    STNFIL    Station information file
    RADMODE   Radar operational mode
    RADFIL    Radar image filename(s)
    COMPRESS  Write output in compressed format
 
 

PROGRAM DESCRIPTION
 
   NEX2GINI samples NEXRAD Level III (NIDS) products to a common
   grid projection. Then creates a GINI format image with
   appropriate header information using the grid as the
   image raster. NEX2GINI is not limited by the traditional LLMXGD
   limitation for grid files.

   NEX2GINI uses a suplemental table $GEMTBL/unidata/nex2gini.tbl to specify 
   configurations for product identifiers so that the generated images
   are correctly identified for enhancement tables in $GEMTBL/sat/imgtyp.tbl.

   RADFIL specifies the output GIF file. If the file already exists,
   it is overwritten.

   CPYFIL may provide either an existing grid file to read the projection
   information from, or a grid number (#nnn) defined in grdnav.tbl.

   PROJ, GRDAREA, and KXKY define a grid navigation as in GDCFIL if
   CPYFIL is blank. The GINI format has additional restrictions
   which limit which GEMPAK projections may be used. These are,
   LCC tangent projection (eg la1 and la2 are the same), STR, and CED.

   STNFIL is the station table which supplies radar IDs to be searched
   for the composite. If STNFIL is blank, then 'nexrad.tbl' is used
   by default.

   GFUNC is the data parameter which the composite is created for.
   The NEXRAD file naming is assumed to be such that the site identifier
   and the product type are both present in the directory/file naming
   structure. The datatype.tbl template NEXRIII is used to provide the
   file naming convention used. If NEXRIII is not found in the template
   database, a default directory structure for NEXRAD data is assumed
   where the root directory $RAD/NIDS contains a tree structure supporting
   %SITE%/%PROD%/%PROD%_YYYYMMDD_HHNN file names. The %SITE% template
   will be replaced by the site IDs in the STNFIL table. The %PROD% will
   be replaced by the GFUNC product name. The GEMPAK data/time template
   will be used with RADTIM and RADDUR to determine which NEXRAD products
   are in the valid time range.

   RADTIM determined the output grid time for the radar composite.
   The value of RADTIM may either be 'current', or a GEMPAK dattim.
   If 'current' is selected for RADTIM, then the current system clock
   time is used. No data files later than RADTIM will be included
   in the composite. RADDUR provides the time window previous to
   RADTIM in order to include data for each site. The time closest
   to RADTIM will be used. A default RADDUR of 30 minutes is
   used if RADDUR is blank.

   RADFRQ is the frequency in minutes at which the program will run.
   When RADFRQ is defined, NEX2GINI will wait for the specified time
   before rerunning. This option is most useful when RADTIM is
   set to 'current'. When the program is sleeping, ctrl-c can be
   used to exit the loop and return to the dynamic tutor. If
   RADFRQ is not set, the dynamic tutor will be re-entered at the
   end of processing the radar mosaic.

   RADMODE allows the user to select whether to include radar data
   from sites operating in (P) precipitation/storm mode, (C) clear
   air mode, and/or (M) maintainence mode. The default, if none
   are specified is data from all 3 modes (PCM). Multiple modes
   may be specified.

   COMPRESS allows the user to optionally write the GINI file using PNG
   compression for the image raster. The GINI header will identify the
   image as a compressed product.


EXAMPLES
 
    1.  Create a 1km National composite of NEXRAD base reflectivity (N0R).
        Use the current time with a 30 minute window for data. Rerun the
        mosaic creation continuously with a 5 minute wait period between
        each update. Use the nexrad.tbl station table. Create the 
        output file using the rad_YYYYMMDD_HHNN file name template.
        Accept data from radars operating in precipitation and
        clear air mode. 

        GRDAREA  = 23;-120;47.2634;-63.5664
        PROJ     = lcc/40;-100;40
        KXKY     = 4736;3000
        CPYFIL   =
        GFUNC    = n0r
        RADTIM   = current
        RADDUR   = 30
        RADFRQ   = 5
        STNFIL   = nexrad.tbl
        RADMODE  = PC
        RADFIL   = rad_YYYYMMDD_HHNN

ERROR MESSAGES
 
    [NEX2GINI  +5] Mode rejected: ...
    [NEX2GINI  +4]  Write image ...
    [NEX2GINI  +3]  Using default station file ...
    [NEX2GINI  +2]  NEXRIII template not found using ...
    [NEX2GINI  +1]  Too old: ...
    [NEX2GINI  0]  Using:   ...
    [NEX2GINI  -1]  Fatal error initializing TAE.
    [NEX2GINI  -2]  Fatal error reading TAE parameters.
    [NEX2GINI  -3]  Fatal error initializing GEMPLT.
    [NEX2GINI  -4]  Failed to read grid projection ...
    [NEX2GINI  -8]  Station table ... not found