Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
bufr.pm:bufrdump.pl_help [2011-09-16 08:51:39] pals |
bufr.pm:bufrdump.pl_help [2022-05-31 09:29:31] (current) |
||
---|---|---|---|
Line 2: | Line 2: | ||
Usage: | Usage: | ||
bufrdump.pl <bufr file(s)> | bufrdump.pl <bufr file(s)> | ||
- | [--filter <filter file>] | + | [--filter <filter file | filter list>] |
- | [--param < | + | [--param < |
[--sort] | [--sort] | ||
[--sort_on < | [--sort_on < | ||
[--station <station list>] | [--station <station list>] | ||
[--transform < | [--transform < | ||
- | [--lon1 x1] | + | [--lon1 |
- | [--lat1 y1] | + | [--lat1 |
- | [--lon2 x2] | + | [--lon2 |
- | [--lat2 | + | [--lat2 |
- | [--obstype < | + | [--obstype < |
[--tablepath <path to BUFR tables>] | [--tablepath <path to BUFR tables>] | ||
[--help] | [--help] | ||
Options: | Options: | ||
- | --filter <filter file> | + | --filter <filter file | filter list> |
- | Decode observations meeting criteria in <filter file> only | + | Decode observations meeting criteria in filter file or |
- | --param < | + | filter list only |
- | Print parameters in parameter file or comma separated | + | --param < |
- | list (e.g. wmonr,TA) only, in same order as they occur | + | Print parameters in parameter file or comma |
- | | + | |
- | | + | |
+ | followed by --delimiter <del>, the parameters vill | ||
+ | | ||
+ | | ||
--sort | --sort | ||
- | first stations with wmonr, then stations with call sign, | + | first stations with wmonr, then stations with nationalnr, |
- | buoy_id or aircraft (others left out) | + | |
--sort_on < | --sort_on < | ||
- | values of <parameter>, or decreasing values if a ' | + | values of parameter, or decreasing values if a ' |
follows the parameter name. E.g. --sort_on TA- will | follows the parameter name. E.g. --sort_on TA- will | ||
sort on decreasing temperatures. Observations not | sort on decreasing temperatures. Observations not | ||
Line 34: | Line 37: | ||
except when --sort_on is combined with --sort (in which | except when --sort_on is combined with --sort (in which | ||
case sorting is done firstly on station identification, | case sorting is done firstly on station identification, | ||
- | secondly on <parameter> with missing values printed first) | + | secondly on parameter with missing values printed first) |
--station <station list> | --station <station list> | ||
Print observations for stations in station list only, | Print observations for stations in station list only, | ||
Line 40: | Line 43: | ||
--transform < | --transform < | ||
Do the transformations of parameter values listed in | Do the transformations of parameter values listed in | ||
- | | + | transformation file |
- | --lon1 x1 | + | --lon1 |
- | --lat1 y1 | + | --lat1 |
- | --lon2 x2 | + | --lon2 |
- | --lat2 y2 | + | --lat2 |
x1,y1,x2,y2 should be decimal degrees | x1,y1,x2,y2 should be decimal degrees | ||
- | --obstype < | + | --obstype < |
Force observation type. If this option is not set, | Force observation type. If this option is not set, | ||
- | will make an educated guess of observation type based | + | will make an educated guess of observation type |
- | on metadata in section 1 of each BUFR message | + | |
--tablepath <path to BUFR tables> | --tablepath <path to BUFR tables> | ||
Set path to BUFR tables (overrides ENV{BUFR_TABLES}) | Set path to BUFR tables (overrides ENV{BUFR_TABLES}) | ||
Line 58: | Line 61: | ||
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 bufrdump.pl | ||
works for you). | works for you). | ||
Line 67: | Line 70: | ||
temperature to be printed for a BUFR SYNOP file, either supply | temperature to be printed for a BUFR SYNOP file, either supply | ||
- | wmonr, | + | wmonr,nationalnr, |
as argument to --params, or supply a < | as argument to --params, or supply a < | ||
Line 73: | Line 76: | ||
wmonr | wmonr | ||
+ | nationalnr | ||
call_sign | call_sign | ||
TA | TA | ||
Line 93: | Line 97: | ||
for example start like | for example start like | ||
- | wmonr,call_sign,TA | + | wmonr; |
- | 01001,,-1.5 | + | 01001;;;-1.5 |
- | | + | |
+ | |||
+ | You can choose another delimiter than semicolon by use of option | ||
+ | --delimiter < | ||
Using --filter will decode only those observations that meet at least | Using --filter will decode only those observations that meet at least | ||
Line 101: | Line 108: | ||
<filter file>, where the BUFR descriptor criteria should come first in | <filter file>, where the BUFR descriptor criteria should come first in | ||
filter file followed by a blank line, then comes the parameter criteria | filter file followed by a blank line, then comes the parameter criteria | ||
- | which should match < | + | which should match < |
- | is one of =, !=, <, <=, > and >=. An example filter file is | + | |
+ | and !~ should be a Perl match regular expression. The parameter criteria | ||
+ | may be phrased as alternatives by separating them with ' | ||
+ | line. An example filter file is | ||
D: 001001 I2.2 | D: 001001 I2.2 | ||
Line 119: | Line 129: | ||
which decodes all observations with block number 01, two other specific | which decodes all observations with block number 01, two other specific | ||
- | wmo stations and one specific ship, being manned | + | wmo stations and one specific ship, where stations |
- | cloud cover different from 8 (but NN must be part of the message) | + | |
- | | + | between 5 and 9.5 degrees Celsius, and contain |
- | | + | |
- | | + | |
- | Another example: the simple | + | Another example: the filter file (starting with a blank line!) |
- | wmonr | + | |
+ | obstime >= ' | ||
+ | HW | HWA | PW | PWA | ||
+ | FF > 10 | FG_010 > 10 | ||
+ | |||
+ | will print only those ship observations for which the 4 character | ||
+ | call_sign starts with 2 letters in the interval LA-LN, and having | ||
+ | obstime larger or equal to the datetime given, and containing wave data | ||
+ | (specifically: | ||
+ | measured), and with wind or 10 minutes gust more than 10 m/s. | ||
+ | |||
+ | For convenience, | ||
+ | provide the filter criteria on the command line. Example: | ||
+ | |||
+ | --filter 'wmonr,TA > 0,RR_12 | RR_24, !FF' | ||
- | will print only those observations | + | will decode |
+ | and containing precipitation for 12 or 24 hours and not reporting wind. | ||
+ | If (like for --param) the filter list consists of one criterium only, a | ||
+ | comma must be appended. | ||
To avoid the need of creating a filter file when observations for some | To avoid the need of creating a filter file when observations for some | ||
few stations are requested, you can provide the stations in a comma | few stations are requested, you can provide the stations in a comma | ||
- | separated list after option --station. | + | separated list after option --station. |
--station wmonr=01001, | --station wmonr=01001, | ||
+ | --station nationalnr=614_0050410003, | ||
--station call_sign=LF5U | --station call_sign=LF5U | ||
--station buoyid=64607, | --station buoyid=64607, | ||
Line 141: | Line 168: | ||
You cannot mix different kinds of stations this way (before ' | You cannot mix different kinds of stations this way (before ' | ||
- | choose either wmonr, call_sign, buoy_id or aircraft). Note also that | + | choose either wmonr, nationalnr, call_sign, buoy_id or aircraft). Note |
- | providing the stations in the BUFR descriptor part (first part) of the | + | |
- | | + | |
- | | + | |
- | | + | |
- | parameters in filter file, then the requested stations in station list. | + | |
+ | | ||
The --transform option is provided mainly to be able to use other units | The --transform option is provided mainly to be able to use other units | ||
Line 172: | Line 200: | ||
The --obstype option might be handy in some special cases, like when you | The --obstype option might be handy in some special cases, like when you | ||
are interested only in the surface part of oceanographic data (then use | are interested only in the surface part of oceanographic data (then use | ||
- | ' | + | ' |
- | | + | high resolution radiosonde data (then use ' |
+ | | ||
+ | | ||
</ | </ |