mbdumpesf(1)

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(1), mbedit(1), mbeditviz(1), fBmbclean(1), mbunclean(1)

BUGS
Too simple to have any interesting problems.