Skip to end of metadata
Go to start of metadata

COVIS Plume Imaging Raw Files

This is a description of this raw IMAGING mode data from COVIS. Documentation for the processed data is also available.

Oceans 2.0 API filterdataProductCode=CPIRF

Revision History

  • 20111123: Initial product released



The TAR.GZ files contain the raw data and the metadata needed to process and interpret in files of CSV, JSON and BIN formats. The following table lists the types of files and the information each contains. All of the JSON files are ascii text and human readable (with some effort). Similarly the CSV files can be read directly as ascii or loaded into a spreadsheet program like Excel. The BIN files are binary. Further details are supplied within the examples below.

File Type



Main metadata including timestamp, acquisition mode (“imaging”), and various sonar parameters (transmit pulse length, frequency, etc.). Some parameters can be set by direct interaction with the sonar and some are fixed.


This contains data from the attitude sensor (time, pitch, roll, heading). All measurements are in degrees. Pitch and Roll are gravity referenced. Heading is magnetic. There is one record per rotator stop.


This file contains data from the rotator motors (pitch, roll, yaw). All measurements are in degrees relative to an arbitrary reference. There is one record per rotator stop.


This file is derived from the above two files but contains one record per sonar ping. It lists the pings (numbering from 1 up) and gives the time (seconds, microseconds), rotator data (pitch, roll, yaw), and attitude data ( pitch, roll, heading) for each ping.


These are the metadata for each ping. Some of this information may overlap with sweep.json and some of it is set by the experimenter.


These are the actual data files ping-by-ping. They are in binary format. There should be one rec_7038_x.bin for every rec_7000_x.json.


Oceans 2.0 API filter: extension=tar


The examples are from APLUWCOVISMBSONAR001_20101002T060525.939Z-IMAGING.tar.gz.

attitude.csv – This the first three lines of a particular file.

time	kPAngle	kRAngle	kHeading
05:26.2	-0.43	-0.05	212.24
05:29.0	0.14	-0.05	212.33


  • time is the minutes:seconds at which the data is measured.
  • kPAngle is the pitch in degrees
  • kR Angle is the roll in degrees
  • kHeading is the magnetic direction (in degrees) the sonar is pointing

index.csv – This the first three lines of a particular file.

ping	seconds	microseconds	pitch	roll	yaw	kPAngle	kRAngle	kHeading
1	1.29E+09	486103	221.5	225.5	131.6	-0.4	0	212.2
2	1.29E+09	691525	221.5	225.5	131.6	-0.4	0	212.2


  • Ping is the ping number, which always starts at 1.
  • Seconds
  • Microseconds
  • Pitch is from the same data as in rotator.csv
  • Roll is from the same data as in rotator.csv
  • Yaw is from the same data as in rotator.csv
  • kPAngle is from the same data as in attitude.csv
  • kRAngle is from the same data as in attitude.csv
  • kHeading is from the same data as in attitude.csv

Note that the attitude and rotator data should be consistent but may disagree since they are independently measured.


time	pitch	roll	yaw
05:26.2	221.5	225.5	131.6
05:29.0	220	225.5	131.6


  • Time in minutes:seconds.deciseconds
  • Pitch in degrees
  • Roll in degrees
  • Yaw in degrees

rec_7000_xxxxxx.json – Reson format for ascii metadata file documented in rec7000.pdf 

rec_7038_xxxxxx.bin – Reson format for binary data documented in rec7008.pdf 


Refer to the Discussion on the COVIS Doppler page for more information.

To comment on this product, click Add Comment below.

  • No labels