Exporting fish track analyses

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

Preparation
Fish track analysis by regions
Fish track analysis by cells
Single target export file format (*.csv)
See also

Preparation

If you intend to apply fish track detection to data in a Single target export file (*.target.csv) that is subsequently added to a fileset, ensure that the Output empty single target pings option is selected before the file is exported. Otherwise, when Echoview reads the *.target.csv file and recalculates the ping numbers, pings which did not contain any single targets are skipped, which has implications for the 'Maximum gap between single targets' and 'Minimum number of pings in tracks' fish tracking settings.
Prior to fish track detection, define the region class for the export and set the region type to analysis (use the Region Browser dialog box). Fish tracks may also be created from manually specified single targets. For further information refer to About fish track regions.
The exporter requires an operand with a single targets data type. The single targets echogram must contain fish tracks that are read from a data file or are output by a fish track detection.
Settings on the Analysis page of the Variable Properties dialog box may affect your results.
For a successful fish track analysis by cells export, specify the Display and analysis grid settings of the Grid page of the Variable Properties dialog box of the variable intended as Operand 1 for the exporter.
Ensure the region classes for your export are visible on the Regions page of the variable intended as Operand 1 for the exporter.
The Export page Analysis variables to export. Output and Format settings on the EV File Properties dialog box may affect the content output to the results file. An exporter object on the Dataflow window can be configured to override the Export page global settings.
1. Global settings: Analysis variables to export and the Output format on the Export page of the EV File Properties dialog box.

Fish track analysis: regions export, cells export

The regions, or the cells 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.

To be counted in a cell, a fish track's end point must lie within the cell. For more information refer to About fish track regions - Inclusion in cells and Output empty cells - For fish track exports.

To create and configure the Fish track analysis exporter object

Open (or click to bring into focus) the single targets echogram that contains fish tracks.
On the Echogram menu, select Export, New Analysis Exporter ...
On the New Exporter dialog box, select Fish track analysis and click OK.
Configure the settings on the Fish Track Analysis page. The Name and notes page settings allow the customization of the export object name and a place to add text information.
The key settings for a by regions export are:
- Analysis domain: Regions.
- Specified Region classes.
- Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog box lets you choose exporter-specific analysis variables. When this checkbox is cleared, the exporter uses the global settings defined on the Export page of the EV File Properties dialog. The controls are disabled but still display the global settings so you can preview what will be used during export.

The key settings for a by cells export are:
- Analysis domain: Cells.
- Specified Region classes.
- Analysis variables to export: Override the analysis variables specified within the EV File Properties dialog lets you choose exporter-specific analysis variables. When this checkbox is cleared, the exporter uses the global settings defined on the Export page of the EV File Properties dialog. The controls are disabled but still display the global settings so you can preview what will be used during export.
- 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 Fish track analysis to drag and drop it onto the Dataflow window.
Right-click the Fish track analysis object, select Exporter Properties.
Specify Operand 1.
Configure the settings on the Fish Track Analysis page. See 'The key settings' for this type of export, in this section.
Click OK.

To output an export file

Double-click the Fish track analysis exporter object.
Specify the file name and file path.
Click Save.

Single target export file format (*.csv)

The single target analysis export output is a subset of Single target export file format (*.target.csv) and also includes:

Region_bottom_altitude_max
Region_bottom_altitude_mean
Region_bottom_altitude_min
Region_top_altitude_max
Region_top_altitude_mean
Region_top_altitude_min

Notes:

Invalid fish tracks will be included in fish track analysis exports. Valid values from these regions such as start ping and stop ping will be populated with the correct data while invalid values will be populated with null values.
When a fish track contains at least one single target with no position data, fish track analysis speed/direction analysis variables will output the special export value -9999. Prior to Echoview 16, fish tracks with such single targets may have output invalid values for fish track speed/direction analysis variables.