|
NCEPLIBS-bufr
11.6.0
|
|
NCEPLIBS-bufr
11.6.0
|
Collection of commonly-used utilities based on the library
| 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 |
Usage:
debufr.x [-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
BUFRLIB 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 BUFRLIB function isetprm().bufrfile [path/]name of BUFR file to be decoded
| key | description | sample input |
|---|---|---|
| r | ON29 report type and/or instrument type | 10 20 |
| k | OI report type | 30 |
| m | BUFR message type | ADPUPA |
| w | lat/lon box | x1, x2, y1, y2 |
| s | station id | 72016 |
| d | dump | BUFR contents |
See the source code at readbp.f
./readbp gdas.20200812/00/gdas.t00z.prepbufr'./readmp.x gdas.20200812/00/gdas.t00z.sfcshp.tm00.bufr_d./binv.x gdas.20200812/00/gdas.t00z.prepbufr./sinv.x 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) |
See the source code at cmpbqm.f
./cmpbqm.x gdas.20200811/00/gdas.t00z.prepbufr
./gettab.x gdas.20200812/00/gdas.t00z.adpsfc.tm00.bufr_d./split_by_subset.x gdas.20200812/00/gdas.t00z.satwnd.tm00.bufr_dUsage:
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 directoryThe 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
1.8.5