mbhsdump(1)

NAME
mbhsdump - lists the information contained in Hydrosweep DS data files.

VERSION
Version 5.0

SYNOPSIS
mbhsdump [-Fformat -Iinfile -Okind -V -H]

DESCRIPTION
mbhsdump lists the information contained in data records on Hydrosweep DS data files, including survey, calibrate, water velocity and comment records. The default input stream is stdin. Prior to version 5.4 this program was named hsdump.

AUTHORSHIP
David W. Caress (caress@mbari.org)
  Monterey Bay Aquarium Research Institute
Dale N. Chayes (dale@ldeo.columbia.edu)
  Lamont-Doherty Earth Observatory

OPTIONS

-F  format
    Sets the format for the input and output swath sonar data using MBIO integer format identifiers. This program is specific to Hydrosweep DS data, and cannot be used with data from any other swath sonar system or with data in a Hydrosweep format that does not include water velocity records. Currently, the two formats which can be used are the raw Hydrosweep DS format (MBIO id 21) and the L-DEO in-house binary Hydrosweep format (MBIO id 24). Default: format = 5.

-H  This "help" flag causes the program to print out a description of its operation and then exit immediately.

-I  infile
    Data file from which the input data will be read. If no input file is specified, the input will be read from stdin. Default: infile = stdin.

-O  kind
    Sets the kind of data record which will be listed, where the choices for kind include:
         1:    Survey data record
         2:    Comment record
         3:    Calibrate data record
         4:    Mean velocity data record
         5:    Velocity profile data record
         6:    Standby data record
         7:    Navigation source data record
    This option can be given multiple times to set more than one kind of data record for listing.

-V  Normally, mbhsdump lists only the contents of the data records which are specified with the -O option. If the -V flag is given, then mbhsdump works in a "verbose" mode and outputs the program version being used, any comment records encountered in the data stream, and all error status messages.

EXAMPLES
Suppose one wishes to list out the water velocity records contained in the raw Hydrosweep (format 21) file hsraw. The following will suffice:
     mbhsdump -F21 -O4 -O5 -Ihsraw

SEE ALSO
mbsystem(1), mbinfo(1), mblist(1)

BUGS
Other than the name change, this program hasn't been altered in this century. It is probably stale.