Description
The ImportToHIPS process imports various formats to HIPS and SIPS.
Inputs
One or more raw data files in a supported format.
Outputs
Converted HIPS data.
Command Line Syntax
carisbatch --run ImportToHIPS
Options
The following table describes the parameters available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
Common Options | ||||
--input-format | I | A string specifying the format of the data to import. • ATLAS_ASD: Atlas ASD format • ATLAS_HYDROSWEEPDS: Atlas Hydrosweep format • ATLAS_SURF: Atlas SURF SDA format • BATHYSWATHSXR: Bathyswath (SWATHPLUS) SXR raw sonar data format • BATHYSWATHSXI: Bathyswath (SWATHPLUS) SXI intermediate data format • BATHYSWATHSXP: Bathyswath (SWATHPLUS) SXP processed sonar data format • CHIRPSCAN3D: Chirpscan3D BRF format • CMAX: CMAX CMX,CM2,CMP format • CODA: Coda format • EDGETECH_260: Edgetech 260 format • DGETECH_JSF: Edgetech JSF format • EDGETECH_MIDAS: Edgetech Midas format • EIVA: EIVA SBD format • ELAC: ELAC XSE format • FURUNO: Furuno LOG format • GEOACOUSTICS_RDF: GeoAcoustics RDF format • GEOACOUSTICS_RFF: GeoAcoustics RFF format • GSF: GSF format • HAWKEYE: Hawkeye BIN format • HYPACK: Hypack RAW, HSX format • HYPACK_HS2: Hypack HS2 format • IMAGENEX: Imagenex 83p, 83m format • KLEIN: Klein SDF format • KONGSBERG: Kongsberg ALL format • KONGSBERG_EA600: Kongsberg EA600 RAW, DEPTH format • KRAKEN: Kraken TIL format • LADS: LADS CAF format • LAS: LAS format • MARINESONICS: Marine Sonics MS TIFF format • PROSAS: PROSAS IMG format • QMIPS: QMIPS DAT format • SCRIPPS: Scripps format • SEABEAM: Seabeam format • SEGY: SEGY format • SHOALS: SHOALS OUT, HOF, TOF format • SPAWAR: SPAWAR DAT format • TELEDYNE: Teledyne TDY format • TELEDYNE_7K: Teledyne S7K format • TELEDYNE_PDS: Teledyne PDS format • UNB: UNG MERGED format • WINFROG: Winfrog RAW format • XTF: Triton XTF format | FALSE | This must be specified explicitly. |
--input-crs | p | A string specifying the horizontal coordinate reference system key of the input. The default value is LLDG. | FALSE | The default is LLDG. |
--carry-raw-data-files | c | If set, copies the original data files to the processed data folders. | FALSE | |
--overwrite | If set, specified data will be overwritten. • BATHY: Bathymetry • NAVIGATION: Navigation • MOTION: Motion • BACKSCATTER: Backscatter • SIDE_SCAN: Sidescan | TRUE | ||
--filter-extent-type | Filter the navigation data to a specific geographical extent. • PROJECT: Project - Filter to the extents of the destination project. • CUSTOM: Custom - Manually set coordinates (min X/long), (min Y/lat), (max X/long), (max Y/lat) of extents of filter. | FALSE | ||
--extent | The extents that define the window. <LowerX> - A number specifying the lower left X origin in the coordinate reference system of the input. <LowerY> - A number specifying the lower left Y origin in the coordinate reference system of the input. <UpperX> - A number specifying the upper right X origin in the coordinate reference system of the input. <UpperY> - A number specifying the upper right Y origin in the coordinate reference system of the input. Only applicable if FilterCoverType is set to CUSTOM. The unit is assumed to be that of the input's coordinate reference system, unless otherwise specified. When specifying units for unprojected data, an angle type unit is required. The order for unprojected coordinates is longitude followed by latitude. Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd, yd, deg and rad. | FALSE | Only used if FilterCoverType is set to CUSTOM. | |
--filter | A number specifying the Z values to a min/max range. <FilterMin> - The minimum values for imported data. <FilterMax> - The maximum values for imported data. The valid range is +/- 15000. | FALSE | ||
--filter-amplitude-percent | A number specifying the how soundings are filtered by amplitude. Soundings that fall below the defined percentage of min/max amplitude values will be rejected. The valid range is 0 to 50. | FALSE | ||
--filter-angle-T1 | Filters transducer 1 data to a min/max angle. <MinAngle> - The minimum angle to filter. <MaxAngle> - The maximum angle to filter. The valid range is -20 to 100. | FALSE | ||
--filter-angle-T2 | Filters transducer 1 data to a min/max angle. <MinAngle> - The minimum angle to filter. <MaxAngle> - The maximum angle to filter. The valid range is -20 to 100. | FALSE | ||
--filter-range | Filters soundings by range from the transducer to the seafloor. <MinRange> - The minimum range to filter. <MaxRange> - The maximum range to filter. The valid range is 0 to 15000. | FALSE | ||
--filter-across-track-distance | Any soundings beyond the specified distance from nadir will be filtered. <Port> - The port side distance from nadir. <Starboard> - The starboard side distance from nadir. If not set, the default is to not filter. The valid range is 0 or greater. Supported units: metres. | FALSE | ||
--filter-swath-size | Filter soundings by a distance from nadir. All soundings outside of this range will be filtered. <Port> - The port side distance from nadir. <Starboard> - The starboard side distance from nadir. The valid range is 0 to 10000. | FALSE | ||
--filter-depth-multiplier- | A number specifying the depth multiplier applied to nadir depth to determine the Swath distance outside which to filter data. The valid range is 0 to 50. | FALSE | ||
--filter-stat-threshold | A number specifying the statistical threshold by which the standard deviation should be multiplied by in order to get the Confidence Interval. The valid range is 1 to 3. | FALSE | ||
--filter-stat-sector-angle | A number specifying the statistical filter angle. Cannot be used with horizontal bin. The valid range is 0.3 to 9.0. | FALSE | ||
--filter-stat-bin- size | A number specifying the statistical filter bin resolution as distance on the ground. Cannot be used with sector angle. The valid range is 0.03 to 5. Only applicable with FilterStatSectorAngle is not used. | FALSE | ||
--filter-stat-thin-factor | A number specifying the thinning factor applied to soundings converted per swath sector. The default value is 4. The thinning factor uses a power of two reduction control (2, 4, 8, etc.) so that one of two, one of four, one of eight, etc. • 2 • 4 • 8 • 16 • 32 • 64 • 128 • 256 Only applicable with FilterStatSectorAngle or FilterStatBinSize. Used with FilterStatDepthComparator. | FALSE | ||
--filter-stat-depth-comparator | A string specifying the thinning equation to compare filtered values from bin of data against either the mean or median value in the bin and retain the closest. • MEAN: Mean • MEDIAN: Median Only applicable with StatisticalThinningFactor. | FALSE | ||
--filter-keep-thinned-data | If set, converts the filtered data to HDCS. Flags will be set to rejected. | FALSE | ||
InputFormat = Atlas_ASD Options | ||||
--convert-side-scan | S | If set, the specified side scan frequency is imported. • HIGH: High - High frequency • LOW: Low - Low frequency The default is HIGH. | FALSE | |
InputFormat = Atlas_HydrosweepDS Options | ||||
--survey-year | y | A number specifying the Year of the survey for Hydrosweep data. The default is to use the current year. The format is "YYYY". | FALSE | |
InputFormat = Atlas_SURF Options | ||||
--convert-side-scan | s | If set, converts side scan from SURF data. | FALSE | |
--convert-bathymetry | b | The type of SURF bathymetry to convert. • MULTIBEAM: Multibeam • SINGLE_LOW: Single Beam (Low Frequency) • SINGLE_MED: Single Beam (Medium Frequency) • SINGLE_HIGH: Single Beam (High Frequency) • DUAL_LOW_MED: Dual-Frequency Single Beam (Low/Medium) • DUAL_LOW_HIGH: Dual-Frequency Single Beam (Low/High) • DUAL_MED_HIGH: Dual-Frequency Single Beam (Medium/High) The default is MULTIBEAM. | FALSE | |
--use-higher-frequency | F | f set, higher frequency sounding is primary sounding for dual beam SURF data. If not set, lower frequency sounding is primary. | FALSE | |
InputFormat = BATHYSWATH_SXR Options | ||||
--sound-velocity | S | If set, the sound velocity applied to the imported SXR data. The default value is 1500 m/s. Units are m/s. | FALSE | |
InputFormat = BATHYSWATH_SXI Options | ||||
| N/A | |||
InputFormat = BATHYSWATH_SXP Options | ||||
| N/A | |||
InputFormat = CHIRPSCAN3D Options | ||||
| N/A | |||
InputFormat = CMAX Options | ||||
| N/A | |||
InputFormat = CODA Options | ||||
--cable-out-is-layback | L | If set, omits the sensor depth and treats cable out as layback. | FALSE | |
--sonar-channel | s | A string specifying the sonar channel to convert. • ANALOG: Analog • EDGETECH_DF: Edgetech DF1000 • EDGETECH_FSU: Edgetech FSIU • KLEIN_3000: Klein 3000 • EDGETECH_ACI: Edgetech ACI 272T • RESON_81X: Reson 81xx • BENTHOS_SIS: Benthos SIS • ATLAS: Atlas • EDGETECH_MPX: Edgetech Discover/MPX • KLEIN_5000: Klein 5000 • SES: SES Multilink • EDGETECH_4200: Edgetech 4200 • EDGETECH_4100: Edgetech 4100 • BENTHOS_1600: Benthos 1600 Default value is ANALOG. | FALSE | |
InputFormat = EDGETECH_260 Options | ||||
N/A | ||||
InputFormat = EDGETECH_JSF Options | ||||
--convert-side-scan | s | The frequency channel to convert. Selecting Auto converts low frequency if it exists, otherwise converts high frequency. • NONE: None - No side scan is converted (default) • AUTO: Auto - Converts low frequency if it exists, otherwise converts high. • HIGH: High - High frequency • LOW: Low - Low frequency The default value is NONE. | FALSE | |
--convert-from-cable-out | C | If set, converts from cable out, otherwise layback is used. | FALSE | |
--sensor-depth-location | d | Source location for sensor depth. • SENSOR: Sensor • DISCOVER2: Discover2 The default value is SENSOR. | FALSE | |
--sensor-altitude-location | a | Source location for altitude. • SENSOR: Sensor • DISCOVER2: Discover2 The default value is SENSOR. | FALSE | |
--convert-bathymetry | b | If set, converts JSF bathymetry. | FALSE | |
--output-filtered-data | F | If set, converts filtered data as Rejected. | FALSE | |
--echo-strength-percent | e | A number specifying the percentage value to filter Echo Strength. If not set, acquisition setting is used. The valid range is 0 to 100. | FALSE | |
--quality-percent | q | A number specifying the percentage value to filter Quality. All data with a quality percentage below the value set will be filtered. If not set, acquisition setting is used. • 50 • 60 • 70 • 80 • 80 • 90 | FALSE | |
--snr-db | n | A number specifying the decibel value to filter SNR. Valid values are from 0 to 30. If not set, acquisition setting is used. | FALSE | |
InputFormat = EDGETECH_MIDAS Options | ||||
--convert-side-scan | s | The frequency channel to convert. • LOW: Low - 100 kHz • HIGH: High - 500 kHz The default value is LOW. | FALSE | |
InputFormat = EIVA Options | ||||
--convert-side-scan | s | The type of ASD side scan to convert. • HIGH: High • LOW: Low The default value is HIGH. | FALSE | |
--depth-source | d | The source of bathymetry. • BINARY: Binary - Default source of bathymetry • XML: XML - XML portion of Atlas ASD data in the side scan datagram The default value is BINARY. | FALSE | |
--nav-device | n | A number specifying the navigation device number. The valid range is 0 to 4.The default value is 0. | FALSE | |
--heading-device | g | A number specifying the heading device number. The valid range is 0 to 4.The default value is 0. | FALSE | The default is 0. |
--motion-device | m | A number specifying the motion device number. The valid range is 0 to 4. The default value is 0. | FALSE | The default is 0. |
--convert-vehicle-depth | D | If set, stores the EIVA sub-packets as HIPS delta draft/subsea depth. | FALSE | |
--pad-with-null | P | If set, replaces missing data with NULL (rejected) beams in the case of dual head data where the data from head 1 is missing. | FALSE | |
--swap-transducers | w | If set, switches data between heads (in a dual-head setup) on conversion. | FALSE | |
--separate-dual-head-data | S | If set, the soundings from dual head transducer data are not combined into a single HIPS profile. | FALSE | |
InputFormat = ELAC Options | ||||
--attitude-source | a | The source of the attitude. • NAV: Navigation - Navigation records • MULTIBEAM: Multibeam - Multibeam records The default value is NAV. | FALSE | |
--surface-sound-speed | S | A number specifying the user defined surface sound speed. If not set, a sound speed is interpolated from the stored sound velocity profile. | FALSE | |
--convert-side-scan | s | If set, converts side scan data. | FALSE | |
--stbd-to-port-numbering | n | If set, numbers the beams starboard to port. If not set, numbers the beams port to starboard. | FALSE | |
--pad-with-null | P | If set, replaces missing data with NULL (rejected) beams in the case of dual head data where the data from head 1 is missing. | FALSE | |
InputFormat = FURUNO Options | ||||
--convert-side-scan | s | If set, converts side scan data. | FALSE | |
InputFormat = GeoAcoustics_RDF Options | ||||
--gps-string-type | The navigation string to read. • ANY: Any - Attempts to automatically determine the string type • GGK: GGK - GGK string • GGA: GGA - GGA string • GLL: GLL - GLL string The default value is ANY. | FALSE | ||
--convert-vehicle-depth | If set, converts Aux1 as delta draft/subsea depth. | FALSE | ||
--filter-water-column | If set, data flagged by water column filter during acquisition in GeoSwath Plus GS+ will be converted as rejected. | FALSE | ||
--filter-post-processing | If set, data flagged by specified filter during post-processing in GeoSwath Plus GS+ will be converted as rejected. • AMPLITUDE: Amplitude • LIMITS: Limits • ACROSS_TRACK: Across Track • ALONG_TRACK_CELL: Along Track/Cell | TRUE | ||
InputFormat = GeoAcoustics_RFF Options | ||||
--convert-vehicle-depth | If set, converts Aux1 as delta draft/subsea depth. | FALSE | ||
--filter-acquisition | If set, data flagged by specified filter during acquisition in GeoSwath Plus GS4 will be converted as rejected. • GROUP_BOTTOM_TRACK: Group/Bottom Track • WATER_COLUMN: Water Column | TRUE | ||
--filter-post-processing | If set, data flagged by specified filter during post-processing in GeoSwath Plus GS4 will be converted as rejected. • AMPLITUDE: Amplitude • LIMITS: Limits • ACROSS_TRACK: Across Track • ALONG_TRACK_CELL: Along Track/Cell | TRUE | ||
InputFormat = GSF Options | ||||
--depth-source | The source for depth data. • TRUE: True - True Depth • NOMINAL: Nominal - Nominal Depth The default value is TRUE. | FALSE | The default is TRUE. | |
--include-offline | If set, converts data flagged as offline. | FALSE | ||
--reject-offline | If set, converts the offline data as rejected. Only applicable if IncludeOffline is set to True. | FALSE | ||
InputFormat = Hawkeye Options | ||||
--depth-source | Sets the source for depths. • DEPTH: Depth • POINT: Point Altitude The default value is DEPTH. | FALSE | ||
--import-type | If set, converts all data flagged by specified value. • FOUND: Found • NOT_FOUND: Not Found • INVALID: Invalid • UNCLASSIFIED: Unclassified • LAND: Land • WATER_SURFACE: Water Surface • SHALLOW: Shallow • BOTTOM: Bottom • HIGHLAND: Highland • TARGET: Target | TRUE | ||
--invalid-as-positive-99 | If set, assigns a value of +99m to invalid points rejected during conversion. If not set, points are assigned a depth of -99m. | FALSE | ||
InputFormat = Hypack Options | ||||
--sound-velocity | A number specifying the sound velocity. The default is 1500 m/s. This value is used to compute the original travel time for single and multi-transducer (sweep) data. | FALSE | ||
--convert-bathymetry | b | The type of bathymetry to convert. • NONE: No bathymetry converted • MULTIBEAM: Multibeam • MULTITRANS: Multi-transducer • SINGLE: Single beam, single frequency • DUAL_PRIMSEC: Single beam as Primary, Secondary frequency • DUAL_SECPRIM: Single beam as Secondary, Primary frequency The default value is MULTIBEAM. | FALSE | |
--convert-side-scan | s | The side scan channel to convert. • NONE: No side scan converted • HIGH: High frequency • LOW: Low frequency The default value is NONE. | FALSE | |
--apply-static-draft | If set, applies the stored static draft value to the depths. | FALSE | ||
--nav-device | A number specifying the navigation device number to override Hypack default. | FALSE | ||
--heading-device | A number specifying the heading device number to override Hypack default. | FALSE | ||
--motion-device | A number specifying the motion device number to override Hypack default. | FALSE | ||
--port-device | A number specifying the port transducer device number to override Hypack default. | FALSE | ||
--stbd-device | A number specifying the starboard transducer device number to override Hypack default. | FALSE | ||
--sow-device | A number specifying the speed over water device number to override Hypack default. | FALSE | ||
--hours-from-gmt | A number specifying the offset in hours from GMT to apply to all timestamps. Used when acquisition time was not GMT. | FALSE | ||
InputFormat = Hypack_HS2 Options | ||||
--survey-date | y | A string specifying the survey date to override the date in the HS2 file. Set a year and julian day. The format is "YYYY-DDD". | FALSE | |
--depths-in-feet | If set, treats the depths stored in the HS2 file as feet. | FALSE | ||
InputFormat = Imagenex Options | ||||
--gps-string-type | The navigation string to read in. If ANY is used and both are present in the raw data, both strings will be converted. • ANY: Any • GGA: GGA • GGK: GGK The default value is ANY. | FALSE | ||
InputFormat = Klein Options | ||||
--convert-side-scan | s | The side scan channel to convert. • NONE: No side scan is converted • HIGH: High frequency • LOW: Low frequency The default value is LOW. | FALSE | |
--include-hidden | If set, converts data flagged as hidden (redundant data collected during acquisition). | FALSE | ||
--convert-sss-gyro | If set, converts the side scan gyro. | FALSE | ||
--convert-aux-altitude | If set, converts the sonar altitude from the auxiliary altitude field. If not set, converts from Towfish altitude field. | FALSE | ||
--pressure-sensor-psi | The pressure sensor PSI. • 100 • 300 • 1000 • 1500 The default value is 1000. | FALSE | ||
--pressure-sensor-range | The pressure sensor voltage range. • 05: 0 - 5V • 15: 1 - 5V The default value is 05. | FALSE | ||
--cable-out-is-layback | If set, omits the sensor depth and treat cable out as layback | FALSE | ||
--convert-aux-depth | If set, uses the data in the auxiliary depth field, otherwise calculate depth from pressure sensor voltage. Only applicable if CableOutIsLayback is used. | FALSE | ||
--convert-vehicle-depth | Convert depth field as Delta Draft. • NONE: No depths are converted. • AUX_DEPTH: Depth is converted from the Auxiliary depth field. • PRESSURE: Calculate depth from pressure sensor voltage. The default value is AUX_Depth. | FALSE | ||
--convert-bathymetry | If set, converts bathymetry data. | FALSE | ||
--snr-filter | A number specifying the value above or below the stored SNR value to filter by. If the data has a smaller SNR than specified in the Threshold field, it is then converted and flagged as Rejected. Minimum/maximum threshold settings are -50.0/50.0, respectively. If not set, does not filter. | FALSE | ||
--uncertainty-filter | A number specifying the value above or below the stored uncertainty value to filter by. If the data has a smaller uncertainty than specified in the Threshold field, it is then converted and flagged as Rejected. Minimum/maximum threshold settings are 0.0/1.0 respectively. If not set, does not filter. | FALSE |
| |
--confidence-value | A number specifying the confidence value used to filter the bathymetry. The valid range is 50 to 100. The default value is 70. | FALSE | ||
--output-filtered-data | If set, converts filtered data as rejected. If not set, does not convert. | FALSE | ||
--heave-positive-down | Set if the direction that Heave data is stored in the SDF file when created by the Klein SonarPro® software is positive down. | FALSE | ||
--pitch-positive-bow-up | Set if the direction that Pitch data is stored in the SDF file when created by the Klein SonarPro®software is positive bow up, otherwise it is converted as positive bow down. | FALSE | ||
--roll-positive-port-up | Set if the direction that Roll data is stored in the SDF file when created by the Klein SonarPro®software is positive port up, otherwise it is converted as positive port down. | FALSE | ||
--yaw-ccw-from-north | Set if the direction that Yaw data is stored in the SDF file when created by the Klein SonarPro®software is counter-clockwise from north, otherwise it is converted as positive clockwise from north. | FALSE | ||
InputFormat = Kongsberg Options | ||||
--convert-nav | N | If set, converts navigation data to HDCS, otherwise reference the file directly. | FALSE | |
--nav-device | The navigation device number to convert if navigation is converted to HDCS, and the source of GPS height if GGA or GGK is used. • AUTO (default) • NAV1 • NAV2 • NAV3 The default value is AUTO. | FALSE | ||
--gps-height-device | The GPS height device to use. • EMHEIGHT (default) • GGA • GGK The default value is EMHEIGHT. | FALSE | ||
--gps-time-stamps | Source for navigation time stamps. • AUTO (default) • SYSTEM • GPS The default value is AUTO. | FALSE | ||
--heading-device | The heading device to use. • AUTO (default) • MRU1 • MRU2 • EMHeight The default value is AUTO. | FALSE | ||
--heave-device | The heave device number to use. • AUTO (default) • MRU1 • MRU2 The default value is AUTO. | FALSE | ||
--pitch-device | The pitch device number to use. • AUTO (default) • MRU1 • MRU2 The default value is AUTO. | FALSE | ||
--roll-device | The roll device number to use. • AUTO (default) • MRU1 • MRU2 The default value is AUTO. | FALSE | ||
--convert-vehicle-depth | If set, converts depth field as Delta Draft. Ignored/automatic for newer sonar models. | FALSE | ||
--time-shift | A number specifying the seconds to add to each datagram time. | FALSE | ||
InputFormat = Kongsberg_EA600 Options | ||||
--convert-bathymetry | b | The EA400/EA600 single beam to convert. • PRIMARY • SECONDARY The default value is PRIMARY. | FALSE | |
--port-device | P | The EA400/EA600 side scan port device number. Valid values from 1 to 9. • NONE: No Port device number. • 1: Device 1 • 2: Device 2 • 3: Device 3 • 4: Device 4 • 5: Device 5 • 6: Device 6 • 7: Device 7 • 8: Device 8 • 9: Device 9 The default value is 1. | FALSE | |
--stbd-device | S | The EA400/EA600 side scan starboard device number. • NONE: No Starboard device number. • 1: Device 1 • 2: Device 2 • 3: Device 3 • 4: Device 4 • 5: Device 5 • 6: Device 6 • 7: Device 7 • 8: Device 8 • 9: Device 9 The default value is NONE. | FALSE | |
InputFormat = Kraken Options | ||||
N/A | ||||
InputFormat = LADS Options | ||||
N/A | ||||
InputFormat = LAS Options | ||||
--invert-elevation | If set, inverts the height convention of the incoming depths. | FALSE | ||
--override-date | If set, overrides the date stored in the file header. | FALSE | ||
--survey-date | y | A string specifying the reference date, if Override is used. Set a year and julian day. [YYYY-DDD] | FALSE | |
InputFormat = MarineSonics Options | ||||
N/A | ||||
InputFormat = ProSAS Options | ||||
--convert-q0-data | q | If set, converts quality 0 data. | FALSE | |
InputFormat = QMIPS Options | ||||
--use-alt-channel | If set, uses side scan from channels 3 and 4, instead of channels 1 and 2. | FALSE | ||
InputFormat = Scripps Options | ||||
N/A | ||||
InputFormat = Seabeam Options | ||||
--convert-side-scan | s | If set, converts side scan. | FALSE | |
--convert-vehicle-depth | If set, converts vehicle depth and delta draft/subsea depth. | FALSE | ||
InputFormat = SEGY Options | ||||
N/A | ||||
InputFormat = SHOALS Options | ||||
--confidence-value | A number specifying the confidence value flagged during acquisition and used to filter the data. Valid values from 50 to 100. The default value is 70. | FALSE | ||
--tof-convert | Convert the first (top of vegetation canopy) or second pulse (return from the ground). • FIRST: First pulse • SECOND: Second pulse The default value is SECOND. | FALSE | ||
InputFormat = SPAWAR Options | ||||
N/A | ||||
InputFormat = TeledyneTDY Options | ||||
N/A | ||||
InputFormat = Teledyne7K Options | ||||
--separate-dual | If set, soundings from a dual head transducer are not combined into a single HIPS profile. | FALSE | ||
--reject-quality | Rejects bathymetry with the numbered quality flag. Quality 0 is lowest quality and 3 is highest. Quality bit 0 is the lowest quality, where in the sonar both brightness and colinearity tests fail. Quality bit 1 is a mid quality, where in the sonar the brightness test passes and the colinearity test fails. Quality bit 2 is a mid to high quality, where in the sonar the brightness test fails and the colinearity test passes. Quality bit 3 is the highest quality, where in the sonar both brightness and colinearity tests pass. Valid values are 0 - 3. | TRUE | ||
--navigation-device | The navigation device. • AUTO: Auto - Use 1003 if it exists • NAVIGATION: Navigation Record (1015) • POSITION: Position Record (1003) The default value is AUTO, 1015 otherwise. | FALSE | ||
--heading-device | The heading device. • AUTO: Auto - Use 1013 if it exists • ATTITUDE: Attitude Record (1016) • HEADING: Heading Record (1013) • NAVIGATION: Navigation Record (1015) The default value is AUTO, 1016 otherwise, 1015 otherwise. | FALSE | ||
--motion-device | The motion device. • AUTO: Auto - Use 1012 if it exists • ATTITUDE: Attitude Record (1016) • RPH: Motion Record (1012) The default value is AUTO. | FALSE | ||
--swath-device | The swath device. • AUTO: Auto - Use 7027 if it exists • BATHYMETRY: Bathymetry Records (7004/7006) • RAWDETECTION: Raw Detection Record (7027) The default value is AUTO, 7004/7006 otherwise. | FALSE | ||
--convert-vehicle-depth | If set, converts depth field as Delta Draft/Subsea depth. | FALSE | ||
InputFormat = TeledynePDS Options | ||||
--convert-bathymetry | b | The type of bathymetry to convert. • MULTIBEAM: Multibeam bathymetry (default) • SINGLEBEAM: Singlebeam bathymetry • SINGLEBEAMDUAL: Dual frequency singlebeam The default value is MULTIBEAM. | FALSE | |
--include-offline | If set, converts data flagged as offline. | FALSE | ||
--reject-quality | Rejects bathymetry with the numbered quality flag. Quality 0 is lowest quality and 3 is highest. Quality bit 0 is the lowest quality, where in the sonar both brightness and colinearity tests fail. Quality bit 1 is a mid quality, where in the sonar the brightness test passes and the colinearity test fails. Quality bit 2 is a mid to high quality, where in the sonar the brightness test fails and the colinearity test passes. Quality bit 3 is the highest quality, where in the sonar both brightness and colinearity tests pass. Valid values are 0 - 3. | FALSE | ||
--navigation-device | A number specifying the navigation device number. Valid values are from 1 to 5. Default is 1. | FALSE | ||
--heading-device | A number specifying the heading device number. Valid values are from 1 to 5. Default is 1. | FALSE | ||
--motion-device | A number specifying the motion device number. Valid values are from 1 to 5. Default is 1. | FALSE | ||
--source-type | T | The type of singlebeam data to convert. • ECHO_ID: Raw Data • CF_DEPTH: Processed The default value is ECHO_ID. Applies only when SINGLEBEAM is used. Dual frequency singlebeam can only be converted from the Raw Data (ECHO_ID) Source Type. Data from both a primary (P) and a secondary (S) device, with one of four channels for each device can be converted. | FALSE | |
--device-number | d | The singlebeam device number to convert. • 1 • 2 The default value is 1. Applies only when SINGLEBEAM or SINGLEBEAMDUAL is used. Setting a device that is not present will cause no depth data to be converted. | FALSE | |
--primary-channel | P | The primary singlebeam device and channel to assign. • 1:1 • 1:2 • 1:3 • 1:4 • 2:1 • 2:2 • 2:3 • 2:4 The default value is 1:1. Applies only when SINGLEBEAM or SINGLEBEAMDUAL is used, and source type is ECHO_ID. Setting a device that is not present, or in which the selected depth channel is not available, will cause no depth data to be converted. | FALSE | |
--secondary-channel | S | The secondary singlebeam device and channel to assign. • 1:1 • 1:2 • 1:3 • 1:4 • 2:1 • 2:2 • 2:3 • 2:4 The default value is 2:1. Applies only when SINGLEBEAMDUAL is used, and source type is ECHO_ID. Setting a device that is not present, or in which the selected depth channel is not available, will cause no depth data to be converted. | FALSE | |
InputFormat = UNB Options | ||||
--is-dual-head | If set, determines the number of transducers to convert. This is for Teledyne Reson sonars only. | FALSE | ||
--convert-backscatter | s | If set, converts backscatter data. | FALSE | |
InputFormat = Winfrog Options | ||||
--convert-bathymetry | b | Import single or dual frequency single beam. • SINGLE: Single beam, single frequency • DUAL: Single beam, dual frequency The default value is SINGLE. | FALSE | |
--navigation-device | The navigation device. One of: • 303: 303 records • 351: 351 records The default value is 303. | FALSE | ||
--motion-device | The motion device. One of: • 413: 413 records • 888: 888 records The default value is 413. | FALSE | ||
--sound-velocity | A number specifying sound velocity to use to generate slant range data. If not set, 1500 m/s is used. | FALSE | ||
InputFormat = XTF Options | ||||
--navigation-device | The navigation device name to use during bathymetry conversion. • RAW: Raw navigation records • POSITION: Position data records • PING_SHIP: Ping header, ship • PING_SENSOR: Ping header, sensor • HEADER_NAV: Header navigation records The default value is PING_SHIP. | FALSE | ||
--gps-height-device | The GPS height device name to use during bathymetry conversion. • RTK: RTK packets • TIDE: Ocean tide The default value is RTK. | FALSE | ||
--motion-device | The motion device name used with Raw Navigation during bathymetry conversion. • RAW: Raw navigation datagram • ATTITUDE: Attitude datagram The default value is ATTITUDE. | FALSE | ||
--convert-bathymetry | b | The type of bathymetry to convert. • NONE: (None) - No bathymetry converted • MULTIBEAM: Multibeam • MULTITRANS: Multi-transducer • SB0: Single beam records, primary = 0 • SB1: Single beam records, primary = 1 • SB2: Single beam records, primary = 2 • SBAUX1: Single beam from Aux 1 • SBAUX2: Single beam from Aux 2 • SBAUX3: Single beam from Aux 3 • SBAUX4: Single beam from Aux 4 The default value is NONE. | FALSE | |
--heading-device | The heading device name to use during bathymetry conversion. • PING_SHIP: Ping header, ship (default) • PING_SENSOR: Ping header, sensor • ATTITUDE: Attitude packets • CMG_NAV: CMG from navigation • CMG_SSSNAV: CMG from SSS navigation • HEADER_GYRO: Header gyro records The default value is PING_SHIP. | FALSE | ||
--reject-quality | Rejects bathymetry with the numbered quality flag. Valid values are 0 - 3. | TRUE | ||
--convert-side-scan | s | The side scan channel to convert. • NONE: (None) - No side scan converted • 12: Channels 1 and 2 • 34: Channels 3 and 4 • 14: Channels 1 and 4 • 23: Channels 2 and 3 The default value is NONE. | FALSE | |
ss-nav-device | The side scan navigation device name. • RAW: Raw navigation records • POSITION: Position data records • PING_SHIP: Ping header, ship • PING_SENSOR: Ping header, sensor • HEADER_NAV: Header navigation records The default value is HEADER_NAV. | FALSE | ||
ss-heading-device | The heading device name for side scan. • PING_SHIP: Ping header, ship • PING_SENSOR: Ping header, sensor • ATTITUDE: Attitude packets • RAW: Raw navigation records • CMG_NAV: CMG from navigation • CMG_SSSNAV: CMG from SSS navigation • HEADER_GYRO: Header gyro records The default value is PING_SENSOR. | FALSE | ||
--include-offline | If set, converts side scan data flagged as offline. | FALSE | ||
--convert-layback-cable-out | Convert layback or cable out data. • NONE: No layback or cable out converted • LAYBACK: Convert layback • CABLEOUT: Convert cable out The default value is NONE. | FALSE | ||
--layback-multiplier | Multiplier to compute the layback value, if cableout is converted. The default value is 1.0. | FALSE | ||
--use-aux-value | Calculate the sensor depth from this auxiliary field minus the sensor height, if cableout is converted. The valid range is 1 to 6. | FALSE | ||
--convert-vehicle-depth | Convert the vehicle depth as delta draft/subsea depth. • NONE: No vehicle depth converted • SENSORDEPTH: Sensor depth field • AUX1: Auxiliary field number 1 • AUX2: Auxiliary field number 2 • AUX3: Auxiliary field number 3 • AUX4: Auxiliary field number 4 • AUX5: Auxiliary field number 5 • AUX6: Auxiliary field number 6 The default value is NONE. | FALSE | ||
--use-time-sync | If set, synchronizes timestamps for all files in the same folder. | FALSE | ||