RDI ADCP Time Series

Data files for Teledyne RDI ADCPs are described here. Ancillary data (e.g., temperature, pitch, roll) are also available independently, through scalar data products, see time series scalar data and time series scalar plots.

Oceans 3.0 API filterdataProductCode=RADCPTS

Revision History

Formats

This data is available as processed data in MAT and NETCDF formats. Content descriptions and example files are provided below.

Manufacturer's Raw Binary Format: .RDI Files

This binary format is specific to the manufacturer. Direct access to RDI files may be restricted until verified versions are available. When using Teledyne-RDI data acquisition software, data is normally stored in this way. Although we use custom-built drivers to communicate with our instruments, we can use the raw data in the log file to produce the RDI file which can be interpreted by Teledyne-RDI post-processing software. These files are usually pre-generated and stored in the archive for fast retrieval, otherwise they are made on the fly like most other data products.

To produce the file, the following requirements apply:

For users' information and interest, the site and sitedevice information is available through the device details pages, for example: http://dmas.uvic.ca/DeviceListing?DeviceId=20003. This information is also included in the metadata report that accompanies most data products.

This format is further described in the manufacturer's documentation.

The Teledyne-RDI software to read RDI files (winADCP) is available through their website, although it is not obvious how to download. There are also some questionable sites offering downloads that don't go anywhere except to potential malware. Users can request access through the Teledyne Marine Download Portal: https://tm-portal.force.com/TMsoftwareportal/s/ As always you can contact us for support, through the main website, on Oceans 3.0 or here: Contact Support.

Example: RDIADCP75WH17432_20131113T000000.000Z.rdi

Oceans 3.0 API filter: extension=rdi

Processed Data

ADCP Velocity Computation: Correction and Rotation to East-North-Up Co-ordinate System, Three-beam Solutions and Screening

MAT Files

MAT files (v7) can be opened using MathWorks MATLAB 7.0 or later. The file contains four structures: meta, adcp, config, and units. For short duration searches (less than one day) or short duration data returned, the files will be concatenated, otherwise, expect one file per RDI file. (RDI files can break in the middle of a day due to data quantity limits or configuration changes, otherwise there is one file per day. RDI files are used as a processing intermediary format.)


adcp: structure containing the ADCP data, having the following fields.

config: structure containing ADCP configuration details, where some field names are appended with '_XX' to represent the corresponding configuration command (beneficial for experienced RDI ADCP users).

units: structure containing unit of measure for fields in structures above. For instance, units.pressure='decibar'.

For details about the configuration parameters, refer to the manufacturer documentation (especially the WorkHorse Commands and Output Data Format manual).

Example: RDIADCP75WH3808_20101106T000225.mat

Oceans 3.0 API filter: extension=mat

NETCDF Files

NetCDF is a machine-independent data format offered by numerous institutions, particularly within the earth and ocean science communities. Additional resources are noted here. For short duration searches (less than one day) or short duration data returned, the files will be concatenated, otherwise, expect one file per RDI file. (RDI files can break in the middle of a day due to data quantity limits or configuration changes, otherwise there is one file per day. RDI files are used as a processing intermediary format.)

The RDI NetCDF file is extracted from the data contained in the above MAT file. The NetCDF file contains the following main variables: u, v, w, time, binmap_depth, where the binmap_depth variable here is distinct from the pressure sensor measurement in the MAT file (adcp.depth). When there is bin-mapping performed on the data, the binmap_depth is calculated as meta.depth - adcp.range; it is the approximate water depth at which the measurement bins are located. If bin-mapping is 'none', then the binmap_depth and the depth are equal. depth is calculated as meta.depth - adcp.backscatterVerticalRange, which is the range corrected for tilt. depth is used to plot the beam-averaged backscatter and any other beam-averaged values that are not bin-mapped. The structure and content of the netCDF file is very similar to that of the MAT file, including the variable naming. The RDI and Nortek netCDF files are intended to be very similar, even interchangeable with the same structure and definitions. 

