hsdump
Section:  MB-System 5.0  (l)
Updated:  4 January 2001 
Index


 
NAME

hsdump - hsdump lists the information contained in Hydrosweep DS data files.

 
VERSION

Version 5.0

 
SYNOPSIS

hsdump [-Fformat -Iinfile -Okind -V -H]

 
DESCRIPTION

hsdump hsdump 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.

 
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, hsdump lists only the contents of the data records 
which are specified with the -O option.  If the
-V flag is given, then hsdump 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:

        hsdump -F21 -O4 -O5 -Ihsraw


 
SEE ALSO

mbsystem(l), mbinfo(l), mblist(l)

 
BUGS

You tell me.



 
Index

NAME

VERSION

SYNOPSIS

DESCRIPTION

AUTHORSHIP

OPTIONS

EXAMPLES

SEE ALSO

BUGS

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

Back to MB-System Home Page...