Skip to end of metadata
Go to start of metadata

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

  1. 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_multi.bufr 
    
    The result is:
     
    ../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
    


  2. It is allowed to use wildcards in filenames.

     
    >  bufr_ls ../data/bufr/syno_*.bufr 
    


  3. To list only a specific set of keys use the -p option.

     
    >  bufr_ls -p totalLength,bufrHeaderCentre,bufrHeaderSubCentre ../data/bufr/syno_multi.bufr 
    


  4. 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
    


  5. All the non-12 UTC messages are listed as follows:

     
    >   bufr_ls -w typicalTime!="120000" ../data/bufr/syno_*.bufr
    


  6. To list only the second message from a BUFR file:

     
    >  bufr_ls -w count=2 ../data/bufr/syno_multi.bufr
    


  • No labels