Exporter Properties dialog box

Exporters allow you to configure a custom export, add notes and be able to repeat/remember an export in Echoview. This dialog box is used to configure settings for individual or multiple data exporters.

Multiple exporters selected

When two or more exporter objects are selected in the Dataflow window, you can right-click the selection and choose Exporter Properties (F8) to open the Multiple Object Properties dialog box.

This provides a streamlined way to apply changes to all selected exporters, simultaneously. Editable fields for Exporters include the Notes page (common to all exporters), plus the property pages specific to each selected exporter type (e.g., Fish track analysis, ICES analysis, etc.).

To edit settings across multiple exporters selected:

  1. On the Dataflow window, select multiple exporters (no need to be of the same export type), on the Shortcut menu (right-click) select Exporter Properties. The Multiple Object Properties dialog box will appear.
  2. Alternatively, use the Objects List to locate and select the desired exporter objects from the Exporters category. Right-click to select Exporter Properties.

Exporter Properties pages

Each exporter type has its own configuration page under the Exporter Properties dialog box. These pages allow you to customize settings specific to the selected exporter and operand(s), as well as apply notes and naming conventions.

Exporter Properties pages include:

Analysis exporters

Analysis exporter objects allow you to export derived analysis results (for example, integrations, distributions, or target statistics) in a variety of formats. They are configured using the Exporter Properties dialog box and can be added to the Dataflow window from the Dataflow Toolbox.

Each analysis exporter supports specific operand types and analysis domains, depending on the analysis method and export format. Operands must be assigned before export settings can be configured. Once configured, exports can be performed manually or scripted using COM or the Command interface.

The following sections describe the Operands page and analysis-specific settings for each exporter type, including Fish track analysis, Frequency distribution analysis, ICES analysis, Single targets analysis, Sv integration analysis, Vegetation analysis, Wideband frequency response, and Wideband frequency response – Single targets.

Fish track analysis exporter

The Fish track analysis exporter manages a Fish track analysis export. Note that the Analysis domain, Cells selection requires values for the Display and analysis grid settings in the operand.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Single targets

Fish Track Analysis page

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Regions
  • Cells

The Region classes to export section enables the selection of region class items.

Analysis variables to export

Select Override the analysis variables specified within the Echoview File Properties dialog to specify analysis variables that are local to this exporter.

  • Unchecked: The exporter uses the analysis variables defined on the Export page of the Echoview File Properties dialog (global settings).
  • Checked: The list below becomes active so you can choose exporter-specific analysis variables that override the global settings.
Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Adjusting Biomass area units affects the Density_number and Density_weight analysis variables.

Format

Select a file format option:

  • Spreadsheet format (single file)
  • Database format (multiple files)

For further information refer to Export page, Output section of the EV File Properties dialog box.

Name and Notes page

Frequency distribution exporter

The Frequency distribution exporter manages a TS Frequency Distribution export for single target data. Note that the Analysis domain, Cells selection requires values for the Display and analysis grid settings in the operand.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Single targets

Frequency Distribution page

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Regions
  • Cells
  • Regions by cells

The Region classes to export section enables the selection of region class items.

Analysis variables to export

Select Override the analysis variables specified within the EV File Properties dialog to specify analysis variables that are local to this exporter.

  • Unchecked: The exporter uses the analysis variables defined on the Export page of the Echoview File Properties dialog (global settings).
  • Checked: The list below becomes active so you can choose exporter-specific analysis variables that override the global settings.
Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Adjusting Biomass area units affects the Density_number and Density_weight analysis variables.

Format

Select a file format option:

  • Spreadsheet format (single file)
  • Database format (multiple files)

For further information refer to Export page, Output section of the EV File Properties dialog box.

Name and Notes page

ICES Analysis exporter

The ICES Analysis exporter manages an ICES CSV export. Note that the Analysis domain, Cells selection requires values for the Display and analysis grid settings in the operand.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Complex Sv
  • Pulse compressed complex Sv
  • Sv

ICES Analysis page

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Cells
  • Region classes by cells

The Region classes to export section enables the selection of region class items.

ICES settings

ICES Settings

Description

Export analysis data type

Specifies the data calculation for the export.

Available calculations include: Mean Sv or NASC or ABC.

Export analysis variables using

Specifies the part of the cell (in the ping dimension) for the export calculation.

Available settings include: Cell start, Cell middle, Cell end.

SA species category

Specifies the study domain of the survey and is available for the Cells analysis domain.

Under an Analysis By Region Classes by Cells export, the SA species category field is assigned as the Echoview region class of the region.

Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Adjusting Biomass area units affects the Density_number and Density_weight analysis variables.

Name and Notes page

Single targets analysis exporter

The Single targets analysis exporter manages a single targets analysis export. Note that the Analysis domain, Cells selections require values for the Display and analysis grid settings in the operand.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Single targets

Single Targets Analysis page

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Regions
  • Cells
  • Transects
  • Regions by cells

The Region classes to export section enables the selection of region class items.

Analysis variables to export

Select Override the analysis variables specified within the EV File Properties dialog to specify analysis variables that are local to this exporter.

  • Unchecked: The exporter uses the analysis variables defined on the Export page of the Echoview File Properties dialog (global settings).
  • Checked: The list below becomes active so you can choose exporter-specific analysis variables that override the global settings.
Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Adjusting Biomass area units affects the Density_number and Density_weight analysis variables.

Format

Select a file format option:

  • Spreadsheet format (single file)
  • Database format (multiple files)

For further information refer to Export page, Output section of the EV File Properties dialog box.

Name and Notes page

Sv integration exporter

The Sv integration exporter manages an integration export. Note that the Analysis domain, Cells selections require values for the Display and analysis grid settings in the operand.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Complex Sv
  • Pulse compressed complex Sv
  • Sv

Sv Integration page

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Regions
  • Cells
  • Transects
  • Regions by cells

The Region classes to export section enables the selection of region class items.

Analysis variables to export

Select Override the analysis variables specified within the EV File Properties dialog to specify analysis variables that are local to this exporter.

  • Unchecked: The exporter uses the analysis variables defined on the Export page of the EV File Properties dialog (global settings).
  • Checked: The list below becomes active so you can choose exporter-specific analysis variables that override the global settings.

Note: Wideband Sv integration variables ABC(f), NASC(f) and Sv (f)_mean are optional analysis variables supported by this exporter.

Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Adjusting Biomass area units affects the Density_number and Density_weight analysis variables.

Format

Select a file format option:

  • Spreadsheet format (single file)
  • Database format (multiple files)

For further information refer to Export page, Output section of the EV File Properties dialog box.

Name and Notes page

Vegetation analysis exporter

The Vegetation analysis exporter manages a vegetation analysis export. This export type analyzes the data of the input operand between a specified vegetation line and bottom line over a given interval.

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

Operand 1

  • Complex power dB
  • Complex Sv
  • Complex TS
  • Power dB
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
  • Unspecified dB

Vegetation Analysis page

Vegetation settings

The Vegetation settings are applied to Operand 1. The vegetation boundary line may be detected by the Threshold offset operator. Other line creation methods can also be used to create a vegetation boundary.

Note: Consider using a Minimum and/or Maximum threshold on the Data page for the analysis.

Vegetation Settings

Description

Vegetation line

A selected line from the Vegetation line list. The line represents a vegetation boundary.

Bottom line

A selected line from the Bottom line list. The line represents a bottom boundary for the vegetation.

Time/ping interval

Specifies the vegetation analysis interval unit:

  • Time
  • Ping number

Time between intervals

Specifies the duration of each vegetation analysis interval when Time is selected for Time/ping interval.

The available time units are minutes, hours, and days. Only the control for the selected time unit is displayed.

Number of pings between intervals

Specifies the number of pings in each vegetation analysis interval when Ping number is selected for Time/ping interval.

Start interval numbering from the first ping

Select this setting to output a vegetation analysis where the interval numbering begins at the first ping.

When the setting is unselected and the analysis interval is time based, the interval numbering starts from the beginning of Unix time.

This setting is disabled when the interval is defined in pings.

Output

Select Override the output settings specified within the EV File Properties dialog to use exporter-specific output settings instead of the global settings defined on the Export page of the EV File Properties dialog.

When this checkbox is cleared, the settings shown in this section reflect the global export settings currently defined in the EV File Properties dialog. The controls remain read-only but allow you to preview what will be used during export.

Select Output empty cells to include or exclude empty cells in the export file. For more information, see Output empty cells.

Name and Notes page

Wideband frequency response exporter

A Wideband frequency response exporter manages a wideband frequency graph analysis export. Multiple operands of data type Pulse compressed complex Sv operands are supported. Such operands are handled as for a Wideband Frequency Response graph specified Sv variable, with Operand 1 used as the Reference. Successful exporter output relies on the same conditions as the equivalent graph export.

Operand 1

Operand N

  • Pulse compressed complex Sv
  • Pulse compressed complex Sv

Wideband Frequency Response page

The export calculates the frequency response for the analysis domain containing the matching pings in selected operands.

Analysis Domain

The Region classes to export section enables the selection of region class items.

Frequency response settings

Average results

Clear Average results to export individual frequency responses for each variable.

Select Average results to export average frequency responses for each variable. Average calculations are evaluated in the linear domain.

Include minimum and maximum

Exports the minimum and maximum frequency response. This setting is available when Average results is selected.

Window size, Window size unit list

The Window size specifies a vertical interval of samples used for frequency response calculations.

The Window size dropdown list specifies the units for the window: Meters, Pulse lengths, Samples.

The frequency response is calculated by evaluating samples within the echogram or region. Echoview evaluates a number of Window size intervals within a ping and selected pings across the echogram or region.

Notes:

Resolution of frequency axis (kHz)

Enter a frequency axis resolution for the export.

Maximum acceptable time difference from reference (seconds)

This setting specifies the allowed time separation for variable pings relative to reference variable pings. Variable pings with times that exceed the acceptable reference ping time separation are not used for export calculations. The time value can be 0.0 to 30.0 seconds.

Name and Notes page

Wideband frequency response - Single targets exporter

A wideband frequency response - Single targets exporter manages a wideband frequency graph analysis export. Multiple operands are supported with Operand 1 specified as a Single targets variable and following operands of the data type Pulse compressed complex TS. Such operands are handled as for a Wideband Frequency Response graph specified TS variable, with Operand 1 used as the Single target mask variable. Successful exporter output relies on the same conditions as the equivalent graph export.

Operand 1

Operand N

  • Single targets
  • Pulse compressed complex TS

Wideband Frequency Response - Single Targets page

The export calculates the frequency response for the analysis domain containing the matching single targets in selected operands.

Analysis Domain

Use the Analysis Domain list to specify an analysis domain.

  • Regions
  • Whole echogram

The Region classes to export section enables the selection of region class items.

Frequency response settngs

Apply beam compensation

Clear Apply beam compensation to output uncompensated TS.

Select Apply beam compensation to output compensated TS.

Average results

Clear Average results to export individual frequency responses for each variable.

Select Average results to export the average the frequency responses for each variable. Average calculations are evaluated in the linear domain.

Include minimum and maximum

Exports the minimum and maximum frequency response. This setting is available when Average results is selected.

Window size, Window size unit list

The Window size specifies a vertical interval of samples used for frequency response calculations.

The Window size dropdown list specifies the units for the window: Meters, Pulse lengths, Samples.

The frequency response is calculated by evaluating samples within the echogram or region. Echoview evaluates a number of Window size intervals within a ping and selected pings across the echogram or region.

Notes:

Resolution of Frequency axis (kHz)

Enter a frequency axis resolution for the export.

Maximum acceptable time difference from reference (seconds)

This setting specifies the allowed time separation for variable pings relative to reference variable pings. Variable pings with times that exceed the acceptable reference ping time separation are not used for export calculations. The time value can be 0.0 to 30.0 seconds.

Name and Notes page

Measurement exporters

Measurement exporter objects allow you to export raw or pre-analysis data in a variety of formats. They are configured using the Exporter Properties dialog box and can be added to the Dataflow window from the Dataflow Toolbox.

Each measurement exporter supports specific types of operands depending on the format and purpose of the export. Operands must be assigned before export settings can be configured. Once configured, exports can be performed manually or scripted using COM or the Command Interface.

Measurements – Complex Data

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves raw complex data values to disk. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Complex power dB
  • Complex Sv
  • Complex TS
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
Measurements – Complex Data page

Set the Export range to define which pings to include in the export:

  • All measurements: Exports all pings from the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.

