NAME
dbamsg - Work with encoded meteorological data
SYNOPSIS
dbamsg [command] [options] [args...]
DESCRIPTION
Examine, dump and convert files containing meteorological data. It
supports observations encoded in BUFR, CREX and AOF formats.
dbamsg always requires a non-switch argument, that indicates what is
the operation that should be performed:
help
Print a help summary.
help manpage
Print this manpage.
scan [options] filename [filename [...]]
Summarise the contents of a file with meteorological data.
dump [options] filename [filename [...]]
Dump the contents of a file with meteorological data.
cat [options] filename [filename [...]]
Dump the raw data of a file with meteorological data.
convert [options] filename [filename [...]]
Convert meteorological data between different formats.
compare [options] filename1 [filename2]
Compare two files with meteorological data.
filter [options] [queryparm1=val1 [queryparm2=val2 [...]]] filename1
[filename2...]
Copy only those messages whose contents match the given query
parameters. The query can be done using the same parameters as
dbadb or the Fortran DB-ALLe API. Only the parameters starting
with lat, lon, year, month, day, hour, minu, sec are actually
used for filtering..
fixaof [options] filename [filename1 [...]]]
Recomputes the start and end of observation period in the
headers of the given AOF files.
makebufr [options] filename [filename1 [...]]]
Read a simple description of a BUFR file and output the BUFR
file.. Read a simple description of a BUFR file and output the
BUFR file. This only works for simple BUFR messages without
attributes encoded with data present bitmaps.
bisect [options] --test=testscript filename
Bisect filename and output the minimum subsequence found for
which testscript fails.. Run testscript passing parts of
filename on its stdin and checking the return code. Then divide
the input in half and try on each half. Keep going until
testscript does not fail in any portion of the file. Output to
stdout the smallest portion for which testscript fails. This is
useful to isolate the few messages in a file that cause
problems.
head [options] filename [filename [...]]
Dump the contents of the header of a file with meteorological
data.
OPTIONS
dbamsg follows the usual GNU command line syntax, with long options
starting with two dashes (‘-’).
Options used to filter messages
--category=num
match messages with the given data category
--subcategory=num
match BUFR messages with the given data subcategory
--check-digit=num
match CREX messages with check digit (if 1) or without check
digit (if 0)
--unparsable
match only messages that cannot be parsed
--parsable
match only messages that can be parsed
--index=expr
match messages with the index in the given range (ex.:
1-5,9,22-30)
Option for command scan
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
Option for command dump
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the unput data (’bufr’, ’crex’, ’aof’)
--interpreted
dump the message as understood by the importer
--text dump as text that can be processed by dbamsg makebufr
Option for command cat
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
Option for command convert
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
-d type, --dest=type
format of the data in output (’bufr’, ’crex’, ’aof’)
--template=type.sub.local
template of the data in output (autoselect if not specified)
-r rep_memo, --report=rep_memo
force output data to be of this type of report
Option for command compare
-?, --help
print an help message
--verbose
verbose output
-t type, --type1=type
format of the first file to compare (’bufr’, ’crex’, ’aof’)
-d type, --type2=type
format of the second file to compare (’bufr’, ’crex’, ’aof’)
Option for command filter
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
-d type, --dest=type
format of the data in output (’bufr’, ’crex’, ’aof’)
Option for command fixaof
-?, --help
print an help message
--verbose
verbose output
Option for command makebufr
-?, --help
print an help message
--verbose
verbose output
Option for command bisect
-?, --help
print an help message
--verbose
verbose output
--test=cmd
command to run to test a message group
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
Option for command head
-?, --help
print an help message
--verbose
verbose output
-t type, --type=type
format of the input data (’bufr’, ’crex’, ’aof’)
EXAMPLES
Here are some example invocations of dbamsg:
# Convert an AOF message to BUFR
dbamsg convert file.aof > file.bufr
# Convert a BUFR message to CREX
dbamsg convert file.bufr -d crex > file.crex
# Dump the content of a message, as they are in the message
dbamsg dump file.bufr
# Dump the content of a message, interpreted as physical quantities
dbamsg dump --interpreted file.bufr
AUTHOR
dbamsg has been written by Enrico Zini <enrico@enricozini.com> for ARPA
Emilia Romagna, Servizio Idrometeorologico.
jun 22, 2010