Table of contents Previous: XCD Converting GRIB codes Next: XCD Creating GRIB1 and GRIB2 Files with DMBIN

Creating McIDAS Grid Files with DMGRID

When the unpacking process is complete and the entire GRIB message is successfully decoded, the decoder passes the GRIB structures to DMGRID and/or DMBIN to be reformatted for McIDAS. DMGRID, which converts GRIB1 messages to McIDAS grid files, is described below. DMBIN, which files GRIB1 and GRIB2 messages into GRIB files of the same format, is described in the next section.

Once the message is converted to McIDAS format, DMGRID uses the mcrtgrdf function to determine the grid file for storing the message. The correct grid file is determined by using stored grid header information, consisting of the model, the runtime of the model, and the forecast time, geographic coverage, and the configuration file RTMODELS.CFG. If the model information is not explicitly described in RTMODELS.CFG, the grid is filed in a scratch grid file. The format of RTMODELS.CFG is described below, and is followed by an example.

Once the correct grid file is determined, DMGRID checks if this grid can be filed as is, or if the grid must be pieced together with a previously filed grid. Piecing together is often necessary because most of the gridded fields that cover the globe are sent in four or eight pieces. When a partial grid is received, DMGRID checks if a similar grid has recently been filed. If so, DMGRID pieces the two fields together, refiling the new grid into the same location. If no match is found, the grid is filed as the first grid of this type.

Finally, DMGRID updates the Status Window, telling the administrator that a new grid has been filed and its location. DMGRID then checks the spool file for new data to process.

RTMODELS.CFG format

SCRATCH=

a group of 10 grid files for storing grids based on models not specified in RTMODELS.CFG; if SCRATCH=99000, the range of grid files used is 99001 through 99010 based on the Julian day of the model run time

model=

ftype   fgridf   runint   vtint   maxvt    GEO= min   max

information for filing a particular model, for example, NGM or GFS

 

ftype

filing format for this model

 

 

0

everything from the model is stored in one grid file per model run time; if this value is used, vtint and maxvt are not necessary

 

 

1

grids are filed based on model run time and valid forecast time

 

 

2

all grids from a model run are filed in the same grid file regardless of run time or forecast time; if this value is used, runint, vtint, and maxvt are not necessary

 

 

3

same as 1 except no grids are assumed beyond the maxvt forecast time

 

fgridf

first grid file in the range to use for this model

 

runint

interval between model run times (hhmmss)

 

vtint

forecast period interval to separate forecast grids

 

maxvt

maximum forecast time, after which all grids are stored in the same grid file

 

GEO=

min  max

range of geographic IDs to store in this grid file range; the file ~mcidas/data/gbtbpds001.bv1 contains a list of the IDs and their corresponding geographic coverage and projections (default=1 255)

 

ID=

generating process ID from ~mcidas/data/gbtbpds001.av1

Three examples of configuring GRID decoding using RTMODELS.CFG settings are presented below.

  1. RTMODELS.CFG example

    If the file RTMODELS.CFG contains the following information, messages are stored in the grids listed below.

    SCRATCH= 411
NGM=     3   101   120000   240000   480000
NGM=     3   141   120000   240000   480000   GEO=211 211
GFS=     1   201   120000   240000   960000
MAPS=    0   301   30000
WWFM=    2   401

     

    Grid Files

    Model

    Run

    Forecast Range

    Coverage

    101 - 110

    NGM

    00Z

    00hr <= Forecast Time <= 24hr

    All except Regional CONUS (Lambert Conformal)

    111 - 120

    NGM

    00Z

    24hr < Forecast Time <= 48hr

    121 - 130

    NGM

    12Z

    00hr <= Forecast Time <= 24hr

    131 - 140

    NGM

    12Z

    24hr < Forecast Time <= 48hr

    141 - 150

    NGM

    00Z

    00hr <= Forecast Time <= 24hr

    Regional CONUS (Lambert Conformal)

    151 - 160

    NGM

    00Z

    24hr < Forecast Time <= 48hr

    161 - 170

    NGM

    12Z

    00hr <= Forecast Time <= 24hr

    171 - 180

    NGM

    12Z

    24hr < Forecast Time <= 48hr

    201 - 210

    GFS

    00Z

    00hr <= Forecast Time <= 24hr

    All

    211 - 220

    GFS

    00Z

    24hr < Forecast Time <= 48hr

    All

    221 - 230

    GFS

    00Z

    48hr < Forecast Time <= 72hr

    All

    231 - 240

    GFS

    00Z

    72hr < Forecast Time <= 96hr

    All

    241 - 250

    GFS

    00Z

    > 96hr Forecast Time

    All

    251 - 260

    GFS

    12Z

    00hr <= Forecast Time <= 24hr

    All

    261 - 270

    GFS

    12Z

    24hr < Forecast Time <= 48hr

    All

    271 - 280

    GFS

    12Z

    48hr < Forecast Time <= 72hr

    All

    281 - 290

    GFS

    12Z

    72hr < Forecast Time <= 96hr

    All

    291 - 300

    GFS

    12Z

    > 96hr Forecast Time

    All

    301 - 310

    MAPS

    00Z

    All Forecast Times

    All

    311 - 320

    MAPS

    03Z

    All Forecast Times

    All

    321 - 330

    MAPS

    06Z

    All Forecast Times

    All

    331 - 340

    MAPS

    09Z

    All Forecast Times

    All

    341 - 350

    MAPS

    12Z

    All Forecast Times

    All

    351 - 360

    MAPS

    15Z

    All Forecast Times

    All

    361 - 370

    MAPS

    18Z

    All Forecast Times

    All

    371 - 380

    MAPS

    21Z

    All Forecast Times

    All

    401 - 410

    WWFM

    All

    All Forecast Times

    All

    411 - 420

    All other grids

  2. RTMODELS.CFG defaults in XCD v2005 and v2006

    When McIDAS-XCD v2005/6 is installed, the file RTMODELS.CFG contains the default values below. 

    SCRATCH= 5001
