DESCRIPTION
List content of BUFR files printing values of some header keys. Only scalar keys can be printed. It does not fail when a key is not found.
USAGE
bufr_ls [options] bufr_file bufr_file ...
OPTIONS
-p key[:{s|d|i}],key[:{s|d|i}],...
Declaration of keys to print. For each key a string (key:s), a double (key:d) or an integer (key:i) type can be requested. Default type is string.
-F format
C style format for floating-point values.
-P key[:{s|d|i}],key[:{s|d|i}],...
As -p adding the declared keys to the default list.
-w key[:{s|d|i}]{=|!=}value,key[:{s|d|i}]{=|!=}value,...
Where clause. Messages are processed only if they match all the key/value constraints. A valid constraint is of type key=value or key!=value. For each key a string (key:s), a double (key:d) or an integer (key:i) type can be specified. Default type is string. In the value you can also use the forward-slash character '/' to specify an OR condition (i.e. a logical disjunction) Note: only one -w clause is allowed.
-s key[:{s|d|i}]=value,key[:{s|d|i}]=value,...
Key/values to set. For each key a string (key:s), a double (key:d) or an integer (key:i) type can be defined. By default the native type is set.
-n namespace
All the keys belonging to namespace are printed.
-m
Mars keys are printed.
-V
Version.
-W width
Minimum width of each column in output. Default is 10.
-g
Copy GTS header.
-7
Does not fail when the message has wrong length
bufr_ls examples
Without options a default list of keys is printed. The default list can be different depending on the type of BUFR message.
The result is:> bufr_ls ../data/bufr/syno_multi.bufr
../data/bufr/syno_multi.bufr centre masterTablesVersionNumber localTablesVersionNumber typicalDate typicalTime rdbType rdbSubtype rdbtimeDate rdbtimeTime numberOfSubsets localLatitude localLongitude ecmf 13 1 20090124 120000 1 1 20090124 121435 1 70.93 -8.67 ecmf 13 1 20090124 120000 1 1 20090124 121435 1 77 15.5 ecmf 13 1 20090124 120000 1 1 20090124 121435 1 78.92 11.93 3 of 3 messages in ../data/bufr/syno_multi.bufr 3 of 3 total messages in 1 files
It is allowed to use wildcards in filenames.
> bufr_ls ../data/bufr/syno_*.bufr
To list only a specific set of keys use the -p option.
> bufr_ls -p totalLength,bufrHeaderCentre,bufrHeaderSubCentre ../data/bufr/syno_multi.bufr
To list only a subset of messages use the -w (where option). Only the 12 UTC messages are listed with the following line.
> bufr_ls -w typicalTime="120000" ../data/bufr/syno_*.bufr
All the non-12 UTC messages are listed as follows:
> bufr_ls -w typicalTime!="120000" ../data/bufr/syno_*.bufr
To list only the second message from a BUFR file:
> bufr_ls -w count=2 ../data/bufr/syno_multi.bufr