HIPS and SIPS Module : HIPS and SIPS Commands : Command line utilities : Other utilities
 

Other utilities

Refract

This utility processes one or more HIPS lines, and generates a refraction coefficient file (refCoefficients) for each line in its line directory. The resulting coefficient values can then be used to correct refraction artifacts when the data is merged in HIPS.

Format:

refract <lineDirectory> <#profiles>

 

The parameter #profiles generates a refraction entry by grouping profiles together. The number of profiles must be at least 1.

The following criteria must be met in order for this tool to work effectively:

1. The data should be as clean as possible. Noisy data will interfere with the computations.

2. The data should be from a relatively flat sea floor. A sloping sea floor is acceptable.

3. The vessel file must be set up accurately.

splitMB41

This utility divides SeaBeam MB41 raw data files that cross the dateline or have a large lat/long span. It takes each .mb41 file in <directory> and slices it into one or two pieces. The newly generated files are written to the same directory.

Format:

splitMB41 <directory> <longitude_boundary> <longitude_buffer>

The output .mb41 files have names that are derived from the input file name (for example, file_1.mb41, file_2.mb41, etc).

The file with the _1.mb41 extension contains data which is up to 180 degrees clockwise from the boundary specified. (For example, if boundary is set at180 degrees, then the _1 file contains data from 0.0E - 180.0E).

The file with the _2.mb41 extension contains data from the other 180 degrees. If either of these files contains no data, it is deleted.

Parameters are:

directory: the directory where the source.mb41 files are located.

longitude_boundary: The longitude (in degrees) where the split happens.

longitude_buffer: The buffer (in degrees) on either side of the boundary within which data will not be output.

createTPU

This utility is used to load TPU values into lines using a simple mapping table based on depth. For each sounding that is read in, a Vertical TPU and Horizontal TPU value is interpolated from the entries in the user-defined mapping table.

Format:

createTPU <list_file_name> <tpe_file_name> [proc|obs]

where

list_file_name is the name of the file containing the list of lines to be updated. Each line in the file must be in the format:

DataDirectory Project [Vessel] [Day] [Line]

Vessel, Day and Line can be optional and will cause the program to use all lines within the specified folder (recursive).

tpe_file_name is the name of the file containing the TPU mapping values. Each line must have the format:

Depth VertTPU HorizTPU

The optional parameters proc and obs specify whether processed depths or observed depths are used in the process.

All units are expected to be in metres, and the TPU values are treated as confidence intervals.

printSBET

This is a dump utility for SBET files, for which the command is print, not dump.

Format:

printSBET <Inputfile> <Outputfile>

Inputfile can specify more than one file, and can use the format PATH\*.*.