Linux Certif

Toute la documentation sur la certification Linux LPI

dbamsg

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.