Man Linux: Main Page and Category List

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