CARIS Batch Utility : HIPS Processes : Compute HIPS TPU
 

Compute HIPS TPU

Description

The ComputeHIPSTPU process calculates a total depth and position uncertainty for all soundings from a combination of all individual error sources via the Total Propagated Uncertainty (TPU) model.

Updates

One or more HIPS track lines.

Outputs

Updated HIPS track line.

Command Line Syntax

carisbatch --run ComputeHIPSTPU [options] <updates>

Options

The following table describes the parameters available for this process.

Parameter

 

Long

Short

Description

Can Repeat

Notes

 

--tide-measured

A number specifying the error value for the tide station. It is equivalent to the standard deviation of the tide gauge measurements. The value is Ignored if tide source is real-time.

The default value is 0.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd and yd.

FALSE

--tide-zoning

A number specifying the value for the vertical uncertainty in the range calculation for a tide zone file.

The default value is 0.

HIPS does not model the TPU for the tide zone. Instead a single user-defined value may be used here.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd and yd.

FALSE

--sv-measured

A number specifying the value for the uncertainty of inaccuracies in SVP measurements.

The default value is 0.

Supported units: ft/s, km/h, kn, m/s, mi/h, usft/s and usmi/h.

FALSE

--sv-surface

A number specifying the surface offset value used to account for errors in surface sound speed measurements that alter the beam angle. (This parameter is only applicable to systems that require accurate surface sound speed measurements.)

The default value is 0.

Supported units: ft/s, km/h, kn, m/s, mi/h, usft/s and usmi/h.

FALSE

--sweep-max-heave

A number specifying the maximum uncertainty value for the estimated observed heave of the transducer boom.

The default value is 0.

Supported units: cable, ch, cm, fm, ft, in, inm, km, m, mi, mm, nm, usfm, usft, usmi, usnm, usyd and yd.

FALSE

--sweep-max-pitch

A number specifying the maximum uncertainty value for the estimated observed pitch of the transducer boom.

The default value is 0.

Supported units: deg and rad.

FALSE

--sweep-max-roll

A number specifying the maximum uncertainty value for the estimated observed roll of the transducer boom.

The default value is 0.

Supported units: deg and rad.

FALSE

--source-sonar

Source of the uncertainty values for the sonar.

VESSEL: Use the static model value from the vessel configuration.

REALTIME: Use the stored real-time value.

The default value is VESSEL.

FALSE

--source-navigation

Source of the uncertainty values for the navigation.

VESSEL: Use the static model value from the vessel configuration.

REALTIME: Use the stored real-time value.

The default value is VESSEL.

FALSE

--source-gyro

Source of the uncertainty values for the gyro.

VESSEL: Use the static model value from the vessel configuration

REALTIME: Use the stored real-time value.

The default value is VESSEL.

FALSE

--source-pitch

Source of the uncertainty values for the pitch.

VESSEL: Use the static model value from the vessel configuration.

REALTIME: Use the stored real-time value.

The default value is VESSEL.

FALSE

--source-roll

Source of the uncertainty values for the roll.

VESSEL: Use the static model value from the vessel configuration.

REALTIME: Use the stored real-time value.

The default value is VESSEL.

FALSE

--source-heave

Source of the uncertainty values for the heave.

VESSEL: Use the static model value from the vessel configuration.

HEAVE: Use the stored real-time heave value.

DELAYED: Use the stored real-time delayed heave value.

The default value is VESSEL.

FALSE

--source-tide

Source of the uncertainty values for the tide.

STATIC: Use a static value - comes from the dialog.

REALTIME: Use the stored real-time value - can be created by user control when loading tide.

The default value is STATIC.

FALSE

Example

To use this command, refer to the following example.

Example

Objective

To calculate the Total Propagated Uncertainty (TPU) in HIPS track line data.

Description

Command Line Syntax

The error value for the tide station is 2.

--tide-measured 0.1m

The value for vertical uncertainty in the tide zone is set to 0.1m

--tide-zoning 0.1m

The surface offset applied is 0.1m/s.

--sv-surface 0.1m/s

The stored REALTIME value is used as source for gyro.

--source-sonar REALTIME

The updated file is named input.hips and is located at C:\temp\input. The HIPS file URI filters for the vessel named “sample” and day 2000-001.

file:///C:/temp/input/input.hips?Vessel=sample;Day=2000-001.\

Command Line

carisbatch --run ComputeHIPSTPU --tide-measured 0.1m --tide-zoning 0.1m --sv-measured 0.1m/s --sv-surface 0.1m/s --source-sonar REALTIME file:///C:/temp/input/input.hips?Vessel=sample;Day=2000-001.

Outcome

The line data for day 2000-001is updated by applying total depth and position uncertainty.

Extra Notes

N/A