Previous: Configuring Image Defaults Next:  IDV Special Data Formats Table of contents Images Frames Unidata's Integrated Data Viewer > Miscellaneous > Site Configuration

7.4.4 Adding in new GRIB tables
The IDV can read Gridded Binary (GRIB) files in both GRIB-1 and GRIB-2 formats. Decoding GRIB files requires a set of lookup tables for parameters, issuing centers, etc. The IDV comes pre-configured to support commonly used tables, but regional models and modeling centers may use tables that are not in the distribution.

You can add in specialized tables for both GRIB-1 and GRIB-2 using the steps below. Documentation on the format of the files can be found here.

7.4.4.0  GRIB-1 tables
7.4.4.1  GRIB-2 tables
7.4.4.0 GRIB-1 tables
To add in new GRIB 1 tables, you will need to create a file listing the special tables and the special table files themselves.

To add in a new parameter file, the IDV would need to have access to a file called grib1lookuptable.lst which would list the parameter table (e.g.: gwctab_2.tab) and the parameter table itself.

The format of grib1lookuptable.lst is:

<center>:<subcenter>:<version>:  <table location>
so it would look like:
57:     1:      2:      gwctab_2.tab
gwctab_2.tab can be a relative or absolute path. The tables are in NCEP format:
-1:57:-1:2
0:var0:undefined
1:PRES:Pressure [Pa]
2:PRMSL:Pressure reduced to MSL [Pa]
3:PTEND:Pressure tendency [Pa/s]
4:PVORT:Pot. vorticity [km^2/kg/s]
5:ICAHT:ICAO Standard Atmosphere Reference Height [m]
:GP:Geopotential [m^2/s^2]
...
(You can read more information about the format of this file and the parameter table here)

Once you've created this file, you would access it by putting the grib1lookuptable.lst in your <home>/.unidata/idv/DefaultIdv directory and put the corresponding table files where they are pointed to in the file. This can be a relative path or a web server. Alternatively, you could place the grib1lookuptable.lst and associated parameter tables on a local web server and use the IDV's sitepath parameter (startup option or user preference) to point to the location where the files are.

7.4.4.1 GRIB-2 tables
To add in new GRIB 2 parameter, you would create a file named grib2lookuptable.lst which lists the parameters.

The format of grib2lookuptable.lst is:

<Discipline>  <Category>  <Parm #>  <Name>  <Units>  <Desc>
Parameters are listed by row, fields are separated by tabs, so it would look like:
#Dis    Cat     Parm #  Name            Units   Desc
0       0       0       Temperature     K       Temperature
(This is a sample table, the lines starting with # are not include in table.) (You can read more information about the format of this file and the parameter table here)

Once you've created this file, you would access it by putting the grib2lookuptable.lst in your /.unidata/idv/DefaultIdv directory. Alternatively, you could place the grib2lookuptable.lst on a local web server and use the IDV's sitepath parameter (startup option or user preference) to point to the location of the file.

 


Previous: Configuring Image Defaults Next:  IDV Special Data Formats Table of contents Images Frames Unidata's Integrated Data Viewer > Miscellaneous > Site Configuration