Multibeam Survey data commands

Name

seafloor --- The shell command interface for some functions in the Seafloor module

Syntax

Description

Programmatically perform some of the functionality available in the Seafloor project.

Arguments

contour [increment value ] [start startvalue increment stopvalue] [values value1 value2 value3 ... ] 

Create contours from the active structured points dataset (DTM). The result contour dataset will be the active dataset after processing.

increment value

Specify the contour levels increment for contouring the grid.

start startvalue increment stopvalue

Specify the startvalue for the first contour level and the stopvalue for the last contour level. The increment is the change in the depth value between the contour levels.

values value1 value2 value3 ...

Specify the actual contour levels to create. Any value(s) can be specified.

edit

Open the Point Cloud Editor dialog. The command has no arguments. The command is similar to the Gecap menubar entry Tools > Point Cloud > Point Cloud Editor. 

execute <system command>

Execute any operating system command. Note that the command often must be specified with the full path to the command. Can be used to execute scripts from Geocap. The command is similar to the Tcl command exec, exept that all the output messages from the seafloor execute  command will be printed in the message window.

flags

Open the Point Flag Visibilty Filter dialog. The command has no arguments. The command is similar to the Gecap menubar entry Tools > Point Cloud > Point Flag Visibilty Filter.

import [path filepath] [all]

Import Multibeam Sonar Data to a folder of type Multibeam. If no path argument is specified, the file Multibeam files dialog will be activated for selecting the input files.

path filepath

Specify the full path to the multibeam survey file. Only one filepath can be specified after the path argument, but several path arguments can be specified, if wanted.

all 

Read all points an do not apply the option Filter zero depth values.

pingbeams [index value] [nbeams value]

Create swath of pings one ping in a multibeam survey line. The command will create the dataset in a memory location named ping. To display the points, enter the command mlo ping, and then the poi command. The command is useful to show the geometry of the multibeam swath.

index value

Specify the index for the ping to create the points from. The value is from 1 to number of pings.

nbeams value

Number of beams to display in the swath. The value is from 1 to number of beams.The default value is 15.

pingpoints [swath] [range] [index value]

Create xyz points from one ping in a multibeam survey line. The command will create the dataset in a memory location named ping. To display the points, enter the command mlo ping, and then the poi command. The command is useful any show difference in the calculation of the multibeam points.

index value

Specify the index for the ping to create the points from. The value is from 1 to number of pings.

swath

Create the points from the swath data (the across, along and depth values from the datagram). This is the default option.

range

Create the points from the range data, using the beam range, sound velocity and motion sensors etc.

profile

Open the Cross section window. The command has no arguments. The command is similar to the Gecap menubar entry Windows > New > Cross Section Window. 

refgrid [increment value] [radius value]

Create a reference grid from the active points dataset. The actual window must be set in advance. The result grid dataset will be the active dataset after processing.

increment value

Specify increment for the grid cell size. Default value is 100.

radius value

Specify search radius for the distribution of points. Default value is 500.

wagridding  [increment value ] [radius value] [weightfunction function]

Create a grid (DTM) from the the active dataset using the Weighted Average gridding algorithm. The actual window must be set in advance The result grid dataset will be the active dataset after processing.

increment value

Specify increments for the grid cell size. Default value is 100.

radius value

Specify search radius in number of grid cells. Default value is 2.The value can be set to 0.

weightfunction function

Select one of the functions: constant (1.0), linear (radius-distance)/radius), square ((radius-distance)/radius)**2), cubic ((radius-distance)/radius)**3), cosinus ((cos(distance/radius)+1)/2)), distance (1/distance), distance_square (1/distance**2). The functions distance and distance_square are independent of the specified search radius.

See also