Scroll to navigation

DBAMSG(1) General Commands Manual DBAMSG(1)

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 or CREX formats.

dbamsg always requires a non-switch argument, that indicates what is the operation that should be performed:


Print a help summary.

Print this manpage.

Summarise the contents of a file with meteorological data.

Dump the contents of the header of a file with meteorological data.

Dump the contents of a file with meteorological data.

Dump the raw data of a file with meteorological data.

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.

Convert meteorological data between different formats.

Compare two files with meteorological data.

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.

OPTIONS

dbamsg follows the usual GNU command line syntax, with long options starting with two dashes (`-').

Options used to filter messages

match messages with the given data category
match BUFR messages with the given data subcategory
match CREX messages with check digit (if 1) or without check digit (if 0)
match only messages that cannot be parsed
match only messages that can be parsed
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 output
format of the input data ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file

Option for command head

-?, --help
print an help message
verbose output
format of the input data ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file

Option for command dump

-?, --help
print an help message
verbose output
format of the input data ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file
dump the message as understood by the importer
import messages using precise contexts instead of standard ones
dump as text that can be processed by dbamsg makebufr
dump in machine readable CSV format
dump in machine readable JSON format
dump structure of data description section
structured dump of the message contents

Option for command cat

-?, --help
print an help message
verbose output
format of the input data ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file

Option for command bisect

-?, --help
print an help message
verbose output
command to run to test a message group
format of the input data ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file

Option for command convert

-?, --help
print an help message
verbose output
format of the input data ('bufr', 'crex', 'json', 'csv')
format of the data in output ('bufr', 'crex', 'json')
write unprocessed data to this file
template of the data in output (autoselect if not specified, 'list' gives a list)
force output data to be of this type of report
import messages using precise contexts instead of standard ones
recompute data categories and subcategories according to message contents, for use as input to bufr2netcdf
destination file. Default: stdandard output

Option for command compare

-?, --help
print an help message
verbose output
format of the first file to compare ('bufr', 'crex', 'json', 'csv')
format of the second file to compare ('bufr', 'crex', 'json', 'csv')
write unprocessed data to this file

Option for command makebufr

-?, --help
print an help message
verbose output

EXAMPLES

Here are some example invocations of \fBdbamsg\fP:



  # Convert a BUFR message to CREX


  dbamsg convert file.bufr -d crex > file.crex


  # Convert BUFR messages to CREX, but skip all those not in january 2010


  dbamsg convert year=2010 month=1 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.

January 10, 2023