Exporting wideband frequency response data

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.

TS wideband frequency response data associated with single targets or Sv wideband frequency response data

The TS export uses single targets to provide ping and center sample calculation parameters for sample data in specified TS pulse compressed variables.

To export wideband frequency response data for a selection or region:

  1. Display a Single target detection - wideband echogram or a Sv pulse compressed wideband pings echogram.
  2. Make a selection or select a region.
  3. On the Shortcut menu (right-click), select Export Selection, Wideband Frequency Response
  4. -OR-

  5. On the Shortcut menu (right-click), select Export Region, Wideband Frequency Response.

  6. To open the Export Wideband Frequency Response dialog box.

  7. Configure the export by specifying the Variables, output type, calculation settings and Window size.
  8. Click OK to open the save file dialog box.
  9. Navigate to a destination folder and enter a File name for the file(s).
  10. Click Save.

Notes:

  • COM support is available for a wideband frequency response export for a region.
  • An echogram export from a Single target detection - wideband variable is available under Echogram menu, Export, Wideband Frequency Response. Such an export can take a long time and the data file can be very large.
  • An echogram export from a Single target detection - wideband variable is available under Echogram menu, Export, Analysis by Regions, Wideband Frequency Response. This export is useful for fish tracks detected on single target detection - wideband echograms.
  • 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.

Export by regions

This export is available to a Single target detection - wideband echogram or a Sv pulse compressed wideband pings echogram with regions.

  1. Display a Single target detection - wideband echogram or a Sv pulse compressed wideband pings echogram.
  2. On the menu, navigate to Echogram, Export, Analysis by regions and click Wideband Frequency Response... to open the Export Wideband Frequency Response by Regions - Select Classes dialog box.
  3. Choose the region class(es) of interest, then click Export...
  4. Select wideband frequency response variables and response settings. Click OK.
  5. Navigate to a destination folder and enter a File name for the file(s).
  6. Click Save.

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:

  • Frequency in kHz.
  • Values of the wideband frequency response for [Interval_index, Ping_index] or [Target_index, Ping_index]. When Apply beam compensation is selected, exported values are compensated TS.
  • Variable_index.
  • Variable_name.

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:

  • Frequency in kHz.
  • Values of the wideband frequency response for [Averaged_intervals, Ping_index] or [Averaged_targets, Ping_index]. Column fields may include:
    • Average_response
    • Minimum_response and Maximum_response
  • When Apply beam compensation is selected, exported values are compensated TS.
  • Variable_index.
  • Variable_name.

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.

 
Minimum_response
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.

 
Minimum_response
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
COM support