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