HIPS and SIPS : HIPS and SIPS Commands A to K : Command line utilities : Dump
 

Dump

Dump programs write binary raw data files to text. By default the output is displayed in the command-line window. Alternatively they can be sent to a text file, and read in a text editor.

The available dump utilities are listed in the C:\Program Files\CARIS\HIPS and SIPS\10.1\modules\HIPS and SIPS\bin directory, and are run from the command line window, with the following syntax:

 

> \dumpABC <filename.ABC> > [output_textfileABC.txt]

For example, to dump XTF data to a text file:

3. Type the following:

 

\dumpxtf” linenumber.xtf > linenumber.txt

where linenumber.xtf identifies the line and linenumber.txt is the name of the output file.

This will create a text file of the raw xtf data in the same folder as the raw xtf file. Alternatively you can specify a path to a different output folder.

Available Dump Commands

Utility

Format: command <mandatory> [optional parameter]

dump7k

dump7k <Reson_7k_file> [-nodata] [‑imagery]

-nodata displays record headers only

-imagery will stop display of the contents of the 7057 (calibration backscatter imagery) datagrams

dump81X

dump81X <81X_filename> <packet number: [0=all]>

If packet number = 0, then all records are displayed. If not, then a single record matching the specified number is displayed.

dump83P

dump83P <Imagenex_filename_83P/83M> [‑nodata]

-nodata displays record headers only

dumpASD

dumpASD <ASD_filename> [-nodata] [‑noSS]

-nodata displays record headers only.

-noSS turns off display of the side scan data stored in the binary portion of the records.

dumpBRF

dumpBRF <BMT_BRF_file> [-nodata] [‑overview]

-nodata displays record headers only

-overview displays soundings data as a matrix, with "X" marking the spots where valid data exists

dumpCMAX

dumpCMAX <cmax_file_name>

(no optional parameters)

dumpCoda

dumpCODA <CODA_filename>

(no optional parameters)

dumpea400

dumpea400 < EA400_file_name> [-nodata] [‑gdp]

-nodata displays record headers only

-gdp outputs the navigation and single beam data in a format that can be easily imported into HIPS using the Generic Data Parser.

dumpeiva

dumpeiva <EIVA_SBD_file> [-nodata] {‑noSS>

-nodata displays record headers only

-noSS turns off display of the side scan data stored in the binary portion of the records (only if the EIVA data contains Atlas ASD records).

dumpelac

dumpelac <ELAC_file_name>

(no optional parameters)

dumpem

dumpem <EM_file_name> [-nodata]

-nodata displays record headers only

dumpfau

dumpfau <file_name>

(no optional parameters)

dumpfuruno

dumpfuruno <filename>

(no optional parameters)

dumpG99

dumpG99 <BIN_file_name> [-data]

(displays summary information, geographic extent, number of rows and columns of a NGS Geoid gridded.bin file)

-data displays all contents (BIN file can contain a lot of data.)

dumpgsf

dumpGSF <GSF_fileName> [-nodata]

-nodata displays record headers only

dumpHawkEye

dumpHawkEye <HawkEye_bin_file>

(no optional parameters)

dumphs2

dumpHS2 <Hypack_HS2_filename>

(no optional parameters)

dumphypackbin

dumphypackbin <bin_file>

(no optional parameters)

dumpJSF

dumpJSF <Edgetech_JSF_file> [-nodata]

-nodata displays record headers only

dumpklein

dumpklein <filename>

(no optional parameters)

dumplas

dumplas <LAS_filename> [-xyz]

-xyz displays only the XYZ data, with no other information presented

dumpMidas

dumpMidas <midas_file>

(no optional parameters)

dumpmstiff

dumpmstiff <MSTIFF_filename>

(no optional parameters)

dumpnp1

dumpnp1 <Teledyne_TDY_filename> -nodata

-nodata displays record headers only

dumpomg

dumpomg <OMG_Swathed_filename>

(no optional parameters)

dumpPDS

dumpPDS <PDS_filename> [-skip] [-nodata] [-nav] [‑head] [-mru] [-multi] [-echo] [-oldAPI]

-skip disables the display of Lead in/out data, which is data not normally considered part of normal survey operation.

-nodata displays record headers only.

-nav displays navigation data only.

-head displays heading data only.

-mru displays motion data only.

-multi displays multibeam data only.

-echo displays single beam data only.

-oldAPI displays data using the earlier API provided by RESON.

dumpProc

dumpProc <PROC_filename.extension> [‑nodata]

Displays only the data associated with the file extention.

-nodata displays record headers only

Include extention in filename to dump specific data to ASCII.

.depth: to include depth data. If this is specified, then position history data (from the .pos file) is displayed also.

.attitude: to include heave/pitch/roll data.

.heading: gyro heading data

.rtkheight: RTK height data

.para : parameters for the transducer and positioning system

.pos: positioning data

.sfsvp: sound velocity profile data

dumpqmips

dumpqmips <QMIPS_file_name>

(no optional parameters)

dumpRAW

dumpRAW <Navitronics_RAW_filename> [‑nodata]

-nodata displays record headers only

dumprdf

dumprdf <rdf_file_name> [-data]

-data displays bathymetric data. All other kinds of data is always displayed.

dumpsas

dumpsas <sas_file> [-nodata]

-nodata displays record headers only

dumpsb

dumpsb <Seabeam_filename>

(no optional parameters)

dumpsdf

dumpsdf <SDF_filename> [-bathy]

-bathy displays bathymetric data.

dumpsegy

dumpsegy <SEGY_filename>

(no optional parameters)

dumpsf

dumpsf <SeaFalcon_filename>

(no optional parameters)

dumpshoals

format: dumpshoals <shoals_file_name> [time_stamp]

(displays the contents of Shoals files:

OUT - The original Shoals data file. The flight line (.FL) file must be present for the data to be decoded.

HOF - The output file for a Shoals 1000T system.

INH - The waveform file for a Shoals 1000T system.

TOF - Topo output file.)

This utility also displays the contents of a HIPS .HWI file, (an indexed file generated by the Shoals converter in order to quickly associate a HIPS sounding with the associated Shoals output data or the waveform data).

time_stamp: if set

for HOF data, only the specific record that corresponds to the set timestamp (a 64-bit integer number) is displayed.

for INH data, the corresponding waveform data is displayed, and can be input to a spreadsheet and graphed

dumpsio

dumpsio <filename>

(no optional parameters)

dumpSurf

dumpsurf <filename> [-nodata]

This utility displays contents of an Atlas Surf file (V3 ) in ASCII text.

-nodata displays record headers only

dumpSXP

dumpSXP <SwathPlus_SXP_filename> [‑nodata]

-nodata displays record headers only

dumpSXR

dumpSXR <SXR_filename/SXI_filename> [‑data] [-filter]

[-data] Displays detailed sonar data

[-filter] Used in conjunction with -data to apply filtering to the data

dumptgt

dumptgt <TGT_filename> [-tif]

(displays the contents of an Isis .con or .tgt file)

-tif generates a TIFF file containing the bitmap imagery stored within the .con/.tgt file.

dumptrueHeave

dumpTrueHeave <TrueHeave_filename> [‑summary]

-summary displays summary data only (first/ last TrueHeave time)

dumpUnisips

dumpUnisips <Unisips_filename>

(no optional parameters)

dumpXSE

dumpXSE <elac_xse_file_name> [-nodata]

-nodata displays record headers only

dumpXTF

dumpXTF <XTF_filename> [-nodata] [‑nosnippets]

(will display R2Sonic snippet records if present

-nodata displays record headers only

-nosnippets - turns off the display of R2Sonic