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

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

Back to MB-System Home Page...