This is an old revision of the document!
Usage: bufrdump.pl <bufr file(s)> [--filter <filter file>] [--param <parameter file> [--csv]] [--lon1 x1] [--lat1 y1] [--lon2 x2] [--lat2 x2] [--tablepath <path to BUFR tables>] [--help] Options: --filter <filter file> Decode observations meeting criteria in <filter file> only --param <parameter file> [--csv] Print parameters in <parameter file> only, in same order as they occur in <parameter file>. If --csv, the parameters vill be printed using the CSV (comma separated values) format --lon1 x1 Decode observations with longitude >= x1 only --lat1 y1 Decode observations with latitude >= y1 only --lon2 x2 Decode observations with longitude <= x2 only --lat2 y2 Decode observations with latitude <= y2 only x1,y1,x2,y2 should be decimal degrees --tablepath <path to BUFR tables> Set path to BUFR tables (overrides ENV{BUFR_TABLES}) --help Print this Usage Options may be abbreviated, e.g. --h for --help. To avoid having to use the "--tablepath" option, you are adviced to set the invironment variable BUFR_TABLES to the directory where your BUFR tables are located (unless the default path provided by bufrdump.pl works for you). The lines in <parameter file> should be name of the parameters you want to be printed. For example, if you want only station identification and temperature to be printed for a BUFR SYNOP file, the <parameter file> should look like this: wmonr call_sign TA If you want "parameter=value" to be printed also when value is missing in BUFR message, precede the parameter name with an exclamation mark (e.g. '!TA'). Missing values will then be displayed as -32767. If --csv is used in conjunction with --param, all values will be printed using the CSV format, with first line listing the parameters, and with missing fields printed as -32767 if the parameter is marked with '!' in parameter file. With the parameter file above, the listing may for example start like wmonr,call_sign,TA 01001,,-1.5 ,LF5U,9.0 Using --filter will decode only those observations that meet at least one of the BUFR descriptor criteria and all of the parameter criteria in <filter file>, where the BUFR descriptor criteria should come first in filter file followed by a blank line, then comes the parameter criteria which should match <param> <operator> <value> where operator is one of =, !=, <, <=, > and >=. An example filter file is D: 001001 I2.2 01 D: 001001 I2.2 001002 I3.3 03 895 06 252 D: 001011 A9 LDWR NN != 0 TA >= 5 TA < 9.5 which decodes all observations with block number 01, two other specific wmo stations and one specific ship, having cloud cover different from 0 (but NN must be part of the message) and temperature between 5 and 9.5 degrees Celsius. Comment lines starting with # will be ignored. Another example: the simple filter file (starting with a blank line!) wmonr > 0 will print only those observations containing a wmonr (skipping ships).