Pål Sannes > Geo-BUFR-1.27 > bufrresolve.pl

Download:
Geo-BUFR-1.27.tar.gz

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Source  

SYNOPSIS ^

  1) bufrresolve.pl <descriptor(s)>
     [--partial]
     [--simple]
     [--noexpand]
     [--bufrtable <name of BUFR B table]
     [--tablepath <path to BUFR tables>]
     [--verbose n]
     [--help]

  2) bufrresolve.pl --code <code or flag table>
     [--bufrtable <name of BUFR B table>]
     [--tablepath <path to BUFR tables>]
     [--verbose n]

  3) bufrresolve.pl --flag <value> --code <flag table>
     [--bufrtable <name of BUFR B table]
     [--tablepath <path to BUFR tables>]
     [--verbose n]

DESCRIPTION ^

Utility program for fetching info from BUFR tables.

Execute without arguments for Usage, with option --help for some additional info. See also "https://wiki.met.no/bufr.pm/start" for examples of use.

It is supposed that the code and flag tables are contained in a file with same name as corresponding B table except for having prefix C instead of B. The tables used can be chosen by the user with options --bufrtable and --tablepath. Default is the hard coded DEFAULT_TABLE in directory DEFAULT_TABLE_PATH, but this last one will be overriden if the environment variable BUFR_TABLES is set. You should consider edit the source code if you are not satisfied with the defaults chosen.

OPTIONS ^

   --partial    Expand D descriptors only once, ignoring replication
   --simple     Like --partial, but displaying the resulting
                descriptors on one line
   --noexpand   Don't expand D descriptors at all

   --bufrtable <name of BUFR B or D table>  Set BUFR tables
   --tablepath <path to BUFR tables>  Set BUFR table path
   --verbose n  Display path and tables used if n > 0

   --help       Display Usage and explain the options used. Almost
                the same as consulting perldoc bufrresolve.pl

Usage 1): Resolves the given descriptor(s) fully into table B descriptors, with name, unit, scale, reference value and width (in bits) written on each line (except for --simple). --partial, --simple and --noexpand are mutually exclusive (full expansion is default).

Usage 2): Prints the contents of the requested code or flag table (named by the table B descriptor).

Usage 3): Displays the bits set when the data value for the requested flag table is <value>.

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

NOTE ON --VERBOSE ^

n > 1 in --verbose n does not provide any more output than n=1, so demanding an argument to --verbose looks funny. But if not, sooner or later someone would type bufrresolve.pl 307080 --verbose 1 which by Perl would be interpreted as if the arguments were 307080 000001 --verbose, which probably is not what the user intended.

AUTHOR ^

Pål Sannes <pal.sannes@met.no>

COPYRIGHT ^

Copyright (C) 2010 met.no

syntax highlighting: