Exporting integration analyses
The Sample analysis exporter on the Dataflow window allows you to retain and repeat a configured export analysis. The Sample analysis exporter supports Sv, linear and dB operands. The analysis variables for each data type may be found in the Integration results and the Analysis Domain sections of the Export page of the EV File Properties dialog box, or under the Analysis variables to export section of the Sample integration page of the Exporter Properties dialog box.
Note: The Interval analysis time series operator outputs a specfied analysis variable calculated for a specified interval. The time series may be exported as CSV file via the right-click menu, or via a Measurements - CSV exporter.
Analysis variables must be selected so that they are included in the export file.
- Preparation for integration
- Sample analysis 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
Sv operands support these analysis variables. (see Sv dB sample note) |
dB operands support these analysis variables (see Sample dB note) |
Linear operands support these analysis vaiables (see Sample linear note) |
|
|
|
- The Sv dB mean/min/max selection also calculates: Layer number, Samples in domain, Good samples, No data samples, Bad data no data sampes, Bad data empty water samples, Samples below bottom exclusion, and Samples above surface exclusion. An Sv dB statistic that can't be calculated returns 0.
- Sample dB mean/min/max calculations convert from dB to linear and then linear to dB. Statistics that can't be calculated return a no data value of -9.9e+37. The statistic selection also calculates: Layer number, Samples in domain, Good samples, No data samples, Bad data no data sampes, Bad data empty water samples, Samples below bottom exclusion, and Samples above surface exclusion.
- Sample (linear) mean/min/max handle non no-data samples in the linear domain. Statistics that can't be calculated return a no data value of -9.9e+37. The statistic selection also calculates: Layer number, Samples in domain, Good samples, No data samples, Bad data no data sampes, Bad data empty water samples, Samples below bottom exclusion, and Samples above surface exclusion.
Preparation for Sv integration, linear data integration and dB data integration
- For Sv integration, 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.
- For linear integration, a supported linear variable is required as Operand 1 for the exporter.
- For dB integration, a supported dB variable is required as Operand 1 for the exporter.
- The global settings on the Export page of the EV File Properties dialog box are applied, unless the Exporter is configured to override the Export page global settings.
- A cells export requires grid settings to be defined. These are typically specified using the Show time/distance grid and Show depth/range/line-referenced grid settings on the Grid page of the Variable Properties dialog box of the variable intended as Operand 1. Some exporter objects allow these grid settings to be overridden with exporter-specific grid settings on the Sample Integration page of the Exporter Properties dialog box.
- Settings on the Analysis page of the variable intended for Operand 1 may affect the export.
- Settings on the Regions 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.
Sample integration export
Sample 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:
- Selected Export variables
- Transect_ID
- Transect_name
- Transect_date_S
- Transect_time_S
- Transect_date_E
- Transect_time_E
- Transect_notes
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 Sample analysis exporter
- Open (or click to bring into focus) a supported Sv echogram or linear variable echogram or dB variable echogram.
- On the Echogram menu, select Export, New Analysis Exporter ...
- On the New Exporter dialog box, select Sample analysis
- Configure the settings on the Sample 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 regions export are:
- 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.
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 defined using grid settings. These are typically configured on the Grid page of the Variable Properties dialog box of the Sv variable used as Operand 1, but may also be defined using exporter-specific grid settings from the Sample Integration page of the Exporter Properties dialog box.
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.
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.
- Cells are defined using grid settings. These are typically configured on the Grid page of the Variable Properties dialog box of the Sv variable used as Operand 1, but may also be defined using exporter-specific grid settings from the Sample Integration page of the Exporter Properties dialog box.
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 Sample analysis to drag and drop it onto the Dataflow window.
- Right-click the Sample analysis object, select Exporter Properties.
- Specify Operand 1.
- Configure the settings on the Sample analysis 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 Sample analysis 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.
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.
See also
About analysis variables
About interval and layer values in export files
Cell Integration dialog box
Exporting cell analyses
Exporting regions
Integrating cells
Integrating regions
Notes about schools detection
School detection module algorithms
Output Empty Cells
Special Export Values
Interval analysis