MB-System Unix Manual Page: mbm_copy

### MB-System Unix Manual Page

#

##

##

##

##

##

##

##

##

##

##

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

    NAME

    mbm_copy - Apply mbcopy to all files referenced through
    a datalist, using the MB-System file suffix convention
    to name the output files

    VERSION

    Version 5.0

    SYNOPSIS

    mbm_copy -Foutputformat -Idatalist
    [-H -C -T -V]

    DESCRIPTION

    mbm_copy is a macro used to copy large numbers of swath data files
    from one data format to another using the program mbcopy.
    The input is a datalist file referencing
    all of the target swath files. The output swath file format is specified
    with the -F option. If the output swath file format is not specified,
    the output format will be the same as the input format.

    The macro identifies a filename root for each input swath file. For files
    with recognized filename suffixes (e.g. ".mb61" for a format 61 file), the
    filename root is the part of the filename that comes before the suffix. For
    files without a recognized suffix, the filename root is the entire filename.
    So, for a format 57 data file called "0007_20020425_060531.mb57", the filename root
    is "0007_20020425_060531". For a format 121 file named "009_1659", the filename
    root "009_1659".

    The output filenames are automatically constructed by adding the standard
    MB-System file suffix to the filename root. This suffix is ".mbXXX" where
    XXX is the two or three digit format id number. In the event that the output
    filename is the same as the input filename (likely only if the -F option
    is not used to set the output format), a "c" will be placed at the beginning
    of the output file suffix, making it "c.mbXXX".

    The -T option causes this macro to print out the mbcopy commands
    it will execute without actually executing them. This test option allows
    users to check the consequences of their command before actually running it.

    AUTHORSHIP

    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.
    -F

    outputformat

    This option sets the output swath format. All of the swath data
    files referenced in the datalist specified with the -I option
    will be copied to format outputformat using mbcopy. If
    the -F option is not given, then the input files will be copied
    to their input formats.
    -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.
    -T

    This option causes mbm_copy to print out the mbcopy commands
    it will execute without actually executing them. This test option allows
    users to check the consequences of their command before actually running it.
    -V

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

    EXAMPLES

    Suppose one has three raw (format 56) Simrad EM300 data files:

            0001_20020424_212920_raw.all

            0002_20020425_011607_raw.all

            0003_20020425_022926_raw.all

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

            ls -1 *all | awk '{print $1" 56"}' > datalistr.mb-1

    In order to translate all three files in the processing format for
    Simrad multibeam data (format 57), use the mbm_copy macro:

            mbm_copy -I datalistr.mb-1 -F 57 -T -V

    The macro prints out the following as it translates the swath data:

            Running: mbcopy -F56/57

                    -I0001_20020424_212920_raw.all

                    -O0001_20020424_212920.mb57

            Running: mbcopy -F56/57

                    -I0002_20020425_011607_raw.all

                    -O0002_20020425_011607.mb57

            Running: mbcopy -F56/57

                    -I0003_20020425_022926_raw.all

                    -O0003_20020425_022926.mb57

    SEE ALSO

    mbsystem(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...