MB-System Unix Manual Page

MBeditviz

Section: MB-System 5.0 (1)
Updated: 3 June 2013
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).

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: 3 June 2013


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

Back to MB-System Home Page...