MB-System Unix Manual Page: mbm_multidatalist

### MB-System Unix Manual Page

#

##

##

##

##

##

##

##

##

##

##

    mbm_multidatalist
    Section:  MB-System 5.0  (1)
    Updated:  3 June 2013
    Index

    NAME

    mbm_multidatalist - Macro to use mbdatalist with the -O option
    to generate standard  ancilliary files, using parallel processes.

    VERSION

    Version 5.0

    SYNOPSIS

    mbm_multidatalist -Idatalist
    [-Xnprocesses [-N -H -V]

    DESCRIPTION

    mbm_multidatalist is a macro used to efficiently generate ancilliary files
    for the swath data files referenced in the input datalist file. This is
    accomplished by executing mbdatalist with the -O or -N option
    for each swath file.

    Programs such as mbgrid try to check statistics or "inf"
    files to see if the corresponding data files include data within
    the specified geographic bounds. Other programs look for
    "fast bathymetry" or "fast navigation" ("fbt" or "fnv") files
    in order to read the data more quickly. The -N option causes
    mbm_multidatalist to create these three types of ancillary files
    for each swath data file. By default, mbm_multidatalist
    creates the "inf", "fbt", and "fnv" files only when they don't
    already exist or are out of date (older than the data file).
    The -N option causes mbm_multidatalist to create
    (or recreate) the ancillary files
    for each swath data file.

    The -Xnprocesses option sets the number of parallel processes that can be
    started by mbm_multidatalist. In general, the most efficient (fastest) execution of
    the overall command will be achieved when nprocesses equals the number of
    available CPUs or cores.

    AUTHORSHIP

    Christian Ferreira

      MARUM, University of Bremen

    David W. Caress (caress@mbari.org)

      Monterey Bay Aquarium Research Institute

    Dale N. Chayes (dale@ldeo.columbia.edu)

      Lamont-Doherty Earth Observatory

    SIMPLE DESCRIPTION OF BASIC OPTIONS

    -H

    This "help" flag cause the program to print out a description
    of its operation and then exit immediately.
    -C

    This option causes the program to check if each output file
    already exists, and to forgo copying those that do exist.
    -I

    datalist

    Sets the input datalist filename. A datalist is an ascii
    file containing a list of the input swath sonar
    data files to be copied and their formats.
    In the datalist file, each
    swath data file should be followed by a data format identifier, e.g.:

            datafile1 11

            datafile2 24

    As discussed in the MB-System manual page, datalists may reference
    other datalists, allowing users to construct recursive datalist structures.
    This program uses the MBIO library and will read or write any swath sonar
    format supported by MBIO. A list of the swath sonar data formats
    currently supported by MBIO and their identifier values
    is given in the MBIO manual page.
    -N

    This argument causes mbm_multidatalist to generate the three ancillary
    data files ("inf", "fbt", and "fnv") even if they already exist and are up to date.
    -V

    Causes mbm_multidatalist to operate in "verbose" mode
    so that it outputs
    more information than usual.
    -X

    nprocesses

    This option sets the number of parallel, simultaneous mbdatalist processes that may be
    run.

    EXAMPLES

    Suppose one has two format 88 Reson 7125 data files:

            20110805_053612.mb88

            20110805_054149.mb88

    One can generate a datalist called datalistr.mb-1 referencing these
    three swath files using a text editor or by using awk:

            ls -1 *.mb88 | awk '{print $1" 88"}' > datalist.mb-1

    In order to generate the usual ancilliary files (*.inf, *.fbt, and *.fnv files)
    use the mbm_multidatalist macro:

            mbm_multidatalist -I datalist.mb-1 -X2 -V

    The macro prints out the following as it generates the *.inf, *.fbt, and *.fnv
    files for each swath data file:

            Running mbm_multidatalist...

            Executing mbdatalist -I20110805_053612.mb88 -O -V

            Executing mbdatalist -I20110805_054149.mb88 -O -V

            Program mbdatalist

            Version $Id: mbm_multidatalist.1 2096 2013-06-04 08:17:22Z caress $

            Program mbdatalist

            MB-system Version 5.3.1904

            Version $Id: mbm_multidatalist.1 2096 2013-06-04 08:17:22Z caress $

            MB-system Version 5.3.1904

            Generating inf file for 20110805_054149.mb88

            Generating inf file for 20110805_053612.mb88

            Generating fbt file for 20110805_054149.mb88

            Generating fbt file for 20110805_053612.mb88

            Generating fnv file for 20110805_054149.mb88

            Generating fnv file for 20110805_053612.mb88

            Total swath files:         1

            Total swath files:         1

    Note that the terminal messages from the two mbdatalist processes are
    mixed because the processes are executed in parallel.

    SEE ALSO

    mbsystem(1), mbdatalist(1), mbcopy(1),
    mbdatalist(1)

    BUGS

    Perhaps.

     Index

    NAME
    VERSION
    SYNOPSIS
    DESCRIPTION
    AUTHORSHIP
    SIMPLE DESCRIPTION OF BASIC OPTIONS
    EXAMPLES
    SEE ALSO
    BUGS

Last Updated: 3 June 2013

Return to list of MB-System manual pages...

Back to MB-System Home Page...