Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
bufr.pm:bufrread_help [2010-05-27 09:07:13] pals |
bufr.pm:bufrread_help [2022-05-31 09:29:31] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
< | < | ||
Usage: | Usage: | ||
- | | + | |
+ | [--ahl < | ||
+ | [--all_operators] | ||
+ | [--bitmap] | ||
+ | [--codetables] | ||
+ | [--data_only] | ||
[--filter <filter file>] | [--filter <filter file>] | ||
- | [--param < | + | [--help] |
- | [--lon1 x1] | + | |
- | [--lat1 y1] | + | [--noqc] |
- | [--lon2 x2] | + | [--on_error_stop] |
- | [--lat2 x2] | + | [--optional_section] |
+ | [--outfile < | ||
+ | [--param < | ||
+ | [--strict_checking n] | ||
+ | [--tableformat < | ||
[--tablepath <path to BUFR tables>] | [--tablepath <path to BUFR tables>] | ||
- | [--help] | + | [--verbose n] |
+ | [--width n] | ||
Options: | Options: | ||
- | | + | --ahl <ahl_regexp> |
- | Decode | + | |
- | --param < | + | |
- | Print parameters in <parameter | + | --bitmap |
- | as they occur in <parameter | + | |
- | vill be printed using the CSV (comma separated values) format | + | is [CODE TABLE] or [FLAG TABLE] |
- | --lon1 x1 | + | --data_only |
- | --lat1 y1 | + | |
- | --lon2 x2 | + | Decode observations meeting criteria |
- | --lat2 y2 | + | --help Display Usage and explain |
- | | + | more info you might prefer to consult perldoc bufrread.pl |
- | --tablepath <path to BUFR tables> | + | |
- | Set path to BUFR tables (overrides ENV{BUFR_TABLES}) | + | |
- | --help Print this Usage | + | (or any descriptors following 222000) |
+ | --on_error_stop Stop processing as soon as an error occurs during decoding | ||
+ | | ||
+ | Will print to < | ||
+ | --optional_section | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | n=1 Issue warning if (recoverable) error in | ||
+ | BUFR format | ||
+ | n=2 Croak if (recoverable) error in BUFR format. | ||
+ | | ||
+ | --tableformat | ||
+ | --tablepath <path to BUFR tables> | ||
+ | | ||
+ | | ||
+ | show the tables loaded. | ||
+ | | ||
+ | | ||
- | Options may be abbreviated, | + | Options may be abbreviated, |
To avoid having to use the " | To avoid having to use the " | ||
- | the invironment | + | the environment |
- | tables are located (unless the default path provided by bufrdump.pl | + | tables are located (unless the default path provided by bufrread.pl |
- | works for you). | + | works for you). For tableformat ECCODES, se |
+ | < | ||
+ | for more info on how to set " | ||
- | | + | |
- | | + | |
- | | + | |
- | | + | possibly be required when using the utility programs included in |
+ | | ||
- | wmonr | + | For option " |
- | | + | BUFR descriptor (6 digits). Rest of line will be ignored. bufrread.pl |
- | TA | + | will display values for these descriptors only. |
- | | + | |
- | | + | the criteria in <filter file> (and all of those criteria marked D!). |
- | (e.g. ' | + | |
- | 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 ' | + | D: 001001 001002 |
- | parameter file. With the parameter file above, the listing may for | + | |
- | example start like | + | |
- | + | D: 001011 | |
- | wmonr, | + | |
- | 01001,, | + | |
- | ,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 < | + | |
- | =, !=, <, <=, > and >=. An example filter file is | + | |
- | + | ||
- | | + | |
- | | + | |
- | D: 001001 | + | |
- | | + | |
- | | + | |
- | D: 001011 | + | |
- | | + | |
- | + | ||
- | | + | |
- | | + | |
- | | + | |
which decodes all observations with block number 01, two other specific | which decodes all observations with block number 01, two other specific | ||
- | | + | |
- | | + | |
- | | + | is enough that the observation contains the descriptor(s), |
- | + | | |
- | | + | |
- | | + | |
- | | + | |
+ | table is missing or message is corrupt), the BUFR message is skipped | ||
+ | with an error message printed to STDERR, and processing then continues | ||
+ | with the next BUFR message. You can change this default behaviour, | ||
+ | however, by setting " | ||
</ | </ |