Description
The SoundVelocityCorrectHIPS process uses a ray tracing algorithm to apply the sound velocity profiles.
Inputs
One or more HIPS track lines.
Outputs
Updated HIPS track lines with depths that are corrected for sound velocity.
Command Line Syntax
carisbatch --run SoundVelocityCorrectHIPS [options] <inputs> <outputs>
Options
The following table describes the parameters available for this process.
Parameter |
| |||
Long | Short | Description | Can Repeat | Notes
|
--algorithm | Ray tracing algorithms are available through Teledyne CARIS or third party. One of: • CARIS: Caris - All algorithms directly implemented. • KONGSBERG_LIBRARY: Kongsberg Library - Licensed algorithm coming from library provided by Kongsberg. | FALSE | This must be specified explicitly. | |
--svp-file | The path to the sound velocity file. If not set, uses the SVP already loaded in the HIPS data for the track lines passed to the process. | FALSE | ||
--profile-selection-method | Method for selection of which sound velocity profile to apply for each ping, when multiple profiles are available. One of: • PREVIOUS_IN_TIME: Previous in Time • NEAREST_IN_TIME: Nearest in Time • NEAREST_IN_DISTANCE: Nearest in Distance • NEAREST_IN_DISTANCE_WITHIN: Nearest in Distance Within Time • USE_LAST_METHOD: Use Last Method The default value is PREVIOUS_IN_TIME. | FALSE | ||
--heave-source | Type of heave to be applied during merge. • HEAVE: Realtime - Original heave data will be used. • DELAYED_HEAVE: Delayed - Delayed heave data will be used. The default value is HEAVE. | FALSE | ||
--smooth-sensor | If set, applies smoothing coefficients to the specified data. • HEAVE: Heave - Smooths the heave data. • PITCH: Pitch - Smooths the pitch data. • ROLL: Roll - Smooths the roll data. • DELTA_DRAFT: Delta draft - Smooths the delta draft/subsea depth data. | TRUE | ||
Algorithm = CARIS Options | ||||
--ssp | If set, surface sound speed (SSP) is not used even when available. | FALSE | ||
--svc-line | FALSE | |||
Algorithm = KONGSBERG_LIBRARY Options | ||||
N/A | ||||
ProfileSelectionMethod = NEAREST_IN_DISTANCE_WITHIN Options | ||||
--nearest-distance-hours | A number specifying the number of hours for use with the nearest in distance within time profile selection method. The default value is 1. | FALSE | ||
SSP Options | ||||
--resteer-beam-angles | If set, performs an additional recomputation of the steered beam angles based on a new surface sound speed that will be interpolated from the sound velocity profile (compatible systems are listed in the online help). This is only available when the Surface Sound Speed is used. The recorded SSP (known to be incorrect) along with the sound speed interpolated from SVP (assumed to be correct), will be used to compute new beam angle data. Ray-tracing will then proceed without insertion of the SSP into the SVP. Used only if SSP is applied. For compatible systems only. | FALSE | ||
Example
To use this command, refer to the following example.
Example | ||
Objective | To use ray tracing to apply sound velocity profiles for more accurate soundings data. | |
Description | Command Line Syntax | |
The CARIS algorithms will be applied. | --algorithm CARIS | |
The sound velocity file is named sampleSVP.svp and is located at C:\. | --svp-file C:\sampleSVP.svp | |
The sound velocity profile to apply is NEAREST_IN_TIME. | --profile-selection-method NEAREST_IN_TIME | |
Delayed heave data will be applied during sound . | --heave-source DELAYED_HEAVE | |
The heave data will be smoothed. | --smooth-heave | |
The input file is named input.hips and is located at C:\temp\input\. The HIPS file URI filters for the vessel named “sample” and the day 2000-001. | C:\temp\input\. | |
Command Line |
| |
Outcome | The selected HIPS track line data is sound velocity corrected. | |
Extra Notes | N/A | |