Versions Compared

Old Version 4

changes.mady.by.user Ben Biffard

Saved on

compared with

New Version Current

changes.mady.by.user Spencer Plovie

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This data product is extremely data intensive. The raw files, produced every three hours, contain up to 11 GB of data when uncompressed. Processing this data takes time. Data products are pre-processed for quick retrieval. However, the pre-processing may not be up to date, in that case, data products will be generated on-the-fly, which can take 10-40 minutes per 3 hour file.

Oceans 3.0 API filter: dataProductCode=CPDD

Revision History

  • 20131114: Initial product released

...

MAT, PNG and PDF data products are generated for the Plume DOPPLER mode. Content descriptions and example MAT and PNG files are provided below. Detailed information and further concern please refer to Principle Investigator's Investigator’s Website

MAT

MAT file contains two structures: metadata Meta and covis. The metadata structure contains the following information:

  • deviceID: A unique identifier to represent the instrument within the NEPTUNE Canada network.
  • deviceName: A name given to the instrument.
  • deviceCode: A unique string for the instrument which is used to generate data product filenames.
  • deviceCategory: Device category to list under data search ('Echosounder').
  • creationDate:Date and time (using ISO8601 format) that the data product was produced. This is a valuable indicator for comparing to other revisions of the same data product.
  • lat: Obtained at time of deployment.
  • lon: Obtained at time of deployment.
  • depth: Obtained at time of deployment.
  • siteName: Name corresponding to its latitude, longitude, depth position.
  • locationName: The node of the NEPTUNE Canada observatory. Each location contains many sites.
  • deploymentDateFrom: The date of the deployment on which the data was acquired.
  • deploymentDateTo: The date of the end of the deployment on which the data was acquired (may be omitted if still deployed).
  • samplingPeriod: Sampling rate of the instrument in seconds (scalar sensors only).
  • samplingPeriodDateFrom: matlab datenum of the start of the corresponding sample period (scalar sensors only).
  • samplingPeriodDateTo: matlab datenum of the end of the corresponding sample period (scalar sensors only).
  • sensorInfos: Structure containing information on the scalar sensors.
  • observatory: string with observatory name.
  • region: string with region name.

Include Page
MAT file Metadata structure - Complex
MAT file Metadata structure - Complex

The The covis structure contains all the parameter information and the gridded data. Structure covis contains the following structures: type, comments, user, sonar, processing, grid, sweep, ping and burst.

...

  • beamformer: type of beamforming.
    • type: default value is "fast"“fast”.
    • fc: default value is 396000. This parameter does not exist for diffuse mode file.
    • c: default value is 1495. This parameter does not exist for diffuse mode file.
    • fs: default value is 8620.7. This parameter does not exist for diffuse mode file.
    • first_samp: default value is 1. This parameter does not exist for diffuse mode file.
    • last_samp: default value is 3459. This parameter does not exist for diffuse mode file.
    • array_length: default value is 0.4080. This parameter does not exist for diffuse mode file.
    • start_angle: default value is -64. This parameter does not exist for diffuse mode file.
    • end_angle: default value is 64. This parameter does not exist for diffuse mode file.
    • num_beams: default value is 256. This parameter does not exist for diffuse mode file.
    • angle: an array contains 256 float numbers from -1.1170 to 1.1170. This parameter does not exist for diffuse mode file.
    • range: an array contains 865 float numbers from 0.0867 to 75.0042. This parameter does not exist for diffuse mode file.
  • calibrate: type of calibration mode.
    • mode: "VSS" “VSS” for imaging mode file and "TS" “TS” for diffuse mode file.
  • filter: controls the filtering part of the processing.
    • status: default value is "on"“on”.
    • type: default value is "buttorworth"“buttorworth”.
    • bw: default value is 2, which means the bandwidth in Hz will be 2/pulse length.
    • order: filter order. Default value is 4.
    • decimation: default value is 4. The time series will be decimated by this factor in order to speed up processing. This parameter does not exist for diffuse mode file.
  • ping_combination: explains how pings are combined: average or difference.
    • mode: default value is "diff"“diff”, which means a difference of successive pings is used in order to reduce unwanted ground return.
  • bounds: explains value range for processing (Note that it does not affect data collection). This structure does not exist for diffuse mode file.
    • pitch: range of rotator elevations (degrees) over which data is processed.
      • start: default value is 10.
      • stop: default value is 62.
    • heading: heading of the sonar (degrees). There is a physical possibility that this could actually vary during data collection.
      • start: default value is 235.
      • stop: default value is 235.
    • range: distance (meters) out a ping over which to process
      • start: default value is 5.
      • stop: default value is 75.
  • correlation: These parameters are used in the cross-correlation of two complex series
    • window_size
    • window_overlap
    • windthresh
    • nlag

...

  • type: what the values in the grid mean. Default value is "back“back-scatter cross section" section” for imaging mode file, and is "decorrelation intensity" “decorrelation intensity” for diffuse mode file.
  • shape: shape of the grid. Default value is "rectangular"“rectangular”.
  • units: units for the output grids
    • spatial: default value is "meters"“meters”.
    • Value: default value is "1“1/meters"meters”.
  • dimensions: number of dimensions in the grid. Default value is 3 for imaging mode, and is 2 for diffuse mode.
  • bounds: bounds of the grid.
    • xmin: default value is -35.
    • xmax: default value is 5.
    • ymin: default value is -25.
    • ymax: default value is 5.
    • zmin: default value is 5. This parameter does not exist if grid.dimentions is 2.
    • zmax: default value is 50. This parameter does not exist if grid.dimentions is 2.
  • spacing: size of the grid elements.
    • dx: default value is 0.25 for imaging mode file, and is 0.5 for diffuse mode file.
    • dy: default value is 0.25 for imaging mode file, and is 0.5 for diffuse mode file.
    • dz: default value is 0.25. This parameter does not exist if grid.dimentions is 2.
  • x: matrix
  • y: matrix
  • z: matrix This parameter does not exist if grid.dimentions is 2.
  • v: matrix
  • v_filt: matrix
  • w: matrix
  • std: matrix
  • vr; matrix
  • covar: matrix
  • size: default value is 121, 161, 181 for imaging mode file, and is 61, 81 for diffuse mode file.
  • axis: default value is -35,5,-25,5,5,50 for imaging mode file, and is -35, 5, -25, 6, 0,0 for diffuse mode file.
  • name: filename for MAT and PNG files.
  • offset_covar

...

  • elev: scan elevation in degrees above horizontal
  • npings
  • start_ping

Oceans 3.0 API filter: extension=mat

PNG

The plot for the Plume Doppler mode shows five plots summarizing the data, tracking the plume's size, position, relative density and flow rates. All distances are in meters relative to the sonar position.

Oceans 3.0 API filter: extension=png

Example:

PDF

The PDF plot shown is the same as the PNG, however, PDF files can contain multiple plots in a vectorized form, which is better for high resolution printing or zooming.

Oceans 3.0 API filter: extension=pdf

Discussion

To comment on this product, click Add Comment below.