Skip Navigation Links 
NOAA logo - Click to go to the NOAA home page National Weather Service   NWS logo - Click to go to the NWS home page
Climate Prediction Center

About Us
   Our Mission
   Who We Are

Contact Us
   CPC Information
   CPC Web Team

HOME > Monitoring_and_Data > Oceanic and Atmospheric Data > Reanalysis: Atmospheric Data > wgrib2-match

wgrib2: -match


The -match option selects records which should be processed. When multiple -match options are used, all matches must be satisfied. The -match and -not options seem to be similar to the -if and -if_not options. The big difference is that the -match and -not options are processed before any other record processing. If the record satisfies the -match and -not options, then the record is processed. This include the optional decoding and latitude-longitude calculation and the other options.

    wgrib2 -match X (...)

is the same as 

    wgrib2 -match_inv file | egrep X | wgrib2 -i (...)

    wgrib2 -match X -match Y -not Z (...)

is the same as 

    wgrib2 -match_inv file | egrep X | egrep Y | egrep -v Z | wgrib2 -i (...)

where X, Y and Z are regular expressions. 


-match X

X is a posix extended regular expression

The -match, and -not selection facility is more limited than the "wgrib2 | filter | wgrib2 -i" syntax. However, it can be more efficient especially when combined with the -end option. Note that the "match" inventory often expands. Usually the inventory expands by adding new items to the end of the inventory in order not the break scripts.

Future Changes

The format of the "match inventory" has evolved and will continue to evolve. The rule for future changes is that new items in the "match inventory" will be added as the second last item. Consequently the last item in the inventory will always be ":vt=YYYYMMDDHH:". In order to future proof your -match, and -not selections, you must not include any item before the ":vt=YYYYMMDD:" field.

    -match ":vt=2011111500:"                  good
    -not ":vt=2011111500:$"                   good (dollar sign matches the end of the line)
    -not ":n=10:vt=2011111500:"               bad (item before :vt=)
    -match ":RH:975 mb:anl::vt=2010050806:"   bad (item before :vt=)

Some recent changes (as of Nov 2011) to the match inventory include:
  • adding the "extended name of the variable", ex. TMP.prob_<273
  • adding the inventory number, ex. n=10
  • adding ensemble/chemical/probability information (-misc)

See also: -not, -match_inv, -end, -i, -if, -not_if, -set_regex.

NOAA/ National Weather Service
National Centers for Environmental Prediction
Climate Prediction Center
5830 University Research Court
College Park, Maryland 20740
Climate Prediction Center Web Team
Page last modified: May 15, 2005
Disclaimer Privacy Policy