|
NCEPLIBS-bufr
12.2.0
|
Collection of commonly-used utilities based on the library.
The NCEPLIBS-bufr library includes some command line utilities which operate on BUFR files.
| Utility | Description |
|---|---|
| debufr | Read BUFR file and write verbose listing of contents |
| readbp | Read prepbufr file and print each report one at a time |
| readmp | Read BUFR file containing embedded DX BUFR tables, and print each report one at a time |
| binv | Print inventory of BUFR file by message type |
| sinv | Print inventory of BUFR satellite data file by platform and instrument type |
| cmpbqm | Print inventory of observations from prepbufr file by variable, report type and quality mark |
| gettab | Print embedded DX BUFR tables from within a BUFR file |
| split_by_subset | Split a BUFR file into separate BUFR files for each subset type |
| xbfmg | Split a BUFR file into separate BUFR files for each message |
| apxdx | Append a DX BUFR table to a BUFR file |
Usage:
debufr [-v] [-h] [-b] [-c] [-m] [-o outfile] [-t tabledir] [-f tablefil] [-p prmstg] bufrfile
where:
-v prints version information and exits
-h prints program help and usage information and exits
-b specifies the "basic" option, meaning that only the
information in Sections 0-3 will be decoded from each
BUFR message in the bufrfile, and no attempt will be
made to decode the data in Section 4
-c specifies that code and flag table meanings should not
be read from master BUFR tables and included in the
output; otherwise this feature is enabled by default
-m specifies that master BUFR tables will be used to
decode the data messages in the file, regardless of
whether it contains any embedded DX BUFR table
messages. This option can be used to view the actual
contents of DX BUFR table messages, which otherwise
would not be printed in the output listing.
outfile [path/]name of file to contain verbose output listing.
The default is "bufrfilename.debufr.out" in the current
working directory, where bufrfilename is the basename of
the bufrfile (i.e. bufrfile with any preceding [path/]
removed).
tabledir [path/]name of directory containing tables to be used
for decoding. This directory contains the DX BUFR
tables file to be used (if one was specified
via the -f option), or it may contain all of the master
BUFR tables when these are being used to decode a
file. If unspecified, the default directory location is
the defined value of the MASTER_TABLE_DIR macro when the
utility was built.
tablefil file within tabledir containing DX BUFR tables
to be used for decoding.
prmstg string of comma-separated PARAMETER=VALUE pairs, up to a
maximum of 20. For each pair, the dynamic allocation
PARAMETER will be set to VALUE within the underlying
NCEPLIBS-bufr software, overriding the default value that
would otherwise be used. A complete list of parameters
that can be dynamically sized is included within the
documentation for NCEPLIBS-bufr function isetprm().
bufrfile [path/]name of BUFR file to be decoded
Usage: readbp <-s> <-w> <-m> <-k> <-r> <-d> <-n> <-h> prep bufrfile Search filter and/or print prepbufr reports in various ways -s "station_id " print reports where "station_id" matches the report id up to the len of "station_id" -w "x1 x2 y1 y2" print reports within a lon/lat box -m "subset " print reports with this subset name -k "gsi rtype " print reports with this gsi report type -r "on29 rtype " print reports with this on29 report type -d print reports using ufdump - note: this works with any NCEP BUFR file -n no pause between reports output -h print only report headers Only a filename is required in which case step through the reports one at a time using "enter" Optional arguments can also be applied in the pause between reports output without using a dash Optional arguments will be applied in concert in most cases
readmp gdas.20200812/00/gdas.t00z.sfcshp.tm00.bufr_d
binv gdas.20200812/00/gdas.t00z.prepbufr
Usage:
sinv satbufrfile [tabledir]
where:
satbufrfile [path/]name of BUFR satellite data file to be decoded
tabledir [path/]name of directory containing master BUFR tables.
If unspecified, the default directory location is
the defined value of the MASTER_TABLE_DIR macro when the
utility was built.
sinv gdas.20200812/00/gdas.t00z.satwnd.tm00.bufr_d
fit2obs system which copies that information from the convstat files. The sample output prepbufr was after prep but pre-analysis. | Quality Marker | Description |
|---|---|
| 0 | keep flag |
| 1 | passed checks and/or corrected by cqc |
| 2 | not checked |
| 3 | suspicious |
| 4-7 | rejected by oiqc (original mark + 4) |
| 8 | Ps more than 100mb off |
| 9 | filtered by missing ob errors in gsi error table |
| 10 | rejected by gsi gross check |
| 11 | rejected by gsi varqc |
| 12 | on manual reject list |
| 13 | rejected by cqc or acqc |
| 14 | sdm reject (manual purge) |
| 15 | rejected by prepdata code (ie failed various sanity checks) |
| cka | a non-missing value with a missing quality mark |
| ckb | a missing value with a non-missing quality mark |
cmpbqm gdas.20200811/00/gdas.t00z.prepbufr
gettab gdas.20200812/00/gdas.t00z.adpsfc.tm00.bufr_d
split_by_subset gdas.20200812/00/gdas.t00z.satwnd.tm00.bufr_d
Usage:
xbfmg [-v] [-h] [-g] bufrfile
where:
-v prints version information and exits
-h prints program help and usage information and exits
-g preserves within each output file any GTS bulletin header and control
characters associated with the corresponding BUFR message from the
input file
bufrfile [path/]name of input file containing one or more BUFR messages to be
extracted into separate output files within the current working directory
The output will be stored within the current working directory using the
following filenames:
(basename).xbfmg.out.000001
(basename).xbfmg.out.000002
(basename).xbfmg.out.000003
and so on, up through
(basename).xbfmg.out.(last#)
where:
(basename) = basename of bufrfile
(last#) = total number of BUFR messages in bufrfile
Usage:
apxdx BUFRfile DXtable
where:
BUFRfile [path/]name of BUFR file, to which BUFR messages corresponding to DXtable are
to be appended
DXtable [path/]name of DX BUFR table
1.9.1