NAM=     3   5011  120000  240000  480000
NGM=     3   5051  120000  240000  480000
GFS=     1   5101  120000  240000  960000
MAPS=    0   5201   30000
GFS=     3   5401  120000  240000  720000

    These RTMODELS.CFG values create the grid files below.

    Grid File

    Model

    Run

    Forecast Range

    Coverage

    5001-5010

    Miscellaneous grids

    5011-5020

    NAM

    00Z

    00hr <= Forecast Time <= 24hr

    All

    5021-5030

    NAM

    00Z

    24hr < Forecast Time <= 48hr

    All

    5031-5040

    NAM

    12Z

    00hr <= Forecast Time <= 24hr

    All

    5041-5050

    NAM

    12Z

    24hr < Forecast Time <= 48hr

    All

    5051-5060

    NGM

    00Z

    00hr <= Forecast Time <= 24hr

    All

    5061-5070

    NGM

    00Z

    24hr < Forecast Time <= 48hr

    All

    5071-5080

    NGM

    12Z

    00hr <= Forecast Time <= 24hr

    All

    5081-5090

    NGM

    12Z

    24hr < Forecast Time <= 48hr

    All

    5101-5110

    GFS

    00Z

    00hr <= Forecast Time <= 24hr

    All

    5111-5120

    GFS

    00Z

    24hr < Forecast Time <= 48hr

    All

    5121-5130

    GFS

    00Z

    48hr < Forecast Time <= 72hr

    All

    5131-5140

    GFS

    00Z

    72hr < Forecast Time <= 96hr

    All

    5141-5150

    GFS

    00Z

    > 96hr Forecast Time

    All

    5151-5160

    GFS

    12Z

    00hr <= Forecast Time <= 24hr

    All

    5161-5170

    GFS

    12Z

    24hr < Forecast Time <= 48hr

    All

    5171-5180

    GFS

    12Z

    48hr < Forecast Time <= 72hr

    All

    5181-5190

    GFS

    12Z

    72hr < Forecast Time <= 96hr

    All

    5191-5200

    GFS

    12Z

    > 96hr Forecast Time

    All

    5201-5210

    MAPS

    00Z

    All Forecast Times

    All

    5211-5220

    MAPS

    03Z

    All Forecast Times

    All

    5221-5230

    MAPS

    06Z

    All Forecast Times

    All

    5231-5240

    MAPS

    09Z

    All Forecast Times

    All

    5241-5250

    MAPS

    12Z

    All Forecast Times

    All

    5251-5260

    MAPS

    15Z

    All Forecast Times

    All

    5261-5270

    MAPS

    18Z

    All Forecast Times

    All

    5271-5280

    MAPS

    21Z

    All Forecast Times

    All

    5301-5310

    MDR

    ------

    All Observational Hours

    All

    5401-5410

    GFS

    00Z

    00hr <= Forecast Time <= 24hr

    All

    5411-5420

    GFS

    00Z

    24hr < Forecast Time <= 48hr

    All

    5421-5430

    GFS

    00Z

    48hr < Forecast Time <= 72hr

    All

    5451-5460

    GFS

    12Z

    00hr <= Forecast Time <= 24hr

    All

    5461-5470

    GFS

    12Z

    24hr < Forecast Time <= 48hr

    All

    5471-5480

    GFS

    12Z

    48hr < Forecast Time <= 72hr

    All

    RTMODELS.CFG defaults in XCD v2015

    The RTMODELS.CFG file supplied in McIDAS-XCD v2015 creates the grid files listed below.

    Grid File

    Model

    Run

    Forecast Range

    Coverage

    50001-50010

    AWC-ALL

    00Z - 2359Z

    00hr

    All

    51001-51010

    AWRW-ALL

    00Z,06Z,12Z,18Z

    00hr <= Forecast Time <= 120hr

    All
    52001-52010 ECMF-EQME 00Z,12Z 00hr <= Forecast Time <= 144hr Equatorial, ECMWF 5-8
    52101-52110 ECMF-GLME 00Z,12Z 00hr <= Forecast Time <= 240hr Global, ECMWF 1-4,9-12
    52201-52210 ECMF-NWME 00Z,12Z
    		 00hr All

    53001-53010

    NAM-AKPS

    0Z

    00hr <= Forecast Time <= 60hr

    All

    53021-53030

    NAM-AKPS

    12Z

    00hr <= Forecast Time <= 60hr

    All
    53101-53110 NAM-USLC 0Z 00hr <= Forecast Time <= 60hr All
    53121-53130 NAM-USLC 12Z 00hr <= Forecast Time <= 60hr All
    53201-53210 NAM-USLC2 0Z 00hr <= Forecast Time <= 60hr All
    53211-53220 NAM-USLC2 6Z 00hr <= Forecast Time <= 48hr All
    53221-53230 NAM-USLC2 12Z 00hr <= Forecast Time <= 60hr All
    53231-53240 NAM-USLC2 18Z 00hr <= Forecast Time <= 48hr All
    53301-53310 NAM-USLCAWI4 0Z 00hr <= Forecast Time <= 60hr All
    53311-53320 NAM-USLCAWI4 6Z 00hr <= Forecast Time <= 48hr All
    53321-53330 NAM-USLCAWI4 12Z 00hr <= Forecast Time <= 60hr All
    53331-53340 NAM-USLCAWI4 18Z 00hr <= Forecast Time <= 48hr All
    53501-53510 NAM-AKPSAWIP 0Z 00hr <= Forecast Time <= 60hr All
    53521-53530 NAM-AKPSAWIP 12Z 00hr <= Forecast Time <= 60hr All
    53601-53610 NAM-AKPSAWI2 0Z 00hr <= Forecast Time <= 60hr All
    53621-53630 NAM-AKPSAWI2 12Z 00hr <= Forecast Time <= 60hr All
    54001-54010 FFG-ALL 00Z - 2359Z 00hr <= Forecast Time <= 24hr All

    55001-55010

    GFS-AKPS

    00Z

    00hr <= Forecast Time <= 120hr

    All

    55011-55020

    GFS-AKPS

    06Z

    00hr <= Forecast Time <= 120hr

    All

    55021-55030

    GFS-AKPS

    12Z

    00hr <= Forecast Time <= 120hr

    All

    55031-55040

    GFS-AKPS

    18Z

    00hr <= Forecast Time <= 120hr

    All

    55101-55110

    GFS-AKPSLRES

    00Z, 18Z

    00hr <= Forecast Time <= 240hr

    All
    55201-55210 GFS-AKPSSSIF 00Z 00hr All

    55301-55310

    GFS-GLME

    00Z

    00hr <= Forecast Time <= 240hr

    Global, GEO 37-44
    55311-55320 GFS-GLME 06Z 00hr <= Forecast Time <= 240hr Global, GEO 37-44
    55321-55330 GFS-GLME 12Z 00hr <= Forecast Time <= 240hr Global, GEO 37-44
    55331-55340 GFS-GLME 18Z 00hr <= Forecast Time <= 240hr Global, GEO 37-44

    55401-55410

    GFS-GLMELRES

    00Z

    00hr < Forecast Time <= 168hr

    All

    55601-55610

    GFS-NWME62

    00Z, 12Z

    00hr < Forecast Time <= 84hr

    All
    55701-55710 GFS-NWME170 00Z >= 96hr Forecast Time All
    55801-55810 GFS-HIME 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 120hr All

    55901-55910

    GFS-HIMELRES

    00Z

    00hr < Forecast Time <= 240hr

    All

    56001-56010

    GFS-HIMESSIF

    0Z

    00hr

    All
    56101-56110 GFS-NHPS 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 120hr All
    56201-56210 GFS-NHPSLRES 00Z 00hr < Forecast Time <= 240hr All
    56301-56310 GFS-NHPSSSIF 00Z 00hr All
    56401-56410 GFS-PRPSLRES 00Z 00hr < Forecast Time <= 240hr All
    56501-56510 GFS-PRPSSSIF 00Z 00hr All

    56601-56610

    GFS-USLC           

    00Z

    		00hr < Forecast Time <= 240hr

    All
    56611-56620 GFS-USLC 
    		06Z 00hr < Forecast Time <= 240hr All
    56621-56630 GFS-USLC 
    		12Z 00hr < Forecast Time <= 240hr All
    56631-56640 GFS-USLC 
    		18Z 00hr < Forecast Time <= 240hr All
    56701-56710 GFS-USPS 00Z 00hr < Forecast Time <= 120hr All
    56711-56720 GFS-USPS 06Z 00hr < Forecast Time <= 120hr All
    56721-56730 GFS-USPS 12Z 00hr < Forecast Time <= 120hr All
    56731-56740 GFS-USPS 18Z 00hr < Forecast Time <= 120hr All
    56801-56810 GFS-USPSLRES 00Z 00hr < Forecast Time <= 240hr All
    56901-56910 GFS-USPSSSIF 00Z 00hr All
    57001-57010 GFS-USPS2 00Z 00hr < Forecast Time <= 120h All
    57011-57020 GFS-USPS2 06Z 00hr < Forecast Time <= 120h All
    57021-57030 GFS-USPS2 12Z 00hr < Forecast Time <= 120h All
    57031-57040 GFS-USPS2 18Z 00hr < Forecast Time <= 120h All
    59001-59010 ICA-GLME 00Z 00hr All
    59101-59110 ICA-NHPS 00Z 00hr All
    59201-59210 ICA-NWME 00Z 00hr All
    60001-60010 ICN-ALL Every hour
    		 00hr,01hr,02hr,03hr,06hr,09hr,12hr All
    62001-62010 NAH-ALL 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 72h All
    63001-63010 NCE-ALL 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 72h All
    65101-65110 NGM-AKPS 00Z,12Z 00hr < Forecast Time <= 48h All
    65201-65210 NGM-USLC 00Z,12Z 00hr < Forecast Time <= 48h All
    65301-65310 NGM-USPS 00Z,12Z 00hr < Forecast Time <= 48h All
    65401-65410 NGM-USPS2 00Z,12Z 00hr < Forecast Time <= 48h All
    66001-66010 RCM-ALL 00Z - 2359Z 00hr All
    67001-67010 RFC-ALL 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 72h All
    68001-68010 MAPS (RUC-USLC)
    		 00Z=<Run Time<03Z
    		 00hr,03hr,06hr,09hr,12hr All

    68011-68020

    MAPS (RUC-USLC)

    		 03Z<=Run Time<06Z

    00hr,03hr,06hr,09hr,12hr

    All

    68021-68030

    MAPS (RUC-USLC)

    06Z<=Run Time<09Z

    00hr,03hr,06hr,09hr,12hr

    All

    68031-68040

    MAPS (RUC-USLC)

    09Z<=Run Time<12Z

    00hr,03hr,06hr,09hr,12hr

    All

    68041-68050

    MAPS (RUC-USLC)

    12Z<=Run Time<15Z

    00hr,03hr,06hr,09hr,12hr

    All

    68051-68060

    MAPS (RUC-USLC)

    15Z<=Run Time<18Z

    00hr,03hr,06hr,09hr,12hr

    All

    68061-68070

    MAPS (RUC-USLC)

    18Z<=Run Time<21Z

    00hr,03hr,06hr,09hr,12hr

    All

    68071-68080

    MAPS (RUC-USLC)

    21Z<=Run Time<00Z

    00hr,03hr,06hr,09hr,12hr

    All
    68101-68110 MAPS (RUC-USLC2) 00Z=<Run Time<03Z 00hr through 09hr,12hr All
    68111-68120 MAPS (RUC-USLC2) 03Z<=Run Time<06Z 00hr through 09hr,12hr All
    68121-68130 MAPS (RUC-USLC2) 06Z<=Run Time<09Z 00hr through 09hr,12hr All
    68131-68140 MAPS (RUC-USLC2) 09Z<=Run Time<12Z 00hr through 09hr,12hr All
    68141-68150 MAPS (RUC-USLC2) 12Z<=Run Time<15Z 00hr through 09hr,12hr All
    68151-68160 MAPS (RUC-USLC2) 15Z<=Run Time<18Z 00hr through 09hr,12hr All
    68161-68170 MAPS (RUC-USLC2) 18Z<=Run Time<21Z 00hr through 09hr,12hr All
    68171-68180 MAPS (RUC-USLC2) 21Z<=Run Time<00Z 00hr through 09hr,12hr All
    68201-68210 MAPS (RUC-USPS) 00Z=<Run Time<03Z 00hr,03hr,06hr,09hr,12hr All
    68211-68220 MAPS (RUC-USPS) 03Z<=Run Time<06Z 00hr,03hr,06hr,09hr,12hr All
    68221-68230 MAPS (RUC-USPS) 06Z<=Run Time<09Z 00hr,03hr,06hr,09hr,12hr All
    68231-68240 MAPS (RUC-USPS) 09Z<=Run Time<12Z 00hr,03hr,06hr,09hr,12hr All
    68241-68250 MAPS (RUC-USPS) 12Z<=Run Time<15Z 00hr,03hr,06hr,09hr,12hr All
    68251-68260 MAPS (RUC-USPS) 15Z<=Run Time<18Z 00hr,03hr,06hr,09hr,12hr All
    68261-68270 MAPS (RUC-USPS) 18Z<=Run Time<21Z 00hr,03hr,06hr,09hr,12hr All
    68271-68280 MAPS (RUC-USPS) 21Z<=Run Time<00Z 00hr,03hr,06hr,09hr,12hr All
    69001-69010 MDR-ALL ------ All Observational Hours All
    72001-72010 NPH-ALL 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 72h All
    75001-75010 SST-GLME
    		 00Z 00hr All
    75101-75110 SST-GLME2 00Z 00hr All
    75201-75210 SST-GLMETHIN 00Z 00hr All
    76001-76010 UKM-GLME 00Z,12Z 00hr < Forecast Time <= 120h All
    76101-76110 UKM-GLMETHIN 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 72h All
    77001-77010 WHG-ALL 00Z,12Z All Forecast Hours out to 60 hours
    		 All
    78001-78010 WNA-ALL 00Z,06Z,12Z,18Z 00hr < Forecast Time <= 120h All
    79101-79110 WWF-GLMETHIN 00Z,12Z 12hr,24hr,48hr,72hr All

 


Table of contents Previous: XCD Converting GRIB codes Next: XCD Creating GRIB1 and GRIB2 Files with DMBIN