CARIS BASE Editor : CZMIL : CZMIL Module Commands : Generate Grid using CUBE : CUBE Advanced Options
 

CUBE Advanced Options

The Advanced Options dialog box is launched from the CUBE Configuration field of the Generate Grid using CUBE process model. This dialog box displays the detailed configuration settings that will be applied to the data when creating the CUBE surface. These settings are populated from the CUBEparams.xml file, the location of which is set using Tools > Options > Files and Folders. The default location is C:\ProgramData\CARIS\<app>\<version>/system/CUBEParams.xml.

A custom configuration file can be specified in Tools > Options to apply custom CUBE configuration settings. The settings in the file are populated in the dialog box. If a custom file is used, it must use the same syntax and structure as the CUBEparams.xml file.

Custom configuration settings can also be saved to the default file by changing the settings in the dialog box. If the configuration settings are adjusted in the dialog box, the changes will apply to the configuration set currently selected in the Configuration drop-down list. Clicking OK after making changes will prompt the user to save the changes to the CUBEParams.xml file in use.

Interface

The following options are available in the Advanced CUBE Advanced Options dialog box.

Option

Description

Template file

The name and location of the file containing the values for the various CUBE configurations.

1. Click the browse button (...) to launch the Select CUBE Parameters Definition dialog box.

2. Navigate to the relelvant file and click Open.

Configuration

The sets of configuration values available for CUBE creation. The default options include Deep, Default and Shallow.

Deep: This configuration is intended to be used in areas where small features are not likely (shifting sand shoals), not important (steep grades and deep water), or separately located with side scan. This parameter set corresponds with NOAA's 2006 Complete gridding standard.

Default: This is the default set of configuration values for the application.

Shallow: This configuration defines the parameters for the CUBE algorithm and are intended to be used in areas of critical under-keel clearance, in areas with numerous small features, and multibeam that can stand on its own without feature-by-feature side scan correlation. This parameter set corresponds to NOAA's 2006 Object Detection gridding requirements.

<New>: This option is used to create a new set of configuration values. When selected, the New CUBE Configuration dialog box is displayed to enter a name for the new set of values. The new configuration will be added to the list of available configurations. The values selected for the new configuration will be saved to the current configuration file, CUBEparams.xml by default.

Comment

Displays a short description for the currently selected configuration. Additional text can be added as needed.

Surface Creation

Estimate Offset

The threshold for significant offset from current estimate to warrant the creation of a new hypothesis. The value must be between 0.1 and 10.0.

Capture Distance Scale

A scale on predicted or estimated depth indicating the distance from a sounding in which data will be accepted. The value is a percentage of depth used to limit the radius of influence a sounding may have on the grid. The value must be between 1.00 and 100.00.

Capture Distance Minimum

The minimum value (in metres) on predicted or estimated depth for how far out to accept data. This value is used in conjunction with Capture Distance Scale to limit the radius of influence of a sounding. The value must be between 0.0 and 100.00.

Horizontal Error Scalar

The value used to scale the horizontal error of each sounding when used in the radius of influence computation. The value must be between 0.0 and 10.00.

Disambiguation

Density Strength Limit

The strength value used to switch from the 'density' disambiguation method to the 'locale' version when using the density & locale algorithm. The value must be between 0.00 and 5.00.

Locale Strength Limit

The maximum strength value allowed as part of the mean in the locale algorithm. The value must be between 0.00 and 5.00.

Locale Search Radius

The radius of the search when computing the trimmed mean. The values are in pixels and must be greater than zero. The original system default value is 1.

Null Hypothesis test

A flag used to control the application of the NULL hypothesis test. Click the check box to enable the options for this test.

Minimum Number of Neighbours

During the Null Hypothesis test, this controls the minimum number of neighbours that a node must have in order to be considered for the Standard Deviation Ratio test. If the node has less than the specified number, it is automatically marked as 'Null'. The value must be between 2 and 8

Standard Deviation Ratio

During the Null Hypothesis test, this represents the cut-off limit for the Standard Deviation Ratio, including the node in question to the standard deviation of the qualified neighbouring nodes. If the computed ratio exceeds the specified value, the node is marked as 'Null'. The value must be between 0.0 and 10.0.

Neighbour Strength Maximum

The maximum strength value that is allowed to be considered as part of the standard deviation computations in the NULL hypothesis test. The value must be between 0.00 and 5.00.