mbformatSection: MB-System 5.0 (1)
Updated: 3 June 2013
NAMEmbformat - List information about swath sonar data formats supported by the MBIO library.
SYNOPSISmbformat [ -Fformat -Ifile -L -K -V -H]
DESCRIPTIONmbformat is a utility which identifies the swath sonar data formats associated with mbio format id's. If no format id or input filename is specified, mbformat lists all of the currently supported formats along with short descriptions. If a format id is specified using the -F option, then mbformat prints a short description of that format. If a filename is specified using the -I option, then mbformat attempts to identify a valid format id for that file using swath data filename prefix and suffix conventions embedded in MB-System. The program also determines the filename "root", which is the filename minus whatever format-specific prefix or suffix has been recognized. In no prefix or suffix is recognized, then the root is simply the entire filename.
Normally, mbformat prints out a brief description of each identified format. If the -L option is used, mbformat simply prints out the valid format id number, or 0 if a file or format has been specified but no valid id can be identified. If the -K option is used, mbformat will print out the filename "root" followed by the format id number.
AUTHORSHIPDavid W. Caress (email@example.com)
Monterey Bay Aquarium Research Institute
Dale N. Chayes (firstname.lastname@example.org)
Lamont-Doherty Earth Observatory
Suppose one wishes to list all of the currently supported data formats.
The following will suffice:
Suppose one wants to find out what format is associated with a raw
SeaBeam 2112 file named sb199811231045.rec:
mbformat -I sb199811231045.rec
This results in the output:
MBIO data format id: 41
Format name: MBF_SB2100RW
Informal Description: SeaBeam 2100 series vender format
Attributes: SeaBeam 2100, bathymetry, amplitude
and sidescan, 151 beams and 2000 pixels, ascii
with binary sidescan, SeaBeam Instruments.
Using the -K option:
mbformat -K -I sb199811231045.rec
will produce the following output:
where the format id has been identified as 41 because of the ".rec" file suffix and the fileroot has been identified as "sb199811231045" by removing the suffix. Use of the -L option:
mbformat -L -I sb199811231045.rec
will produce output with just format id:
Last Updated: 3 June 2013
Return to list of MB-System manual pages...
Back to MB-System Home Page...