MB-System Unix Manual Page

mbhsdump

Section: MB-System 5.0 (1)
Updated: 7 June 2013
Index
 

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.

 

MB-SYSTEM AUTHORSHIP

David W. Caress

  Monterey Bay Aquarium Research Institute
Dale N. Chayes

  Center for Coastal and Ocean Mapping

  University of New Hampshire
Christian do Santos Ferreira

  MARUM - Center for Marine Environmental Sciences

  University of Bremen

 

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.


 

Index

NAME
VERSION
SYNOPSIS
DESCRIPTION
MB-SYSTEM AUTHORSHIP
OPTIONS
EXAMPLES
SEE ALSO
BUGS


Last Updated: 7 June 2013