MB-System Unix Manual Page: mbdumpesf

### MB-System Unix Manual Page

#

##

##

##

##

##

##

##

##

##

##

    mbdumpesf
    Section:  MB-System 5.0  (l)
    Updated:  7 June 2010
    Index

    NAME

    mbmask, mbdumpesf - Output text version of beam edits from a binary edit save file.

    VERSION

    Version 5.0

    SYNOPSIS

    mbdumpesf -Ifile [-V -H]

    DESCRIPTION

    Swath bathymetry data is typically edited either with interactive
    tools such as mbedit or automatic filters such as mbclean.
    In MB-System, the beam flags are stored in binary "edit save files"
    (file suffix ".esf"). The program mbdumpesf reads esf files and
    outputs each of the edit events as a text line to stdout.

    AUTHORSHIP

    David W. Caress (caress@mbari.org)

      Monterey Bay Aquarium Research Institute

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

      Lamont-Doherty Earth Observatory

    MBDUMPESF OPTIONS

    -H

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

    file

    "Edit save file" from which the edit events will be read.
    -V

    Normally, mbdumpesf outputs one line for each edit event in
    the input esf file.  If the
    -V flag is given, then mbdumpesf also outputs the
    total number of each type of edit event at the end of the listing.

    EXAMPLES

    Suppose one has edited a swath file 20080422_222636.mb88, resulting
    in an esf file named 20080422_222636.mb88.esf. To dump the edit events
    as a text stream, use mbdumpesf:

            mbdumpesf -I 20080422_222636.mb88.esf

    The output will look something like:

    EDITS READ: i:0 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:21 action:1

    EDITS READ: i:1 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:22 action:1

    EDITS READ: i:2 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:23 action:1

    EDITS READ: i:3 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:24 action:1

    EDITS READ: i:4 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:25 action:1

    EDITS READ: i:5 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:26 action:1

    EDITS READ: i:6 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:27 action:1

    EDITS READ: i:7 time: 947562291.799000 2008/04/22 22:26:36.799000 beam:28 action:1

    Here the large time value is epoch seconds (seconds since 1/1/1970), and the
    edit event action values are:

            action=1: flag manually

            action=2: unflag

            action=3: zero - make beam null

            action=4: flag by autofilter

    SEE ALSO

    mbsystem(l), mbedit(l), mbeditviz(l), fBmbclean(l), mbunclean(l)

    BUGS

    Too simple to have any interesting problems.

     Index

    NAME
    VERSION
    SYNOPSIS
    DESCRIPTION
    AUTHORSHIP
    MBDUMPESF OPTIONS
    EXAMPLES
    SEE ALSO
    BUGS

Last Updated: 7 June 2010

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

Back to MB-System Home Page...