DESCRIPTION
List content of BUFR files printing values of some keys. It does not fail when a key is not found.
USAGE
bufr_ls [options] file file ...
OPTIONS
-p key[:{s/d/l}],key[:{s/d/l}],...
Declaration of keys to print. For each key a string (key:s) or a double (key:d) or a long (key:l) type can be requested. Default type is string.
-F format
C style format for floating point values.
-P key[:{s/d/l}],key[:{s/d/l}],...
As -p adding the declared keys to the default list.
-w key[:{s/d/l}]{=/!=}value,key[:{s/d/l}]{=/!=}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) or a double (key:d) or a long (key:l) type can be specified. Default type is string.
-B order by directive
Order by. The output will be ordered according to the order by directive. Order by example: "step asc, centre desc" (step ascending and centre descending)
-s key[:{s/d/l}]=value,key[:{s/d/l}]=value,...
Key/values to set. For each key a string (key:s) or a double (key:d) or a long (key:l) 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.
> bufr_ls ../data/bufr/syno_*.bufr ../data/bufr/syno_1.bufr masterTablesVersionNumber localTablesVersionNumber rdbType rdbSubtype rdbtimeYear rdbtimeMonth typicalDate typicalTime numberOfSubsets localLatitude localLongitude 13 1 1 1 2012 10 20121030 000000 1 7.45 151.83 1 of 1 messages in ../data/bufr/syno_1.bufr ../data/bufr/syno_2.bufr 13 1 1 1 2012 10 20121030 000000 1 7.45 151.83 1 of 1 messages in ../data/bufr/syno_2.bufr ../data/bufr/syno_3.bufr 13 1 1 3 2012 10 20121030 000000 1 -15.93 -5.67 1 of 1 messages in ../data/bufr/syno_3.bufr ../data/bufr/syno_4.bufr 13 1 1 1 2012 10 20121030 000000 1 54.18 7.9 1 of 1 messages in ../data/bufr/syno_4.bufr ../data/bufr/syno_multi.bufr 13 1 1 1 2009 1 20090124 120000 1 70.93 -8.67 13 1 1 1 2009 1 20090124 120000 1 77 15.5 13 1 1 1 2009 1 20090124 120000 1 78.92 11.93 3 of 3 messages in ../data/bufr/syno_multi.bufr 7 of 7 total messages in 5 files
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 8 -w typicalTime=12 ../data/bufr/syno_*.bufr ../data/bufr/syno_1.bufr masterTablesVersionNumber localTablesVersionNumber rdbType rdbSubtype rdbtimeYear rdbtimeMonth typicalDate typicalTime numberOfSubsets localLatitude localLongitude 0 of 1 messages in ../data/bufr/syno_1.bufr ../data/bufr/syno_2.bufr 0 of 1 messages in ../data/bufr/syno_2.bufr ../data/bufr/syno_3.bufr 0 of 1 messages in ../data/bufr/syno_3.bufr ../data/bufr/syno_4.bufr 0 of 1 messages in ../data/bufr/syno_4.bufr ../data/bufr/syno_multi.bufr 13 1 1 1 2009 1 20090124 120000 1 70.93 -8.67 13 1 1 1 2009 1 20090124 120000 1 77 15.5 13 1 1 1 2009 1 20090124 120000 1 78.92 11.93 3 of 3 messages in ../data/bufr/syno_multi.bufr 3 of 7 total messages in 5 files
All the non-SYNOP messages are listed as follows:
> bufr_ls -W 8 -w dataCategory!=0 ../data/bufr/syno_*.bufr ../data/bufr/temp_*.bufr ../data/bufr/syno_1.bufr masterTablesVersionNumber localTablesVersionNumber rdbType rdbSubtype rdbtimeYear rdbtimeMonth typicalDate typicalTime numberOfSubsets localLatitude localLongitude 0 of 1 messages in ../data/bufr/syno_1.bufr ../data/bufr/syno_2.bufr 0 of 1 messages in ../data/bufr/syno_2.bufr ../data/bufr/syno_3.bufr 0 of 1 messages in ../data/bufr/syno_3.bufr ../data/bufr/syno_4.bufr 0 of 1 messages in ../data/bufr/syno_4.bufr ../data/bufr/syno_multi.bufr 0 of 3 messages in ../data/bufr/syno_multi.bufr ../data/bufr/temp_101.bufr 13 1 5 101 2012 10 20121030 000000 1 60.77 -161.83 1 of 1 messages in ../data/bufr/temp_101.bufr ../data/bufr/temp_102.bufr 13 1 5 102 2012 10 20121030 230000 1 51.2 -28.1 1 of 1 messages in ../data/bufr/temp_102.bufr ../data/bufr/temp_106.bufr 13 1 5 106 2012 10 20121030 180000 1 43.2 3.4 1 of 1 messages in ../data/bufr/temp_106.bufr 3 of 10 total messages in 8 files