McIDAS-XCD Administrator's Guide
Version 2023.1

[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]


Configuring Additional GRIB2 ADDE Datasets

Adding a new GRIB2 dataset that accesses data in the MySQL/MariaDB database is a multi-step process.  You must first access the navigation parameters of the GRIB2 file, then add these parameters to the ~mcidas/data/grib2NavLookup.txt file, use the DSSERVE command to add the dataset to your RESOLV.SRV file, and then stop and restart McIDAS-XCD for your changes to take effect.

  1. From a McIDAS session as user oper, run the GRIB2NAV command to list the navigation parameters of the GRIB2 file.

    Type: GRIB2NAV GRIB2Filename

    where GRIB2Filename is the fully qualified path of a valid GRIB2 file on your system.

    Example output is:

    Nav parameters for message 66, field 0 are NAM, 6, -4564482,
            2089981, 20318, 950000, 250000, 250000 

  2. If the navigation parameters already exist in the ~mcidas/data/grib2NavLookup.txt file, then you can either edit the first column to match your new dataset descriptor, leave the dataset as is and do nothing, or change the DATAFILE=DESCRIPTOR option of the DSSERVE command in step 3 below to match the first column of the navigation entry.

    If the navigation parameters do not exist in the ~mcidas/data/grib2NavLookup.txt file, then you will need to add them by logging in as user mcidas and updating the file.  The format of this data file is as follows: 

    Column 1 is the filename prefix for the GRIB2 file created by McIDAS-XCD (12 character maximum).  It is best if this is also the dataset descriptor name for the new dataset.

    Column 2 is the grid source name (4 character maximum).

    Column 3 is the projection type (1 and 4 are Mercator, 2 is Polar Stereographic, 6 is Lambert Conformal).

    Columns 4-9 are the navigation parameters calculated by the GRIB2NAV command.

    From the example above, the new navigation entry you should add to the ~mcidas/data/grib2NavLookup.txt file would be:

    NAM-USLCAW20 | NAM | 6 | -4564482 |2089981 | 20318 | 950000 | 250000 | 250000


    Note: If you update the ~mcidas/data/grib2NavLookup.txt file, make a backup copy of the updated file so you can restore your local changes if the original file is overwritten (e.g., by installing a new version of McIDAS-X).

  3. From a McIDAS session in the mcadde account, use the DSSERVE command to add the dataset to the RESOLV.SRV file.

    Type: DSSERVE ADD SAMPLE/NAM-USLCAW20 GRIB 1 999999 TYPE=GRID RT=Y INFO='''DATABASE=mcrtgrib DATAFILE=DESCRIPTOR GRIBTYPE=2''' "NAM - CONUS/LC; AWIPS 20 km

    DATABASE=mcrtgrib defines the database where the meta data is stored.

    DATAFILE=DESCRIPTOR indicates that this dataset will contain only the data files that match the descriptor name (in this case, NAM-USLCAW20* files).  If you have a different name in column 1 of your ~mcidas/data/grib2NavLookup.txt file, then you can include that name here in place of the word DESCRIPTOR

    GRIBTYPE=2
    will only search for GRIB2 data files. 
  4. Stop and restart McIDAS-XCD for your changes to the ~mcidas/data/grib2NavLookup.txt file to take effect in filing and in the database. If you need instructions, see the Starting and Stopping McIDAS-XCD section.

 


[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]