The dialog box displays the full Range of pings in the operand.

Under File options, enable Split exported files based on size to divide the output into multiple files. Specify a Target file size (MB) to control the size of each exported file.

Name and Notes page

Measurements – CSV

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data as comma-separated values (*.csv), suitable for review or use in spreadsheet software. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Analysis time series
  • Angular position
  • Boolean
  • Calibration time series
  • Color
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Current velocity
  • Custom time series
  • Distance
  • Heading
  • Length
  • Line
  • Linear
  • Matrix angular position
  • Matrix Sv
  • Matrix TS
  • Matrix unspecified dB
  • Multibeam angular position
  • Multibeam boolean
  • Multibeam color
  • Multibeam magnitude
  • Multibeam phase
  • Multibeam Sv
  • Multibeam targets
  • Multibeam TS
  • Multibeam unspecified dB
  • Pitch
  • Position
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Roll
  • Single targets
  • Speed
  • Sv
  • Target length
  • Time series collection
  • Transmission time series
  • Transmission time series collection
  • TS
  • Unspecified dB
  • Unspecified time series
Measurements – CSV page

Set the Export range to define which pings to include in the export:

  • All measurements: Exports all pings from the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.

The dialog box displays the full Range of pings in the operand.

Under File options, enable Split exported files based on size to divide the output into multiple files. Specify a Target file size (MB) to control the split size.

Name and Notes page

Measurements – EVD

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data to Echoview's native binary format (*.evd), which is optimized for compatibility and performance in Echoview workflows. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Angular position
  • Boolean
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Distance
  • Heading
  • Length
  • Line
  • Multibeam angular position
  • Multibeam boolean
  • Multibeam magnitude
  • Multibeam Sv
  • Multibeam TS
  • Multibeam unspecified dB
  • Pitch
  • Position
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Roll
  • Single targets
  • Speed
  • Sv
  • TS
  • Unspecified dB
Measurements – EVD page

Set the Export range to define which pings or time period to include in the export:

  • All measurements: Exports all pings from the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.
  • Time range: Specify a start and end time to restrict the export.

The dialog box displays the full Range of pings in the operands and the Range of time in the operands.

Under File options, set the level of Compression to adjust the balance between sample quality and file size.

You can also enable Split exported files based on size and set a Target file size (MB).

Name and Notes page

Measurements – EVL

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data to Echoview Line (*.evl) format. The EVL format is used to store line features, typically representing seafloor or other tracked elements. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Line
Measurements – EVL page

Set the Export range to define which pings to include in the export:

  • All measurements: Exports data from the full ping range in the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.

The ping range in the operand is displayed under Range of pings in the operand.

Name and Notes page

Measurements – Georeferenced samples

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves georeferenced measurement data to CSV format (*.csv), including position, time, and values. Each exported row corresponds to a sample that includes valid latitude and longitude. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Angular position
  • Boolean
  • Color
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Current velocity
  • Linear
  • Multibeam angular position
  • Multibeam boolean
  • Multibeam color
  • Multibeam magnitude
  • Multibeam phase
  • Multibeam Sv
  • Multibeam TS
  • Multibeam unspecified dB
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
  • Unspecified dB
Measurements – Georeferenced Samples page

Set the Export range to define which pings to include in the export:

  • All measurements: Exports data from the full ping range in the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.

The ping range in the operand is displayed under Range of pings in the operand.

Select the Export domain to restrict the export to a region-based subset of the data. The following options may be available:

  • Entire domain: Export all samples, regardless of region classification.
  • Regions: Restrict export to samples falling within regions assigned to selected region classes.

Under Region classes to export, choose which region classes (for example, Unclassified regions, Region class 1) to include in the export.

Name and Notes page

Measurements – HAC

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data to HAC file format (*.hac), which can be used for interoperability with other acoustic software. Export options include the full measurement range or a specific ping-based range, and optional file size splitting.

Operand 1

  • Angular position
  • Complex angular position
  • Pulse compressed complex angular position
  • Single targets
  • Sv
  • TS
Measurements – HAC page

Set the HAC options for the export:

  • Write compressed tuples: Saves the data using compressed tuple encoding, which reduces file size and follows HAC file format conventions. This may be required for compatibility with specific external tools or processing pipelines.
Name and Notes page

Measurements – ICES SONAR-netCDF4

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data in the ICES SONAR-netCDF4 format (*.nc), based on the ICES SONAR-netCDF4 version 2.0 document for standardized data exchange and archiving of supported single beam data under the Type 5 conversion equation and the split-aperture beam handling. Export options include multiple variable types, and the full measurement range or a specific ping-based or time-based range.

Support details

The exporter supports multiple operands which represent supported variable types: Sv, TS and angular position. Refer to Exporting to ICES SONAR-netCDF4 Format - Single beam Sv, TS, angular position for export instructions.

  • Variables from the same platform are supported. Support includes variables of the same frequency, which have the same number of pings and the same ping geometry, with pings that have the same timestamp matching their ping geometry.
  • Pulse compressed wideband complex data are exported as dB values.
  • Unsupported data notes:
    • Power and multibeam variables.
    • Variables that have an applied sound speed profile.
    • Multiple variables of the same type and same frequency are not supported. For example, 38 kHz and 70 kHz Sv variables are supported; two 38 kHz Sv variables are not supported.

Operand 1

Operand 2

Operand 3

  • Angular position
  • Complex angular position
  • Complex Sv
  • Complex TS
  • Pulse compressed complex angular position
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
  • Angular position
  • Complex angular position
  • Complex Sv
  • Complex TS
  • Pulse compressed complex angular position
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
  • Angular position
  • Complex angular position
  • Complex Sv
  • Complex TS
  • Pulse compressed complex angular position
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
Measurements – ICES SONAR-netCDF4 page

Set the Export range to define which data to include:

  • All measurements: Exports the full range of available pings and time values in the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.
  • Time range: Specify From and To UTC timestamps to export only data within a time window. For further information about how to specify the time and date, refer to Time (valid Ranges from 1970 to 2050).

The Range of pings in the operands and Range of time in the operands are displayed for reference. These values reflect the span of data available for export from the selected operand(s).

Name and Notes page

Measurements – Image

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data as image files (for example, *.png), allowing for visual inspection or integration into reports and presentations. Export options include the full measurement range or a specific ping-based or time-based range, and optional image splitting.

Operand 1

  • Angular position
  • Boolean
  • Color
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Current velocity
  • Linear
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Single targets
  • Sv
  • Target length
  • TS
  • Unspecified dB
Measurements – Image page

Configure the following options to define the exported image output:

  • Horizontal extents:
    • All measurements: Export across the entire ping/time range.
    • Ping range: Specify the From and To ping numbers.
    • Time range: Specify From and To UTC timestamps.
  • Vertical extents:
    • All measurements: Export across the full depth or range extent.
    • Depth: Set From and To depth values (m).
    • Range: Set From and To range values (m).
  • Image splitting:
    • Export as single image: Saves a single continuous image.
    • Split images by ping: Images are split after a specified number of pings (target).
    • Split images by time: Images are split into time segments (hours).
  • Image dimensions:
    • Export one pixel per sample: Each sample corresponds to a single image pixel.
    • Use custom image dimensions: Specify a custom image width and height in pixels.
Name and Notes page

Measurements – MATLAB

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves measurement data to MATLAB .mat files for further analysis and visualization in MATLAB. You can export the full measurement range or a specified ping index range, and optionally split large files.

Operand 1

  • Sv
  • TS
  • Power dB
  • Unspecified dB
  • Multibeam Sv
  • Multibeam TS
  • Multibeam unspecified dB
  • Multibeam magnitude
  • Angular position
  • Complex Sv
  • Complex TS
  • Complex power dB
  • Complex angular position
  • Pulse compressed Sv
  • Pulse compressed TS
  • Pulse compressed power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Pulse compressed complex angular position

Note: Complex export availability depends on the operand:

  • .complex.mat allowed: complex Sv, complex TS, complex power dB, and pulse-compressed complex variants.
  • .mat only: angular position, complex angular position, and multibeam magnitude. If a .complex.mat filename is supplied for these, the export is renamed to .mat with an explanatory message.
  • For non-complex operands (for example, narrowband Sv/TS/power, angular position, multibeam magnitude), the complex option is not offered.
Measurements – MATLAB page

Set the Export range to define which pings to include:

  • All measurements: Exports the full ping range of the operand.
  • Measurement range: Specify From and To ping indices to restrict the export.
