MB-System Unix Manual Page

mbsvplist

Section: MB-System 5.0 (l)
Updated: 4 October 2004
Index

NAME

mbsvplist - List water sound velocity profiles in swath sonar data files.

VERSION

Version 5.0

SYNOPSIS

mbsvplist [-D -Fformat -H -Ifile -O -P -V -Z]

DESCRIPTION

This program, mbsvplist, lists all water sound velocity profiles (SVPs) within swath data files. Swath bathymetry is calculated from raw angles and travel times by raytracing through a model of the speed of sound in water. Many swath data formats allow SVPs to be embedded in the data, and often the SVPs used to calculate the data will be included. By default, all unique SVPs encountered are listed to stdout. The SVPs may instead be written to individual files with names FILE_XXX.svp, where FILE is the swath data filename and XXX is the SVP count within the file. Some files contain SVPs at regular intervals, typically with the same SVP duplicated many times. By default, mbsvplist ignores duplicate SVPs. The -D option causes duplicate SVPs to be output. The -P option implies -O, and also causes the parameter file to be modified so that the first SVP output for each file becomes the SVP used for recalculating bathymetry for that swath file.

AUTHORSHIP

David W. Caress (caress@mbari.org)

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

Lamont-Doherty Earth Observatory

OPTIONS

-D: Causes mbsvplist to output duplicate SVPs.
-F: format
Sets the format for the input swath sonar data using MBIO integer format identifiers. If format < 0, then the input file specified with the -I option will actually contain a list of input swath sonar data files. This program uses the MBIO library and will read any swath sonar format supported by MBIO. A list of the swath sonar data formats currently supported by MBIO and their identifier values is given in the MBIO manual page.
-H: This "help" flag cause the program to print out a description of its operation and then exit immediately.
-I: file
Sets the input filename. If format > 0 (set with the -F option) then the swath sonar data contained in file is read and processed. If format < 0, then file is assumed to be an ascii file containing a list of the input swath sonar data files to be processed and their formats. The program will read the data in each one of these files. In the file file, each data file should be followed by a data format identifier, e.g.:
datafile1 11

datafile2 24

This program uses the MBIO library and will read or write any swath sonar format supported by MBIO. A list of the swath sonar data formats currently supported by MBIO and their identifier values is given in the MBIO manual page. Default: file = "datalist.mb-1".
-O: By default, mbsvplist writes the SVP records to stdout. This option causes the program to instead write the SVPs to individual files with names FILE_XXX.svp, where FILE is the source swath data filename and XXX is the SVP count within the file.
-P: This option implies the output option -O. Additionally, this option sets the first SVP output for each swathfile to be used for recalculating the bathymetry in that swathfile by mbprocess by modifying the associated parameter file.
-V: Normally, mbsvplist works "silently" without outputting anything to the stderr stream. If the -V flag is given, then mblist works in a "verbose" mode and outputs the program version being used and all error status messages.
-Z: Normally, mbsvplist faithfully outputs the SVP data just as it is stored in the swath files. Rarely, sonars may store SVP data with a nonzero depth for the first sound speed value, a circumstance that causes problems with bathymetry recalculation using mbprocess. The -Z option causes mbsvplist to replace the first depth value with zero before outputting the SVP.

EXAMPLES

Suppose one wishes to obtain an SVP list from a Simrad EM300 data file in the MBARI format (MBIO id 57) called mbari_1998_107_msn.mb57. To obtain a listing to stdout, the following will suffice:

mbsvplist -F57 -I mbari_1998_526_msn.mb57 -V

The output will be as follows:

Program mbsvplist
Version $Id: mbsvplist.l,v 5.2 2004/10/06 18:51:39 caress Exp $
MB-system Version 5.0

Searching mbari_1998_526_msn.mb57 for SVP records
Outputting SVP to file:
## Water Sound Velocity Profile (SVP)
## Output by Program mbsvplist
## Program Version $Id: mbsvplist.l,v 5.2 2004/10/06 18:51:39 caress Exp $
## MB-System Version 5.0.alpha01
## Run by user <caress> on cpu <menard> at <Thu Jan  4 13:36:44 2001>
## Swath File: mbari_1998_526_msn.mb57
## Start Time: 1998/05/02 01:33:08.300000
## SVP Count: 1
## Number of SVP Points: 15
     0.00        1503.50
     9.99        1502.70
    19.98        1501.80
    30.00        1501.40
    39.99        1501.40
    49.98        1499.90
    60.00        1499.80
    69.99        1497.50
    79.98        1496.90
    90.00        1496.90
    99.99        1495.10
   198.99        1486.60
   498.99        1480.60
  1000.98        1481.90
  1830.00        1488.70
##
##
4 SVP records read
1 SVP records written