Model Lookup File (model.lup)

For gridded data from the forecast models, information is broadcast on a set of grids. Often these grids are saved into output files based on the model and grid type. In some cases, several types of grids are broadcast from a single model. For example, the Eta model has grids that cover the US (211), Alaska (207). In other cases, the grid is broken into subgrids, as is the case with the aviation model. The global grids are broken up into 8 subgrids which must be pieced together to produce the final global grid. In addition, there needs to be a mapping between model type (model resource) and the file name tags. The "model.lup" file serves these purposes.

FORMAT

The syntax of the model lookup file is:

   model    geometry   tag[#grid][,tag[#grid]...]

Where:

model -- The name of the model used in the model resource (-mo=eta).
geometry -- The geometry of the grids to be pieced together. If geometry is "1", only one grid is used. If multiple grids are pieced together, this listed the way they are pieced together. For example, "4x2" means that 8 grids will be pieced together with 4 per row and 2 rows. The grids are pieced together from left to right and top to bottom.

1234 5678

tag -- The file name convention tag to be used in constructing the file name to use. More than one tag can be listed if the grids are to be pieced together (see geometry).
grid -- The grid number from the GRIB file (PDB Octet 7). This is used to get specific grids from a file containing more than one grid type.

For more information, see the forecast model files section of the Users Guide.

EXAMPLES

Here are some examples:

nam       1   grib_nam

The Eta model grids would be placed in a single file by the ingestor. The model would be specified using "-mo=nam" and the grids would be searched for in a file with the "grid_nam" naming convention (see the name convention file).

nam       1   grib_nam#211
nam_ak    1   grib_nam#207

This would be used if more than one grid type was saved into a specific file by the ingestor. If the model is "nam", then only the 211 grids from the file would be used. If the model is "nam_ak", then the 207 grids would be used.

gfs       4x2 grib_gfs#39,grib_gfs#40,grib_gfs#37,grib_gfs#38,grib_gfs#43,grib_gfs#44,grib_gfs#41,grib_gfs#42

This would specify that the gfs model grids are actually pieced together from 8 separate grids. The geometry is 4x2 and the grids are extracted from files with naming conventions of grib_gfs#39, and grib_gfs_#42, etc. Since the piecing process can take time, smaller sub grids can be used:

gfs_nhem   4x1 grib_gfs#39,grib_gfs#40,grib_gfs#37,grib_gfs#38

This will only piece together 3 grids from the northern hemisphere rather than piecing together 8. This is useful for AVN plots over North America.

An example of the model.lup file:

am       1   grib_nam81
nam81     1   grib_nam81
nam40     1   grib_nam40
nam20     1   grib_nam20
nam_ak    1   grib_nam_ak
gfs_nh    1   grib_gfs_nh
gfs_nh2   1   grib_gfs_nh2
gfs_na    1   grib_gfs_na
gfs_na2   1   grib_gfs_na2
gfs_na3   1   grib_gfs_na3
gfs_us    1   grib_gfs_us
gfs_us2   1   grib_gfs_us2
gfs_ak    1   grib_gfs_ak
gfs_pac   1   grib_gfs_pac
gfs_uni   1   grib_gfs_uni
gfs_glb   1   grib_gfs_glb
gfs_glb1  1   grib_gfs_glb1
gfs.5     1   grib_gfs_glb.5
gfs       4x2 grib_gfs#39,grib_gfs#40,grib_gfs#37,grib_gfs#38,grib_gfs#43,grib_gfs#44,grib_gfs#41,grib_gfs#42
gfs_ens   2x1 grib_gfs_ens#39,grib_gfs_ens#40
gfs_nhem  4x1 grib_gfs#39,grib_gfs#40,grib_gfs#37,grib_gfs#38
gfs_shem  4x1 grib_gfs#43,grib_gfs#44,grib_gfs#41,grib_gfs#42
gfs_whem  2x2 grib_gfs#39,grib_gfs#40,grib_gfs#43,grib_gfs#44
gfs_ehem  2x2 grib_gfs#37,grib_gfs#38,grib_gfs#41,grib_gfs#42

Model Lookup File (model.lup)

FORMAT

EXAMPLES

SEE ALSO