mbsvpselectSection: MB-System 5.0 (1)
Updated: 13 March 2014
NAMEmbsvpselect - Mbsvpselect chooses and implements the best available sound speed model for each swath file in a survey
SYNOPSISmbsvpselect -N -V -Idatalist -Ssvplist -Pmode[/criteria[/submode]]
[-P0, -P1, -P2/period, -P3/range, -P3/range/1] mbsvpselect [-C -D -Fformat -H -Ifile -Mmode -O -P -S -V -Z]
DESCRIPTIONMbsvpselect chooses and implements the best available sound speed model for each swath file in a survey. The user provides a list of the available sound speed models and specifies the criteria used for model selection. The program uses mbset to turn on bathymetry recalculation by raytracing through the sound speed model selected for each swath file.
The tool aims to help users to automatically apply the sound velocity correction to the survey files. since most surveys involve several SVPs, the seletion of the appropriate SVP for each survey profile is still missing in MB-System.
After finding the appropriate svp for each profile based on the choosed method, the results are copied to a txt file that shows each survey profile with the corresponding SVP. the tool also calls mbset automatically so no need to assign SVP to the data. it is done automatically.
There are 5 methods for choosing the appropriate SVP for each survey profile. These methods are:
1. Nearest SVP in position: the middle position of each survey profile
is calculated and the geodesics (shortest distance on the ellipsoid)
to all SVPs are calcualted. and the SVP with the shortest distance is
chosen. when the middle position of the survey profile is calculated
there is an option to check for 0 lat 0 long wrong values. if it is
found at the starting the geodesic will be calculated to the end of
2. Nearest in time: the time interveal between the starting time of
the profile and the time of the SVP, and the SVP with the shortest
interval will be chosen.
3. Nearest in position within time: a default time radius from the
profile is set as 10 hours, and within this period the nearest SVP
in position is chosen. if none of the SVPs are within this period the
nearest in position will be taken despit of the period threshold. The
period threshold can be set by the user.
4. Nearest in time within range: similar to the previous option but
this time a default range of 10000 meters is set and within this range
the svp nearest in time is chosen. also this 10000 meter value could
be set by the user.
5. Nearest in season within range: similar to the previous option the
selected SVP could be chosen based on the month only not on the year.
it means within the specified range the user could chose either the svp
nearest in time or the svp nearest in month (this could be interpreted
as the svp that falls in the same seasonal period despite of the year
when it was taken).
Mbsvpselect reads the .inf file of each swath file referenced in a recursive datalist structure to determine the location and collection time of the relevant data. The ancilliary *.inf, *.fbt, and *.fnv files must be created first. The water sound speed models (called SVPs by convention as an acronym for Sound Velocity Profiles) to be used must include one of three supported file headers specifying the time and location of the model.
University of Bremen SVP headers:
MB-SVP 2011/01/08 19:30:00 -52.965437 -36.986314
(keyword yyyy/mm/dd hh:mm:ss latitude longitude)
MB-System SVPs as now output by mbsvplist:
#MB-SVP 2011/01/08 19:30:00 -36.986314 -52.965437
(keyword yyyy/mm/dd hh:mm:ss longitude latitude)
CARIS sound velocity header format:
Section 2013-150 23:22:18 -57:02:01 -26:02:18
(keyword yyyy-yearDay hh:mm:ss latitude (degree:min:sec) longitude (degree:min:sec))
Mbsvpselect supports SVP files with single models or files with multiple models where new headers occur between models.
1) Set up a survey (or surveys) for MB-System processing in the usual way,
including creating a datalist file referencing the swath data of interest
and generating the ancilliary *.inf, *.fbt, and *.fnv files for each of
the swath files. 2) Create an svplist file (analagous to a datalist, but referencing the
relevant SVP files). Each SVP file is expected to be a text file with
depth-sound speed pairs on each line (depth in meters, sound speed in
meters/second) excepting for a header line at the start of each discrete
model. Any of the header formats listed above will work.
that refers to a local svp datalist. the local datalists includes 3) In order to turn on bathymetry recalculation by raytracing through the
most appropriate sound speed model for each swath file, call mbsvpselect:
mbsvpselect -N -V -Idatalist -Ssvplist [-P0, -P1, -P2/period, -P3/range, -P3/range/1]
-N is the option to check 0 latitude 0 longitude in the survey lines.
-I input datalist
-S input svp datalist
-P the method for choosing the svp where:
-P or -P0 is the nearest in position
-P1 is the nearest in time
-P2 is nearest in position within time (default time period is 10 hours)
-P2/time is nearest in position within specified time period (in hours)
-P3 is nearest in time within range (default range is 10000 meters)
-P3/range or -P3/range/0 is nearest in time within specified range (in meters)
-P3/range/1 is nearest in month (seasonal) within specified range in meter.
AUTHORSHIPAmmar Aljuhe (firstname.lastname@example.org)
MARUM, University of Bremen
Christian do Santos Ferreira (email@example.com)
MARUM, University of Bremen
or, if you use absolute passwords, something like:
By convention, this datalist will be named something like datalist.mb-1, where the ".mb-1" suffix indicates to MB-System programs that this is a datalist file. As documented elsewhere, datalist files can contain entries that reference datalists rather than single files; thus datalists can be recursive.
Suppose that the water properties were variable during this
survey, with the variability dominated by location.Further suppose
that there are three SVP files in a separate directory with
names such as svp1.svp, svp2.svp, and svp3.svp. Each of these files
contains a single model derived from CTD casts at a particular
place and time indicated in the single header line. In that directory
one can create an svplist file named SVP_list.mb-1 with contents:
svp3.svp Since mbsvpselect allows svplists to be recursive (like datalists), one can create a second svplist named my_svplist.mb-1in the survey processing directory that references the first with an entry like:
In order to turn on bathymetry recalculation for all of the swath files referenced by datalist.mb-1 using the most appropriate of the available sound speed models, run mbsvpselect with arguments like:
mbsvpselect -N -V -I datalist.mb-1 -S my_svplist.mb-1 -P2/50
Here the -P2/50 option specifies that the sound speed model to be used for each file will be the closest one collected within 50 hours of the swath data. The bathymetry recalculation will be turned on using an mbset call of the form:
mbset -Idatalist.mb-1 -PSVPFILE:/MyMac/User/Survey_1/SVP_folder/svp1.svp
Following the mbsvpselect usage, mbprocess must be run to actually reprocess the swath data, including bathymetry recalculation by raytracing.
Last Updated: 13 March 2014
Return to list of MB-System manual pages...
Back to MB-System Home Page...