Complex exports
  • For operands whose data are inherently complex (see note above), the Save as type list allows .mat or .complex.mat. Either produces matching values to the equivalent menu export.
  • For operands that are not complex, the complex option is not offered. If a file name with .complex.mat is supplied, the export is renamed to .mat and a message explains why.
  • Angular position data are not exported as complex. If a complex extension is requested, it is downgraded to .mat with an explanatory message.
File naming and messages
  • Non-complex data with “.complex.mat” are renamed to .mat with a message: “The MATLAB export file ‘X.complex.mat’ was renamed ‘X.mat’ because it does not contain complex data.”
  • Complex data saved as “.mat” are exported as non-complex values (by choice). This is allowed.
  • Overwriting: If overwriting an existing file, a single confirmation dialog is shown.
  • Remembered type: The exporter remembers the last selected Save as type for subsequent runs and after reopening the file.
  • Switching types: Changing the Save as type toggles the extension of the current file name. Repeated toggles can append “.complex” more than once due to Windows dialog behaviour. You can edit the file name before saving to tidy this if needed.
Name and Notes page

Measurements – Underlying data

The Operands page displays the Export type, the Object description and allows the specification of the Operand(s).

This exporter saves the raw underlying measurement data in a binary (*.raw) format for specialized use. Only data from compatible operand types can be exported. Export options include the full measurement range or a specific ping-based range.

Operand 1

  • Angular position
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Multibeam angular position
  • Multibeam Sv
  • Multibeam TS
  • Multibeam unspecified dB
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Sv
  • TS
  • Unspecified dB
Measurements – Underlying data page

Set the Export range to define which pings to include in the export:

  • All measurements: Exports data from the full ping range in the operand.
  • Measurement range: Specify From and To ping indices to restrict the exported data.
Name and Notes page

Operands

The Operands page is available for all exporter objects. It allows you to select the variable or variables that the exporter will use as input data. The number of available operands depends on the exporter type.

Each exporter type accepts specific variable types (for example, Sv, TS, complex data, pulse compressed data, or angular position data). The list of compatible variable types is documented in the individual exporter sections on this page.

You must assign all required operands before you can configure other settings for an exporter. Operand settings are saved with the EV file and used whenever the exporter object is run.

Name and Notes

Exporter information may include:

Settings

Description

Name

The unique name of the exporter object. You can edit the Name. Echoview assigns a default name when an exporter is created or when Reset is used.

Notes:

  • In Echoview, name-uniqueness affects objects. Existing EV files, that contain objects with the same name, will open and affected objects will be assigned a unique name.
  • Valid names for dataflow objects consist of supported characters. These can include text and symbol character encoding and international characters. Commas, double quotes, the vertical bar and the Tab key press are unsupported characters. Where a name is used as the basis of an export file name, any unsupported file name characters are automatically removed.
  • When using the Multiple Object Properties dialog box, Name is disabled. To assign a new name, edit objects individually.

Dynamic name

Select Dynamic to use a name that updates when an Exporter Property updates. Dynamic names have text that contain property names within braces (curly brackets), that are based on Command interface property names. The Properties Information window displays supported Command interface property names. Suitable property names are those that have numeric or text value. A Dynamic name may be specified through the Console.

When Dynamic is selected, the Name property becomes read-only under the Command interface and the dataflow object.

Example: Dynamic name is Sv integrate for the domain [{AnalysisDomain}] for an Sv Integration analysis exporter object.

Figure 1 shows the exporter object Dynamic name when the Analysis Domain property is specified as Regions.

Figure 2 shows the change in the displayed Dynamic name when Analysis Domain is changed to Transects.

Figure 1.

Figure 2.

Notes:

  • Refer to Console Property option DynamicName.
  • A message is displayed when a dynamic name becomes invalid. Invalid dynamic names may occur when property names are incorrect, or are deprecated, or are not recognised by Echoview. Echoview changes the invalid {property name} to its text form by removing the brace characters.
  • When using the Multiple Object Properties dialog box, Dynamic is disabled. To assign a new name, edit objects individually.

Reset

Resets the name to the default name generated for a new exporter object.

Notes

A text box in which you can enter extra information about the exporter.

See also

About exporter objects