CARIS HIPS and SIPS : CARIS Batch Utility : HIPS Processes : Sound Velocity Correct HIPS (Kongsberg)
 

Sound Velocity Correct HIPS (Kongsberg)

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 --algorithm KONGSBERG_LIBRARY --svp-file C:\sampleSVP.svp --profile-selection-method NEAREST_IN_DISTANCE_WITHIN --nearest-distance-hours 1 file:///C:/temp/input/input.hips?Vessel=sample

User Interface Command

Sound Velocity Correction (using Kongsberg Library)

Options

The following table describes the parameters available for this process.

Parameter

 

Long

Short key

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 re-computation 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

carisbatch --run SoundVelocityCorrectHIPS --algorithm CARIS --svp-file C:\sampleSVP.svp --profile-selection-method NEAREST_IN_TIME file:///C:/temp/input/input.hips?Vessel=sample;Day=2000-001

Outcome

The selected HIPS track line data is sound velocity corrected.

Extra Notes

N/A