MB-System Unix Manual Page: mbeditviz

### MB-System Unix Manual Page

#

##

##

##

##

##

##

##

##

##

##

##

##

    MBeditviz
    Section:  MB-System 5.0  (1)
    Updated:  2 June 2014
    Index

    NAME

    MBeditviz - 3D visualization-based editing of swath bathymetry soundings.

    VERSION

    Version 5.0

    SYNOPSIS

    MBeditviz [-Idatalist -V -H]

    DESCRIPTION

    Overview

    MBeditviz is an interactive 2D/3D visualization-based tool for editing swath
    bathymetry data. The bathymetry data from selected files are read into memory, gridded,
    and displayed in the same 2D/3D visualization environment used by MBgrdviz. In
    this environment, users can select arbitrary areas or regions. All of the soundings in
    the selected areas are displayed in a 3D "cloud" that can be rotated, zoomed, and exaggerated.
    These soundings can also be edited using the same edit mouse modes as in MBedit.
    MBeditviz operates with "edit save files" (*.esf) in the same fashion as MBedit,
    mbclean, and mbareaclean. To apply the edits in processing, simply run mbprocess
    on a datalist referencing the relevant files.

    Starting Up

    The initial MBeditviz display shows a list of the swath files you have identified by using
    the "File->Open Swath File" menu item. The list has four columns.
    The first (left-most) column is either blank or shows "<locked>" or "<loaded>".
    If a file is loaded for gridding and editing by this program, it shows as "<loaded>".
    If a file is being edited or processed by another program, it shows as
    "<locked>". Locked files cannot be opened for editing, and any file
    loaded for editing by MBeditviz will show as "locked" to other
    programs. The second column is either blank or shows "<esf>". This indicates if
    a file has been previously edited so that an edit save file already
    exists. The third column indicates, if the file is loaded, whether asynchronous heading ("H"),
    sonar depth ("S"), and attitude ("A") time series data have been loaded along with the
    swath bathymetry data. These asynchronous data are required in order to use MBeditviz
    to assess time lag issues, but are not available for all datasets.
    The fourth and fifth columns show the filename and the MBIO
    format id, respectively.
    Users can select one of the files in the available list. If the "Edit Selected File"
    button is clicked, the selected file will be opened for editing (and any
    file already loaded will be closed first). If the "Remove Selected File"
    button is selected, then the selected file will be removed from the available
    list.

    You can select some or all of the files in the list.
    When you click on the "View All Files" or the "View Selected Files", MBeditviz reads the
    specified files, loading all of the soundings into memory. The program then brings up a
    "Grid Parameters" dialog which suggests a grid cell size and shows the implied dimensions
    of a grid enclosing all of the data. The two issues to keep in mind are that you want the
    grid to be reasonably sized (dimensions <2500 or so on my laptop) and that no interpolation
    is applied in the gridding, so too small a grid cell size will leave gaps between soundings
    in the map view. When you click "Apply", MBeditviz grids the soundings, and then displays
    the grid using the same 2D/3D interface as MBgrdviz, including the navigation associated with
    the selected swath files.

    The navigation associated with the selected swath files will be displayed as well, and can
    be selected or queried by setting the mouse mode to

    Data files that have been previously edited with MBeditviz, MBedit, mbclean,
    or mbareaclean will have two related ancilliary files with suffixes ".esf" and ".par".
    The "*.esf" file is the edit save file containing all of the flag and unflag edit events
    generated for soundings in a data file. The "*.par" file is the processing parameter file
    that contains all of the processing parameters and instructions to be applied by the program
    mbprocess. MBeditviz will read and apply the pre-existing edit events as files
    are read into memory. The initial gridded view of the bathymetry will reflect all of the
    pre-existing edit events.

    Displaying a "Sounding Cloud"

    Once you have an MBeditviz survey display, set the mouse mode to "Pick Area" and either use
    the left button to drag a square "region", or use the middle button to drag an arbitrarily
    oriented "area" (also, if an area is defined the right button decreases/increases the width
    of the area). Each time you define or change a picked region or area, MBeditviz will display
    the point cloud of soundings located in the region or area. Since MBeditviz also displays
    the swath file navigation, users can also change the mouse mode to "Pick Nav" or "Pick Nav File"
    and select portions of the navigation. In this case the sounding cloud will encompass all of
    the data associated with the selected navigation. The 3Dsoundings view is manipulated
    using the middle and right mouse buttons in either rotation mode or zoom/exagerate mode.

    You can edit the soundings in the point cloud context using the left mouse button. The
    editing mouse modes work just like MBedit. The View menu in the
    point cloud display lets you show, or not show, the flagged soundings (which are displayed in red).

    Changing Sounding Colors

    The [3D Soundings]:<Action> pulldown menu has seven buttons that allow the user to change the
    display color of all currently selected unflagged soundings. Each of these options
    (black, red, yellow, green, bluegreen, blue, purple) acts on the soundings  displayed in
    the 3D Soundings window, and these color settings are saved when the 3D Soundings window is
    dismissed or redisplayed. This feature can aid in using MBeditviz for patch test
    (bias parameter) analysis. For instance, if a survey includes reciprocal lines (two coincident
    survey lines collected in opposite directions), one can use a narrow strip of soundings across
    the swaths to assess the roll bias value. This analysis is easier if the soundings from the
    two reciprocal swaths can be differentiated. To accomplish this, a user can select one line using the
    [MBview]:<Pick Nav> mode, bringing those associated soundings up in the 3D Soundings window,
    and then set all those soundings to be colored green. The soundings of the opposite line
    can be similarly colored purple. Then, selecting a narrow area across the reciprocal lines
    will select and display soundings from both lines, and those soundings will be green or
    purple depending on which line they are part of.

    Applying the Bathyemtry Edits

    When you dismiss the gridded view, the esf files of the affected files will be updated just
    as they are with MBedit. The program also modifies the mbprocess parameter file
    for the input file by specifying the edit save file and setting the mbprocess mode to
    apply the edits when generating a processed swath output file. If no parameter file exists,
    mbeditviz creates one.

    AUTHORSHIP

    David W. Caress (caress@mbari.org)

      Monterey Bay Aquarium Research Institute

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

      Lamont-Doherty Earth Observatory

    OPTIONS

    -H

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

    datalist

    Sets an MB-System datalist file to be parsed on input for swath data files
    to list as available for editing.
    This option is usually used when MBeditviz is started
    automatically from some other process, such as MBgrdviz.
    -V

    Normally, MBeditviz outputs limited information to the stderr stream.
    If the -V flag is given, then MBeditviz works in a "verbose" mode and
    outputs the program version being used, all error status messages,
    and a large amount of other information including all of the
    beams flagged or zeroed.

    INTERACTIVE CONTROLS

    MOUSE ACTIONS

    KEYBOARD ACTIONS

    SEE ALSO

    mbsystem(1), mbedit(1), mbprocess(1) mbset(1)

    BUGS

    This program is not done, nor is it adequately documented.

     Index

    NAME
    VERSION
    SYNOPSIS
    DESCRIPTION
    AUTHORSHIP
    OPTIONS
    INTERACTIVE CONTROLS
    MOUSE ACTIONS
    KEYBOARD ACTIONS
    SEE ALSO
    BUGS

Last Updated: 2 June 2014

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

Back to MB-System Home Page...