wiki.met.no

This is an old revision of the document!

---

Usage:
      bufrdump.pl <bufr file(s)>
          [--filter <filter file>]
          [--param <parameter file> [--csv]]
          [--lon1 x1]
          [--lat1 y1]
          [--lon2 x2]
          [--lat2 x2]
          [--tablepath <path to BUFR tables>]
          [--help]

Options:
      --filter <filter file>
                      Decode observations meeting criteria in <filter file> only
      --param <parameter file> [--csv]
                      Print parameters in <parameter file> only, in same order
                      as they occur in <parameter file>. If --csv, the parameters
                      vill be printed using the CSV (comma separated values) format
      --lon1 x1       Decode observations with longitude >= x1 only
      --lat1 y1       Decode observations with latitude >= y1 only
      --lon2 x2       Decode observations with longitude <= x2 only
      --lat2 y2       Decode observations with latitude <= y2 only
                      x1,y1,x2,y2 should be decimal degrees
      --tablepath <path to BUFR tables>
                      Set path to BUFR tables (overrides ENV{BUFR_TABLES})
      --help          Print this Usage

    Options may be abbreviated, e.g. --h for --help.

    To avoid having to use the "--tablepath" option, you are adviced to set
    the invironment variable BUFR_TABLES to the directory where your BUFR
    tables are located (unless the default path provided by bufrdump.pl
    works for you).

    The lines in <parameter file> should be name of the parameters you want
    to be printed. For example, if you want only station identification and
    temperature to be printed for a BUFR SYNOP file, the <parameter file>
    should look like this:

      wmonr
      call_sign
      TA

    If you want "parameter=value" to be printed also when value is missing
    in BUFR message, precede the parameter name with an exclamation mark
    (e.g. '!TA'). Missing values will then be displayed as -32767.

    If --csv is used in conjunction with --param, all values will be printed
    using the CSV format, with first line listing the parameters, and with
    missing fields printed as -32767 if the parameter is marked with '!' in
    parameter file. With the parameter file above, the listing may for
    example start like

      wmonr,call_sign,TA
      01001,,-1.5
      ,LF5U,9.0

    Using --filter will decode only those observations that meet at least
    one of the BUFR descriptor criteria and all of the parameter criteria in
    <filter file>, where the BUFR descriptor criteria should come first in
    filter file followed by a blank line, then comes the parameter criteria
    which should match <param> <operator> <value> where operator is one of
    =, !=, <, <=, > and >=. An example filter file is

      D: 001001 I2.2
      01
      D: 001001 I2.2 001002 I3.3
      03 895
      06 252
      D: 001011 A9
      LDWR

      NN != 0
      TA >= 5
      TA < 9.5

    which decodes all observations with block number 01, two other specific
    wmo stations and one specific ship, having cloud cover different from 0
    (but NN must be part of the message) and temperature between 5 and 9.5
    degrees Celsius. Comment lines starting with # will be ignored.

    Another example: the simple filter file (starting with a blank line!)

      wmonr > 0

    will print only those observations containing a wmonr (skipping ships).