The NetCDF files are intended to be in compliance with the CF-1.7 standard. Depending on the compliance checker that is used the data may not meet this standard for the following reasons: The units dB are not defined, and the feature type of the data is not defined.

Oceans 3.0 API filter: extension=nc

Example: RDIADCP75WH17575_20130314T194500Z_20130502T164500Z-Ensemble900s_binMapNearest.nc



>> ncdisp('C:\Users\ONC\Test\RDIADCP75WH17575_20130314T194500Z_20130502T164500Z-Ensemble900s_binMapNearest.nc')
Source:
           C:\Users\ONC\Test\RDIADCP75WH17575_20130314T194500Z_20130502T164500Z-Ensemble900s_binMapNearest.nc
Format:
           netcdf4_classic
Global Attributes:
           Conventions                            = 'CF-1.7'
           title                                  = 'Ocean Networks Canada Teledyne-RDI ADCP Data'
           institution                            = 'Ocean Networks Canada'
           source                                 = 'Fixed-position Teledyne-RDI ADCP 75 kHz'
           references                             = 'https://www.oceannetworks.ca/'
           comment                                = 'Detailed documentation: https://wiki.oceannetworks.ca/display/DP/5'
           history                                = 'Includes data extracted from raw output, minimally processed, and processed data'
           processing_comments                    = 'adcp.velocity(1:3,:,:) contains velocity data relative to the co-ordinate system 'Earth'. acdp.velocity(4,:,:) is the RDI error velocity. adcp.u/v/w are processed velocities relative to true East/North/up, respectively. This device does not have a mobile heading sensor or a fixed heading; using onboard magnetic compass for heading (magnetic declination will be applied). Overriding requested option: correlation screening cannot be applied to Earth co-ordinate data that has already been bin-mapped. Beam range bins were corrected for tilt by nearest vertical bin-mapping (RDI method) onboard the device (new pitch/roll values not applied). Average or fixed tilt is 57.1483 degrees (for information only, averages are not used in correction). adcp.range is the vertical range to the corrected bin centres. Error velocity screening not applied to Earth co-ordinate data unchanged; screening applied onboard used a more stringent threshold than the user selected value. Device-supplied adcp.u/v/w unchanged from RDI file data (adcp.velocity); heading rotation correction done in post-processed RDI file.adcp.backscatter (relative volume backscattter) calculated from 0.45*adcp.intens + 20*log10(adcp.range) + 2*config.soundAbsorptionCoefficient*adcp.range, adcp.meanBackscatter calculated by beam-averaging the volume backscatter (accounting for dB scale). adcp.meanBackscatter and adcp.backscatter have units of relative dB. Ensemble file created by box-car average resampling to a ensemble interval of 900 seconds (raw data ensemble interval: 3.7 seconds). adcp.intens was average normally, while adcp.backscatter and adcp.meanBackscatter were averaged by first converting the logarithmic dB scale to linear, averaging, then converting back.For information on the various processing steps applied, see https://wiki.oceannetworks.ca/display/DP/5. '
           CREATION_DATE                          = '20210927T201853Z in QA'
           time_coverage_start                    = '20130314T195230Z'
           time_coverage_end                      = '20130502T163730Z'
           device_id                              = 23066
           device_heading                         = NaN
           platform_depth                         = -20
           site_name                              = 'MTC NEPTUNE Integration Lab'
           device_name                            = 'RDI Workhorse Long Ranger ADCP 75 kHz (17575)'
           location_name                          = 'Marine Technology Centre'
           search_id                              = 875050
           firmware_version                       = 50
           firmware_revision                      = 40
           frequency                              = 75
           beam_pattern                           = 'Convex'
           orientation                            = 'Up'
           beam_angle                             = 20
           adcp_setup_CQ_sysPower                 = 255
           adcp_setup_TE_ensemble_interval_sec    = 900
           adcp_setup_TP_time_ping_sec            = 0
           adcp_setup_WA_false_target_threshold   = 255
           adcp_setup_WB_system_bandwidth         = 0
           adcp_setup_WC_correlation_threshold    = 0
           adcp_setup_WE_error_threshold          = 0
           adcp_setup_WE_blanking_distance_meters = 7.04
           adcp_setup_WG_percent_good_minimum     = 0
           adcp_setup_WN_number_bins              = 80
           adcp_setup_WP_number_pings             = 1
           adcp_setup_WS_cell_size_meters         = 8
           adcp_setup_WT_transmit_length          = 8.25
Dimensions:
           time      = 4692
           depth     = 80
           latitude  = 1
           longitude = 1
Variables:
    time             
           Size:       4692x1
           Dimensions: time
           Datatype:   double
           Attributes:
                       sdn_parameter_name = 'time'
                       long_name          = 'time'
                       units              = 'days since 19700101T000000Z'
                       axis               = 'T'
                       calendar           = 'gregorian'
    binmap_depth     
           Size:       80x1
           Dimensions: depth
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'depth'
                       long_name          = 'water depth of final velocity measurement bins'
                       units              = 'meters'
                       axis               = 'Z'
                       positive           = 'down'
                       comment            = 'Water depth for the u (east), v (north), w (up), velocityError seawater velocity bins, accounting for bin-mapping'
    depth            
           Size:       80x1
           Dimensions: depth
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'depth'
                       long_name          = 'water depth of beam-averaged measurement bins, tilt-corrected'
                       units              = 'meters'
                       axis               = 'Z'
                       positive           = 'down'
                       comment            = 'Water depth of measurement bins corrected for tilt, applies to meanBackscatter (beam-averaged backscatter)'
    range            
           Size:       80x1
           Dimensions: depth
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'range'
                       long_name          = 'range from transducer'
                       units              = 'meters'
                       axis               = 'Z'
                       comment            = 'Range of measurement bins from the transducer, applies to all parameters except: u, v, w, velocityError when bin-mapping is on'
    latitude         
           Size:       1x1
           Dimensions: latitude
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'latitude'
                       long_name          = 'latitude'
                       units              = 'degrees_north'
                       axis               = 'Y'
    longitude        
           Size:       1x1
           Dimensions: longitude
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'longitude'
                       long_name          = 'longitude'
                       units              = 'degrees_east'
                       axis               = 'X'
    u                
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'eastward_sea_water_velocity'
                       long_name          = 'eastward sea water velocity'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    v                
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'northward_sea_water_velocity'
                       long_name          = 'northward sea water velocity'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    w                
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'upward_sea_water_velocity'
                       long_name          = 'upward sea water velocity'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    velocityError    
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'indicative_error_from_multibeam_acoustic_doppler_velocity_profiler_in_sea_water'
                       long_name          = 'acoustic doppler current profiler error velocity'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    meanBackscatter  
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_nam = 'sound_intensity_level_in_water'
                       long_name         = 'acoustic doppler current profiler beam-averaged corrected acoustic backscatter'
                       units             = 'dB'
                       _FillValue        = -9999999
                       comment           = 'beam averaged and corrected for two-way beam spreading and attenuation, not bin-mapped, use with tilt-corrected water depth'
    intens_beam1     
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'signal_intensity_from_multibeam_acoustic_doppler_velocity_sensor_in_sea_water'
                       long_name          = 'acoustic doppler current profiler return signal strength intensity beam 1'
                       units              = 'counts'
                       _FillValue         = -9999999
    intens_beam2     
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'signal_intensity_from_multibeam_acoustic_doppler_velocity_sensor_in_sea_water'
                       long_name          = 'acoustic doppler current profiler return signal strength intensity beam 2'
                       units              = 'counts'
                       _FillValue         = -9999999
    intens_beam3     
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'signal_intensity_from_multibeam_acoustic_doppler_velocity_sensor_in_sea_water'
                       long_name          = 'acoustic doppler current profiler return signal strength intensity beam 3'
                       units              = 'counts'
                       _FillValue         = -9999999
    intens_beam4     
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'signal_intensity_from_multibeam_acoustic_doppler_velocity_sensor_in_sea_water'
                       long_name          = 'acoustic doppler current profiler return signal strength intensity beam 4'
                       units              = 'counts'
                       _FillValue         = -9999999
    corr_beam1       
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'beam_consistency_indicator_from_multibeam_acoustic_doppler_velocity_profiler_in_sea_water'
                       long_name          = 'acoustic doppler current profiler correlation magnitude beam 1'
                       units              = 'counts'
                       _FillValue         = -9999999
    corr_beam2       
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'beam_consistency_indicator_from_multibeam_acoustic_doppler_velocity_profiler_in_sea_water'
                       long_name          = 'acoustic doppler current profiler correlation magnitude beam 2'
                       units              = 'counts'
                       _FillValue         = -9999999
    corr_beam3       
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'beam_consistency_indicator_from_multibeam_acoustic_doppler_velocity_profiler_in_sea_water'
                       long_name          = 'acoustic doppler current profiler correlation magnitude beam 3'
                       units              = 'counts'
                       _FillValue         = -9999999
    corr_beam4       
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'beam_consistency_indicator_from_multibeam_acoustic_doppler_velocity_profiler_in_sea_water'
                       long_name          = 'acoustic doppler current profiler correlation magnitude beam 4'
                       units              = 'counts'
                       _FillValue         = -9999999
    percentGood_beam1
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'proportion_of_acceptable_signal_returns_from_acoustic_instrument_in_sea_water'
                       long_name          = 'acoustic doppler current profiler percent good beam 1'
                       units              = 'percent'
                       _FillValue         = -9999999
    percentGood_beam2
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'proportion_of_acceptable_signal_returns_from_acoustic_instrument_in_sea_water'
                       long_name          = 'acoustic doppler current profiler percent good beam 2'
                       units              = 'percent'
                       _FillValue         = -9999999
    percentGood_beam3
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'proportion_of_acceptable_signal_returns_from_acoustic_instrument_in_sea_water'
                       long_name          = 'acoustic doppler current profiler percent good beam 3'
                       units              = 'percent'
                       _FillValue         = -9999999
    percentGood_beam4
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'proportion_of_acceptable_signal_returns_from_acoustic_instrument_in_sea_water'
                       long_name          = 'acoustic doppler current profiler percent good beam 4'
                       units              = 'percent'
                       _FillValue         = -9999999
    velocity_beam1   
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'radial_sea_water_velocity_away_from_instrument'
                       long_name          = 'radial velocity beam 1'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    velocity_beam2   
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'radial_sea_water_velocity_away_from_instrument'
                       long_name          = 'radial velocity beam 2'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    velocity_beam3   
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'radial_sea_water_velocity_away_from_instrument'
                       long_name          = 'radial velocity beam 3'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    velocity_beam4   
           Size:       80x4692
           Dimensions: depth,time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'radial_sea_water_velocity_away_from_instrument'
                       long_name          = 'radial velocity beam 4'
                       units              = 'meters/second'
                       _FillValue         = -9999999
    temperature      
           Size:       4692x1
           Dimensions: time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'sea_water_temperature'
                       long_name          = 'sea water temperature'
                       units              = 'K'
                       _FillValue         = -9999999
    pitch            
           Size:       4692x1
           Dimensions: time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'platform_pitch_angle'
                       long_name          = 'pitch'
                       units              = 'degrees'
                       _FillValue         = -9999999
    roll             
           Size:       4692x1
           Dimensions: time
           Datatype:   single
           Attributes:
                       sdn_parameter_name = 'platform_roll_angle'
                       long_name          = 'roll'
                       units              = 'degrees'
                       _FillValue         = -9999999

Above example may be out of date. Recent changes include: added compass heading, updated units.

Discussion

To comment on this product, click Add Comment below.