About variables

Echoview utilizes variables to store, manipulate and display data from an echosounder, a file or another variable. Each variable contains time-series measurements from a single data type.

There Raw, virtual and editable variables which can also be distinguished by their Variable class.

Raw, virtual and editable variables
Variable classes
Interacting with variables

Creating and deleting

Raw variables
Virtual or editable variables

Editing
Naming

Reserved characters
File name illegal characters

Displaying

Raw, virtual and editable variables

Raw	Echoview derives these from your input data files (such as from the echosounder¹). It does not modify the data file. Raw variables are typically at the root of your workflow.
Virtual	Echoview derives these from operators.
Editable	These are Editable lines and Bottom points variables. You can modify the data samples in editable variables (refer to Editing below).
¹For example, a data file from an echosounder may contain the transmitted and received properties of pings, and the geographic location of a ship at the ping broadcast time. From this, Echoview would derive one or more raw variables, such as a Sv variable, TS variable and a position variable.

Variable class

Variables are divided into the following classes.

Acoustic	Measurements from the transmitted and received properties of a ping. The data type of an acoustic variable may not be same as the type of data stored in a data file².
Attitude	Measurements associated with the heading, roll, pitch and yaw (currently unsupported) of a platform.
Distance	Measurements of the distance traveled by a platform relative to some point.
Geopoint	Latitude, longitude and altitude measurements. Echoview only supports bottom points variables of this class.
Length	Contains length data measurements.
Line	Time and depth coordinates, or time and range coordinates for sounder-detected bottom raw lines.
Media	Contains image or video data.
Position	Measurements associated with the geographic location of a platform. Echoview currently supports GPS fixes and heave variables.
Speed	Contains speed data measurements.
²For example, a data file may contain voltage measurement from an echosounder. Echoview might derive an acoustic data type Sv variable from these measurements.

Interacting with variables

Echoview variables exist in EV files.

Use the Dataflow window to interact with the different kinds of variables, or use the Filesets window to investigate raw variables. Right-click on a variable to open the shortcut menu and list the available options.

You can also interact with variables via the Echoview command interface or with COM scripts (refer to About automating Echoview).

Creating and deleting

Raw variables

Echoview creates raw variables when you load data into an EV file.

You cannot delete Echoview raw variables.

Raw variable names

Echoview automatically derives the raw variable names, depending on the source of the data.

Refer to these pages for the syntax Echoview uses in each case.

Virtual or editable variables

Refer to Creating and deleting virtual variables.

Virtual variable and editable variable names

When you create a new virtual or editable variable, Echoview automatically gives it a name appended with an index.

Starting from index 1, Echoview increases this index for new variables with the same name. The algorithm does not skip numbers in the index sequence.

Editing

You can only modify the data samples in Editable lines and Bottom points variables.

Refer to Creating, editing, renaming and deleting lines and Bottom classification analysis options.

Naming

Each variable must have a unique name. Echoview provides International character support for variable names.

To rename a variable, select it in the Dataflow window. Then click on its name or press F2.

Names are case insensitive, and blank space insensitive. See also: General variable name-uniqueness notes.

Reserved characters

Names cannot contain these reserved characters or words.

[tab]
*
|
,
"
CON
PRN
AUX
NUL
default
none
COM[0...9]
LPT[0...9]

File name illegal characters

Variable names cannot be a combination of these file name illegal characters.

\ / : ? < >

Displaying

To inspect the data of that variable, depending on the Variable class, you can open its