COVIS Plume Imaging Time Series

This is a description of the COVIS processed imaging mode data.

Revision History

• 2011XXXX: Initial product released

Formats

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

MAT

MAT file contains a structure called covis that contains all the parameter information and the gridded data. Structure covis contains the following structures: type, comments, user, sonar, processing, grid, sweep, beamformer, ping, burst, and calibrate.

type: type of mode (i.e., imaging for imaging mode)
comments: a comment from COVIS team.

user: structure containing input parameters for MATLAB code to generate MAT and PNG files from raw tar file.

• verbose: tells whether information on the processing progress is written to the screen or not. Default value is 2 for imaging mode file, and is 1 for diffuse mode file.
• debug: controls whether individual pings are plotted or not. Default value is 0 for imaging mode file, and is 1 for diffuse mode file.
• view: sets the direction from which the data will be viewed in the usual MATLAB orientation units.
  • azimuth: azimuth of the Matlab 3D view. Default value is 37.5
  • elevation: elevation of the Matlab 3D view. Default value is 30
• output: path of output files. Default value is "/output".

sonar: structure containing information about sonar itself.

• position: structure containing the sonar position
  • easting: default value is 492669.
  • northing: default value is 5310678.
  • depth: default value is -2205.0.
  • altitude: default value is 4.2000.
  • declination: default value is 18.
  • heading: default value is 230.4. This parameter does not exist for diffuse mode file.

processing: structure containing parameters controlling the processing

• beamformer: type of beamforming.
  • type: default value is "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" for imaging mode file and "TS" for diffuse mode file.
• filter: controls the filtering part of the processing.
  • status: default value is "on".
  • type: default value is "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", 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: ?? This structure does not exist for imaging mode.
  • window_size: ??
  • window_overlap: ??
  • windthresh: ??
  • nlag: ??

grid: structure contains what kind and size of grid used in the final stage of processing.

• type: what the values in the grid mean. Default value is "back-scatter cross section" for imaging mode file, and is "decorrelation intensity" for diffuse mode file.
• shape: shape of the grid. Default value is "rectangular".
• units: units for the output grids
  • spatial: default value is "meters".
  • Value: default value is "1/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 with 121*161*181 elements.
• y: matrix with 121*161*181 elements.
• z: matrix with 121*161*181 elements. This parameter does not exist if grid.dimentions is 2.
• v: matrix with 121*161*181 elements.
• w: matrix with 121*161*181 elements.
• 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.

sweep:

• sequence_id: ??
• alpha_id: ??
• mode: diffuse
• timestamp: ??
• alpha_rev: ??
• endtime: ??
• annotation: ??
• schema: ??
• path: location for processed raw tar file ??
• name: processed raw tar filename ?

ping: structure array contains covis data?? One struct contains below parameters

• num: ??
• sec: ??
• rot: ??
  • pitch: ??
  • roll: ??
  • yaw: ??
• tcm: ??
  • kPAngle: ??
  • kRAngle: ??
  • kHeading: ??
• hdr: ??
  • control: ??
    • auto_range_method: ??
    • bd_range: ??
    • auto_bd_filter_method: ??
    • bd_depth: ??
    • auto_gain_method: ??
  • power_sel: ??
  • ping_num: ??
  • prj: ??
    • horiz_width: ??
    • window_type: ??
    • horiz_angle: ??
    • vert_width: ??
    • window_param: ??
    • focal_point: ??
    • id: ??
    • vert_angle: ??
  • max_ping_rate: ??
  • envelope_type: ??
  • multi_ping: ??
  • xmlt_freq: ??
  • sound_speed: ??
  • absorption: ??
  • range_sel: ??
  • pulse_type: ??
  • hydrophone_id: ??
  • transmit: ??
    • yaw_stablization: ??
    • pitch_stablization: ??
  • bd: ??
    • max_range: ??
    • min_range: ??
    • min_depth: ??
    • max_depth: ??
  • pulse_extra: ??
  • ping_period: ??
  • rcvr_bandwidth: ??
  • recv: ??
    • window_type:??
    • flags: ??
    • window_param: ??
    • beam_width: ??
  • sonar_id: ??
  • gain_sel: ??
  • sample_rate: ??
  • spreading_loss: ??
  • pulse_width: ??
  • envelope_param: ??

burst:

• • elev
  • npings
  • start_ping

PNG

PNG file shows the isosurfaces of the gridded data in the MAT file. One example of PNG for Imaging mode file is below

Examples

Discussion

To comment on this product, click Add Comment below.