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
--add-crossing=file1:section1/file2:section2
--set-tie=file1:section1/file2:section2/xoffset/yoffset/zoffset
--set-tie-xyz=file1:section1/file2:section2
--set-tie-xyonly=file1:section1/file2:section2
--set-tie-zonly=file1:section1/file2:section2
--set-ties-xyz-with-file=file
--set-ties-xyonly-with-file=file
--set-ties-zonly-with-file=file
--set-ties-xyz-by-survey=survey
--set-ties-xyonly-by-survey=survey
--set-ties-zonly-by-survey=survey
--set-ties-xyz-by-block=survey1/survey2--set-ties-xyonly-by-block=survey1/survey2
--set-ties-zonly-by-block=survey1/survey2
--set-ties-zoffset-by-block=survey1/survey2/zoffset
--skip-unset-crossings
--verbose --help ]
DESCRIPTION
MBnavadjustmerge is a command line program that merges two
existing MBnavadjust projects or modifies a single
MBnavadjust project.
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.
With respect to the merging function, if the MBnavadjustmerge
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.
In order to make use of the project modification commands, a
single input project must be specified, along with one or more
of the modification commands. These can include adding crossings,
setting tie z-offset values, setting tie offsets (even if no
corresponding crossing already exists), setting tie modes
(xy only, z only, xyz), and deleting ties.
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
The --input option defines an existing, input MBnavadjust
project. A project may be defined by a relative or absolute path
to the project *.nvh file or the project *.dir directory. This option
can be used twice to specify two input projects. 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. If only the base input project is
specified, then that project will be modified according to one or
more of the "add", "delete", "skip", or "set" commands.
- --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.
- --add-crossing=file1:section1/file2:section2
-
This option adds the specified crossing to the MBnavadjust project.
- --set-tie=file1:section1/file2:section2/xoffset/yoffset/zoffset
-
This option adds the specified tie to the MBnavadjust project.
If the corresponding crossing does not already exist, it will be
created.
- --set-tie-xyz=file1:section1/file2:section2
-
This option sets the mode of the existing specified tie in the
MBnavadjust project to be "XYZ". This means all three
coordinates of the tie will be used as constraints in the inversion
for an optimal navigation model.
- --set-tie-xyonly=file1:section1/file2:section2
-
This option sets the mode of the existing specified tie in the
MBnavadjust project to be "XY". This means only the horizontal
coordinates of the tie will be used as constraints in the inversion
for an optimal navigation model.
- --set-tie-zonly=file1:section1/file2:section2
-
This option sets the mode of the existing specified tie in the
MBnavadjust project to be "Z". This means only the vertical
coordinate of the tie will be used as a constraint in the inversion
for an optimal navigation model.
- --set-ties-xyz-with-file=file
-
This option sets the mode of all ties involved with the specified
file in the MBnavadjust project to be "XYZ". This means all three
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyonly-with-file=file
-
This option sets the mode of all ties involved with the specified
file in the MBnavadjust project to be "XY". This means only the horizontal
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-zonly-with-file=file
-
This option sets the mode of all ties involved with the specified
file in the MBnavadjust project to be "Z". This means only the vertical
coordinate of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyz-with-survey=survey
-
This option sets the mode of all ties involved with the specified
survey in the MBnavadjust project to be "XYZ". This means all three
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyonly-with-survey=survey
-
This option sets the mode of all ties involved with the specified
survey in the MBnavadjust project to be "XY". This means only the horizontal
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-zonly-with-survey=survey
-
This option sets the mode of all ties involved with the specified
survey in the MBnavadjust project to be "Z". This means only the vertical
coordinate of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyz-by-survey=survey
-
This option sets the mode of all ties between two sections in the specified
survey in the MBnavadjust project to be "XYZ". This means all three
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyonly-by-survey=survey
-
This option sets the mode of all ties between two sections in the specified
survey in the MBnavadjust project to be "XY". This means only the horizontal
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-zonly-by-survey=survey
-
This option sets the mode of all ties between two sections in the specified
survey in the MBnavadjust project to be "Z". This means only the vertical
coordinate of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyz-by-block=survey1/survey2
-
This option sets the mode of all ties between sections of the specified
two surveys in the MBnavadjust project to be "XYZ". This means all three
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-xyonly-by-block=survey1/survey2
-
This option sets the mode of all ties between sections in the specified
two surveys in the MBnavadjust project to be "XY". This means only the horizontal
coordinates of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-zonly-by-block=survey1/survey2
-
This option sets the mode of all ties between sections in the specified
two surveys in the MBnavadjust project to be "Z". This means only the vertical
coordinate of these ties will be used as constraints in the inversion
for an optimal navigation model.
- --set-ties-zoffset-by-block=survey1/survey2/zoffset
-
This option resets the zoffset value of all ties between sections in the specified
two surveys.
- --skip-unset-crossings
-
This option sets all unset crossings in the input projects to be
skipped. This does not apply to any new crossings between the two
merged projects.
- --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.
- --help
-
This option causes MBnavadjustmergeP to output a list of the
possible command line options, and then exit.
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=Navadjust20140515m2.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.
If the --skip-unset-crossings option is added to the above command, then
all unset crossings in the two input projects will be set to "skipped" mode in
the output project.
SEE ALSO
mbsystem(1), mbio(1), mbprocess(1),
mbnavadjust(1), mbset(1)
BUGS
It started out simple and bulletproof, but now it's 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...