Exporting integration analyses

Preparation
Sv integration exporter

Integration by cells
Integration by regions
Integration by transects
Integration by regions by cells

Single instance: selected region by cells integration export
Integration analyses from scenes

Integration by regions

See also

Preparation

A supported Sv variable is required as Operand 1 for the exporter. For pulse compressed complex Sv variables, the wideband Sv integration variables ABC_f, NASC_f and Sv_f_mean are optional output variables.
The global setting under Analysis variables to export, Output format, configures the empty cell handling on the Export page of the EV File Properties dialog box.
An exporter object on the Dataflow window can be configured to override the Export page global settings.
A cells export requires the specification of the Show time/distance grid and Show depth/range/line-referenced grid on the Grid page of the Variable Properties dialog box of the variable intended as Operand 1.
Settings on the Analysis page of the variable intended for Operand 1 may affect the export.
A region class export requires the regions to be defined and the region class type set to analysis (use the Region Browser dialog box). Ensure the region classes for your export are visible on the Regions page of the Variable Properties of the variable intended for Operand 1.
Define transects in the assigned transect group for the echogram. An export applies to the transect segments (in an assigned transect group) that overlap the Sv variable intended as Operand 1.

Sv integration export

The Sv integration exporter on the Dataflow window allows you to retain and repeat a configured export analysis.

Sv integration: cells export, regions export, transects export, regions by cells export

The export is constrained to regions or cells overlapping with any transects in an assigned transect group. Refer to Transects and export analyses for more details. Overlapping regions are treated independently.

Further notes: Regions

See Exporting integrations from scenes for integrating multibeam data by regions.

Integration by cells is available for a selected region via the right-click menu Export region, Integration by Cells.

Further notes: Transects

The file includes these variables:

Further notes: Regions by cells

The analysis variables PRC_NASC and PRC_ABC will be calculated for each region-cell intersection in addition to other variables. If regions do not overlap then these variables will give the ABC and NASC for the cell due to the samples in the region-cell intersection. These variables are additive and if a cell is subdivided exactly into a number of regions then the sum of the PRC_NASC (or PRC_ABC) will be equal to the cell NASC (or cell ABC). Alternatively the NASC (or ABC) for those parts of the cell not in regions can be determined by subtracting the sum of PRC_NASC (or PRC_ABC) over all regions-cell intersections in the cell from the NASC (or ABC) for the entire cell. These variables can thus be used to apportion backscattered energy between species or species assemblages using Region classes.

When integrating regions-by-cells, the NASC, ABC, Height_mean and Thickness_mean are not output even if selected on the Export page of the EV File Properties dialog box as they are not correct for region-cell intersections where bad data or bottom regions exist in the cell and are disjointed. Usually, PRC_NASC or PRC_ABC rather than NASC (or ABC) is utilized for these regions (and compared to NASC (or ABC) for the entire cell) so this is unlikely to be a problem.

The export outputs no biomass results for empty cells - the Species_name is blank and the remaining optional and automatically exported biomass analysis variable values are assigned the special export value of -9999. Prior to Echoview 16, invalid biomass values may have been output for empty cells.

To create and configure an Sv integration exporter

Open (or click to bring into focus) a supported Sv echogram.
On the Echogram menu, select Export, New Analysis Exporter ...
On the New Exporter dialog box, select Sv integration and click OK.
Configure the settings on the Sv integration page. The Name and notes page settings allow the customization of the export object name and a place to add text information.

regions

Analysis domain: Regions.
Specified Region classes.
Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog overrides the global values on the Export page of the EV File Properties dialog box. For further information see Preparation 2.

The key settings for a cells export are:
- Analysis domain: Cells
- Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog overrides the global values on the Export page of the EV File Properties dialog box. For further information see Preparation 2.
- Cells are configured on the Grid page of the Variable Properties dialog box of the Sv variable used as Operand 1.
The key settings for a transects export are:
- Analysis domain: Transects
- Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog overrides the global values on the Export page of the EV File Properties dialog box. For further information see Preparation 2.
The key setting for a regions by cells export are:
- Analysis domain: Regions by cells.
- Specified Region classes.
- Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog overrides the global values on the Export page of the EV File Properties dialog box. For further information see Preparation 2.
- Cells are configured on the Grid page of the Variable Properties dialog box of the single targets variable used as Operand 1.
Output section: For all the analysis domains (above), the Output section works in the same way as the Analysis variables to export section. Select Override the output settings specified within the EV File Properties dialog to configure exporter-specific output settings for Empty cells handling, Biomass units and file format. When the Override setting is cleared, the section shows the global output settings from the EV File Properties as a read-only preview.

Click OK.
- OR -
On the Dataflow Toolbox, under the Exporters section, select Sv integration to drag and drop it onto the Dataflow window.
Right-click the Sv integration object, select Exporter Properties.
Specify Operand 1.
Configure the settings on the Sv integration page. See 'The key settings' for this type of export, in this section.
Click OK.

To output an export file

On the Dataflow window, double-click the Sv integration exporter object.
Specify the file name and file path.
Click Save.

Single instance: selected region by cells integration

Select a region on a gridded Sv echogram, right-click, and on the Shortcut menu, select Export Region, Integration by Cells.
Specify the file name and file path.
Click Save.

Note: The output for this region by cells export from Sv pulse compressed wideband data only includes Sv_f_mean when it is selected as an export variable.

Integration analyses from scenes

This export applies to multibeam data.

Before exporting integration analyses from a scene you must associate an Sv variable with the scene and choose an algorithm. Visit the Analysis page of the Scene properties dialog box to define these settings. The default setting is None which will result in an export not containing any integration results. You can export integrations from scenes by regions only.

File format *.csv

Integration by regions

You can export 3D region integration variables for one or more 3D region(s) that are displayed in the scene you are currently viewing. The data are written to a .csv file.

To export an integration analysis for 3D region(s) that are displayed in the scene you are currently viewing:

On the Scene menu, point to Export, and then click Analysis by Regions.

You can display the integration results for a 3D region without first exporting them using the 3D Region integration results dialog box.