List content of BUFR files printing values of some keys. It does not fail when a key is not found.
bufr_ls [options] file file ...
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.
C style format for floating point values.
As -p adding the declared keys to the default list.
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.
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)
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.
All the keys belonging to namespace are printed.
Mars keys are printed.
Version.
Minimum width of each column in output. Default is 10.
Copy GTS header.
Does not fail when the message has wrong length
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 print offset and count number in file use the keys offset and count. Also the total count in a set of files is available as countTotal
> > bufr_ls -p offset,count,countTotal ../data/bufr/syno_*.bufr ../data/bufr/syno_1.bufr offset count countTotal 0 1 1 1 of 1 messages in ../data/bufr/syno_1.bufr ../data/bufr/syno_2.bufr 0 2 2 1 of 1 messages in ../data/bufr/syno_2.bufr ../data/bufr/syno_3.bufr 0 3 3 1 of 1 messages in ../data/bufr/syno_3.bufr ../data/bufr/syno_4.bufr 0 4 4 1 of 1 messages in ../data/bufr/syno_4.bufr ../data/bufr/syno_multi.bufr 0 5 5 220 6 6 440 7 7 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 SYNOP messages are listed with the following line.
> 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 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 ../data/bufr/temp_101.bufr 0 of 1 messages in ../data/bufr/temp_101.bufr ../data/bufr/temp_102.bufr 0 of 1 messages in ../data/bufr/temp_102.bufr ../data/bufr/temp_106.bufr 0 of 1 messages in ../data/bufr/temp_106.bufr 7 of 10 total messages in 8 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 |