Exporting wideband frequency response data
The Wideband frequency response exporter and Wideband frequency response - Single targets exporter on the Dataflow window allow you to retain and repeat a configured export analysis.
Echoview also offers a single instance wideband frequency response export for a selected region or selection on an echogram.
- Preparation
- Wideband frequency response exporters
- Single instance wideband frequency response export for a selected region or selection on an echogram
- Wideband frequency response data export files (*.csv)
Preparation
Wideband frequency response data can be exported from Echoview to a .csv file. However, note that:
- a single target detection - wideband variable can contain many single targets.
- Sv/TS pulse compressed ping sample data is densely packed.
To minimize the export time and the export file size, you can:
- limit the Single target detection - wideband data by
- using Exclusion lines.
- using a ping subset operator to isolate single target pings of interest.
- limit the size of the selection or region.
- The Wideband frequency response exporter requires a pulse compressed complex Sv variable for Operand 1. Output data is calculated for specified region classes.
- The Wideband frequency response - Single targets exporter requires a single targets variable for Operand 1 and a pulse compressed complex TS variable for Operand 2. Output data is calculated for the whole echogram, or for specified regions classes.
- When exporting a regions analysis, define the regions for the export and set intended region class, region type to analysis (use the Region Browser dialog box).
- Ensure the region classes for your export are visible on the Regions page of the variable intended for Operand 1.
Wideband frequency response exporters
Sv pulse compressed wideband data: regions export
To create and configure the Wideband frequency response exporter object
- Open (or click to bring into focus) the Sv pulse compressed wideband echogram.
- On the Echogram menu, select Export, New Analysis Exporter ...
- On the New Exporter dialog box, select Wideband frequency response and click OK.
- Configure the settings on the Wideband Frequency Response 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:
- Specified Region classes.
- Specified Frequency response settings.
- Click OK.
- - OR -
- On the Dataflow Toolbox, under the Exporters section, select Wideband frequency response to drag and drop it onto the Dataflow window.
- Right-click the Wideband frequency response object, select Exporter Properties.
- Specify Operand 1.
- Configure the settings on the Wideband Frequency Response page. See 'The key settings' for this type of export, in this section.
- Click OK.
To output an export file
- Double-click the Wideband frequency response exporter object.
- Specify the file name and file path.
- Click Save.
Single target data: echogram export, regions export
To create and configure the Wideband frequency response - Single targets exporter object
- Open (or click to bring into focus) the single targets echogram.
- On the Echogram menu, select Export, New Analysis Exporter ...
- On the New Exporter dialog box, select Wideband frequency response - Single targets and click OK.
- On the Operands page, under Operand 2 select a pulse compressed complex TS variable from the list.
- Configure the settings on the Wideband Frequency Response - Single Targets 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 Whole echogram export are:
- Analysis domain: Whole echogram.
- Specify the Frequency response settings.
- The key settings for a Regions export are:
- Analysis domain: Regions
- Specify the Regions classes to export.
- Specify the Frequency response settings.
- Click OK.
- - OR -
- On the Datalow toolbox, under the Exporters section, select Wideband frequency response - Single targets to drag and drop it onto the Dataflow window.
- Right-click the Wideband frequency response - Single targets object, select Exporter Properties.
- Specify Operand 1 and Operand 2.
- Configure the settings on the Wideband frequency response - Single targets page. See 'The key settings' for this type of export, in this section.
- Click OK.
To output an export file
- Double-click the Wideband frequency response - Single targets exporter object.
- Specify the file name and file path.
- Click Save.
Single instance wideband frequency response export for a selected region or selection on an echogram
To export wideband frequency response data for a selection or region:
- Display a Single target detection - wideband echogram or a Sv pulse compressed wideband pings echogram.
- Make a selection or select a region.
- On the Shortcut menu (right-click), select Export Selection, Wideband Frequency Response
- -OR-
- On the Shortcut menu (right-click), select Export Region, Wideband Frequency Response.
- To open the Export Wideband Frequency Response dialog box.
- Configure the export by specifying the variables, output type, calculation settings and window size.
- Click OK, and the Export dialog box opens.
- Navigate to a destination folder and enter a file name.
- Click Save.
Notes:
- COM support is available for a wideband frequency response export for a region.
- An echogram or regions export from a Single target detection - wideband variable is available through the Wideband frequency response - Single targets exporter. The Regions export is useful for fish tracks detected on single target detection - wideband echograms.
- A regions export from an Sv pulse compressed wideband variable is available through the Wideband frequency response exporter.
- Cancel export is available for Wideband Frequency Response exports.
- A Graph data export is available for the frequency response data for a selection/region linked to a Wideband Frequency Response graph. The graph export supports Sv data, TS data and TS data associated with single targets.
- Inherent Fast Fourier calculations may result in the last frequency not (exactly) matching the end frequency of the frequency bandwidth.
- See also Wideband Frequency Response input data assumptions and graph calculations.
Wideband frequency response data export files (*.csv)
These data files, created by the various routes (see above), may record:
- Sv wideband frequency responses
- Sv wideband frequency responses by region
- TS wideband frequency responses
- TS wideband frequency responses associated with single targets, with or without beam compensation
- TS wideband frequency responses associated with single targets of fish track regions or regions, with or without beam compensation
The comma-separated data arrangement of the file uses row and column field names. Columns of data are ordered with respect to frequency rows arranged in variable blocks.
When Averaged is clear, the exported data includes:
|
Variable |
Description |
|
Interval_index |
Identifier for a Sv or TS interval of samples over which the wideband frequency response is calculated. A ping may have more than one Interval_index. Interval_index is an integer with 0 assigned to the top of the selection or region. |
|
Target_index |
Identifier for single target based interval of samples over which the wideband frequency response is calculated. A ping may have more than one Target_index. Target_index is an integer with 0 assigned to the top of the selection or region. |
|
Ping_index_start |
Ping number for the Interval_index or Target_index. Ping numbers are sourced from the Sv or TS variable. |
|
Ping_index |
Ping number for the region. |
|
Ping_date |
Ping date (dd:mm:yyyy) for the Interval_index, Target_index or region. |
|
Ping_time |
Ping time (HH:mm:ss) for the Interval_index, Target_index or region. |
|
Ping_milliseconds |
Ping milliseconds (ppp) for the Interval_index, Target_index or region. |
|
Range |
Range (m) for a Target_index or region. |
|
Range_start |
Start range (m) for the Interval_index. |
|
Range_stop |
Stop range (m) for the Interval_index. |
|
Depth |
Depth (m) for a Target_index or region. |
|
Depth_start |
Start depth (m) for the Interval_index. |
|
Depth_stop |
Stop depth (m) for the Interval_index. |
|
Region_name |
Name of the region. |
|
Frequency, Variable_index data block |
Frequency and Wideband Frequency response values are listed as a block for each Variable_index. The Variable_index is an integer with 0 assigned to the first variable in the specified Variables list. The Variable_name consists of the fileset and variable name. Each frequency row lists:
|
When Average is selected, the exported data includes some fields from the table above, and may include the following fields and data.
|
Variable |
Description |
|
Averaged_intervals |
Number of (SV or TS based) wideband frequency responses used to calculate the average. |
|
Averaged_targets |
Number of (TS, target based) wideband frequency responses used to calculate the average. |
|
Average_response |
Average wideband frequency response for the selection or region as specified by Averaged under Graph Properties or the Export dialog box. |
|
Maximum_response |
The maximum wideband frequency response for the selection or region. This is specified by Show minimum and maximum under Graph Properties or the Export dialog box. |
|
Minimum_response |
The minimum wideband frequency response for the selection or region. This is specified by Show minimum and maximum under Graph Properties or the Export dialog box. |
|
Ping_date_start |
Ping start date (dd:mm:yyyy) for the average. |
|
Ping_date_stop |
Ping stop date (dd:mm:yyyy) for the average. |
|
Ping_index_start |
Ping start for the average. Ping numbers are sourced from the Sv or TS variable. |
|
Ping_index_stop |
Ping stop for the average. Ping numbers are sourced from the Sv or TS variable. |
|
Ping_millisecond_start |
Ping start milliseconds (ppp) for the average. |
|
Ping_millisecond_stop |
Ping stop milliseconds (ppp) for the average. |
|
Ping_time_start |
Ping start time (HH:mm:ss) for the average. |
|
Ping_time_stop |
Ping stop time (HH:mm:ss) for the average. |
|
Range_start |
Average value for Range_start (m) in the region. |
|
Range_stop |
Average value for Range_stop (m) in the region. |
|
Depth_start |
Average value for Depth_start (m) in the region. |
|
Depth_stop |
Average value for Depth_stop (m) in the region. |
|
Region_name |
Name of the region. |
|
Frequency, Variable_index data |
Frequency and Wideband Frequency response values are listed as a block for each Variable_index. The Variable_index is an integer with 0 assigned to the first variable in the specified Variables list. The Variable_name consists of the fileset and variable name. Each frequency row lists:
Note: When the TS calculation is undefined the export value is -9.9e+37. |
Examples
When Averaged is clear.
| Target_index | 0 | 1 | 2 | Variable_index | Variable_name |
| Ping_index | 37 | 37 | 37 | ||
| Ping_date | 31/05/2017 | 31/05/2017 | 31/05/2017 | ||
| Ping_time | 11:06:18 | 11:06:18 | 11:06:18 | ||
| Ping_milliseconds | 64 | 64 | 64 | ||
| Range | 6.920542766 | 7.109967407 | 7.181526922 | ||
| Depth | 6.903459767 | 7.109837593 | 7.172797484 | ||
| 160 | -65.840385 | -67.931756 | -73.3087 | 0 | Fileset1: TS pulse compressed wideband pings T1 |
| 160.183 | -66.14947 | -68.168353 | -74.478456 | 0 | Fileset1: TS pulse compressed wideband pings T1 |
| ... | ... | ... | ... | ... | ... |
| 280 | -22.935454 | -10.225188 | -11.758994 | 1 | Fileset1: TS pulse compressed wideband pings T2 |
| 280.244 | -23.840411 | -10.194937 | -12.33993 | 1 | Fileset1: TS pulse compressed wideband pings T2 |
| ... | ... | ... | ... | ... | ... |
When Average is selected.
|
Average_response | Maximum_response | Variable_index | Variable_name | ||
| Averaged_targets | 3 | 3 | 3 | |||
| Ping_index_start | 37 | 37 | 37 | |||
| Ping_index_stop | 37 | 37 | 37 | |||
| Ping_date_start | 31/05/2017 | 31/05/2017 | 31/05/2017 | |||
| Ping_time_start | 11:06:18 | 11:06:18 | 11:06:18 | |||
| Ping_millisecond_start | 64 | 64 | 64 | |||
| Ping_date_stop | 31/05/2017 | 31/05/2017 | 31/05/2017 | |||
| Ping_time_stop | 11:06:18 | 11:06:18 | 11:06:18 | |||
| Ping_millisecond_stop | 64 | 64 | 64 | |||
| Range_start | 6.920542766 | 6.920542766 | 6.920542766 | |||
| Range_stop | 7.181526922 | 7.181526922 | 7.181526922 | |||
| Depth_start | 6.903459767 | 6.903459767 | 6.903459767 | |||
| Depth_stop | 7.172797484 | 7.172797484 | 7.172797484 | |||
| 160 | -67.407723 | -60.99121 | -57.140616 | 0 | Fileset1: TS pulse compressed wideband pings T1 | |
| 160.183 | -67.875285 | -64.071737 | -61.003876 | 0 | Fileset1: TS pulse compressed wideband pings T1 | |
| ... | ... | ... | ... | ... | ... | |
| 280 | -8.977513 | -5.568913 | -3.581363 | 1 | Fileset1: TS pulse compressed wideband pings T2 | |
| 280.244 | -9.272511 | -5.827907 | -3.919995 | 1 | Fileset1: TS pulse compressed wideband pings T2 | |
| ... | ... | ... | ... | ... | ... |
Single target detection - wideband echogram, Echogram menu, Export, Analysis by Regions, Wideband Frequency Response. Averaged is selected.
|
Average_response | Maximum_response | Variable_index | Variable_name | ||
| Averaged_targets | 3 | 3 | 3 | |||
| Ping_index_start | 0 | 0 | 0 | |||
| Ping_index_stop | 2 | 2 | 2 | |||
| Ping_date_start | 31/05/2017 | 31/05/2017 | 31/05/2017 | |||
| Ping_time_start | 11:05:59 | 11:05:59 | 11:05:59 | |||
| Ping_millisecond_start | 401 | 401 | 401 | |||
| Ping_date_stop | 31/05/2017 | 31/05/2017 | 31/05/2017 | |||
| Ping_time_stop | 11:06:00 | 11:06:00 | 11:06:00 | |||
| Ping_millisecond_stop | 409 | 409 | 409 | |||
| Range_start | 5.40217678 | 5.40217678 | 5.40217678 | |||
| Range_stop | 5.5334279 | 5.5334279 | 5.5334279 | |||
| Depth_start | 5.383401675 | 5.383401675 | 5.383401675 | |||
| Depth_stop | 5.52677483 | 5.52677483 | 5.52677483 | |||
| Region_name | Region 1 | Region 1 | Region 1 | |||
| 160 | -98.160987 | -96.054776 | -94.044945 | 0 | Fileset1: TS pulse compressed wideband pings T1 | |
| 160.183 | -97.876907 | -96.411736 | -94.746864 | 0 | Fileset1: TS pulse compressed wideband pings T1 | |
| ... | ... | ... | ... | ... | ... | |
| 280 | -56.693738 | -41.958994 | -40.191797 | 1 | Fileset1: TS pulse compressed wideband pings T2 | |
| 280.244 | -59.33691 | -41.539726 | -39.727211 | 1 | Fileset1: TS pulse compressed wideband pings T2 | |
| ... | ... | ... | ... | ... | ... |
See also
About transmitted pulse
Single target detection - wideband
Wideband frequency response graph
Wideband integration analysis variables
COM support