MB-System Unix Manual Page

mbnavadjustmerge

Section: MB-System 5.0 (1)
Updated: 28 May 2014
Index
 

NAME

mbnavadjustmerge - Tool to merge two MBnavadjust projects, either adding one to the first or outputting a new project combining both existing projects.

 

VERSION

Version 5.0

 

SYNOPSIS

mbnavadjustmerge --input=project-base --input=project-add --output=project-output --verbose

 

DESCRIPTION

MBnavadjustmerge is a command line program that merges two existing MBnavadjust projects. If the user specifies two input projects and no output project, then the second project is added to the first. If an output project is specified, then the two projects are merged and the new combined project is output.

MBnavadjust is an interactive graphical program used to adjust swath data navigation by matching bathymetric features in overlapping and crossing swaths. The primary purpose of mbnavadjust is to eliminate relative navigational errors in swath data obtained from poorly navigated sonars.

 

AUTHORSHIP

David W. Caress (caress@mbari.org)

  Monterey Bay Aquarium Research Institute
Dale N. Chayes (dale@ldeo.columbia.edu)

  Lamont-Doherty Earth Observatory

 

OPTIONS

--input=project-base
--input=project-add This option defines either of the input, existing MBnavadjust projects. A project may be defined by a relative or absolute path to the project *.nvh file or the project *.dir directory. The first use of --input defines the base input project, and the second defines the add input project. In the case where the --output option is used to define an output project, the two input projects will both be copied to the new output project (project-base first followed by project-add). If the output option is not specified, then the project-base project is used as the output, and the project-add project is added on to the project-base project.
--output=project-output
This option defines the new MBnavadjust output project. The two input projects will both be copied to the new output project (project-base first followed by project-add). If the output option is not specified, then the project-base project is used as the output, and the project-add project is added on to the project-base project.
--verbose
This option increases the verbosity of MBnavadjustmerge, which means that more information than by default is output to the stderr stream of the shell.

 

EXAMPLES

Suppose you have two AUV survey missions, 20140515m1 and 10140515m2, that overlap slightly. If you have used MBnavadjust to adjust the navigation of the two missions separately, you can use MBnavadjustmerge to merge the two MBnavadjust projects into a single new project without losing any of the ties made between overlapping sections in the existing projects. If the two existing projects are named "Navadjust20140515m1" and "Navadjust20140515m2", respectively, then there exist project files with a ".nvh" suffix and project directories with a ".dir" suffix. To create a new MBnavadjust project combining the two existing projects, the following will suffice:

     mbnavadjustmerge --input=Navadjust20140515m1.nvh                       --input=Navadjust20140515m1.nvh                       --output=Navadjust20140515All.nvh
The new project Navadjust20140515All can be opened and analyzed further using MBnavadjust. When opening the new project, the user should first solve for a comprehensive navigation adjustment model by selecting the <Action->Invert Navigation> menu item, and then find the crossings between the two previously separate missions by selecting the <Action->Check For New Crossings> menu item

 

SEE ALSO

mbsystem(1), mbio(1), mbprocess(1), mbnavadjust(1), mbset(1)

 

BUGS

It used to be too new to be bulletproof, now its too complicated to be bulletproof. Good luck.


 

Index

NAME
VERSION
SYNOPSIS
DESCRIPTION
AUTHORSHIP
OPTIONS
EXAMPLES
SEE ALSO
BUGS


Last Updated: 28 May 2014


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

Back to MB-System Home Page...