Doppler NetCDF Structure

Realtime

Doppler differs from the simple NetCDF time series structures previously commented on in that the depth dimension is larger than one. The current velocities are therefore multidimensional in depth and time. If the water depth is deep enough, a full 30 bins can be realistically recorded. When relayed back via GOES, usually fewer than 30 bins are sent.

As an example, see the structure for the GOES doppler NetCDF file for E0106.

Post Recovery Sensor Raw

The post-recovery-sensor-raw data has numerous additional variables that are particular to the nature of the RDI ADCP instrument. An example is given in the appendix The m-file rdradcp.m written by <GENUFLECT>Rich Pawlowicz</GENUFLECT> that reads the data provides a number of instrument parameters that are tacked on to the NetCDF file as global attributes. Many of the definitions are ripped right out of Table 27 in [ WORKHORSE_COM_FOR ] . These are defined as follow.

Attribute Definitions

name

Always wh-adcp.

prog-ver

Corresponds to CPU firmware version number and CPU firmware revision number in xx.yy format.

config

Bit mask defining the Workhorse hardware configuration, represented as by a string, LSB first, then MSB. The information conveyed by the bitmask is given by the beam_angle, beam_freq, beam_pattern, and orientation attributes.

beam_angle

Either 15E, 20E, 30E, or other.

beam_freq

Either 75, 150, 300, 600, 1200, or 2400 kHz.

beam_pattern

Up or down.

orientation

Concave or convex.

simflag

Should always be real.

n_beams

Contains the number of beams used to calculate velocity data (not physical beams). The Workhorse needs only three beams to calculate water-current velocities. The fourth beam provides an error velocity that determines data validity. If only three beams are available, the Workhorse does not make this validity check.

n_cells

Contains the number of depth cells over which the Workhorse collects data. Usually this is 30.

pings_per_ensemble

Contains the number of pings averaged together during a data ensemble.

cell_size

The length of one depth cell. Usually 4.

blank

Contains the blanking distance used by the Workhorse to allow the transmit circuits time to recover before the receive cycle begins.

prof_mode

Signal processing mode. Should be 1.

corr_threshold

Contains the minimum threshold of correlation that water profile data can have to be considered good data. Range of 0 to 255 counts.

n_codereps

Contains the number of code repetitions in the transmit pulse.

min_pgood

Contains the minimum percentage of water-profiling pings in an ensemble that must be considered good to output velocity data. Range 1 to 100 percent.

evel_threshold

This field contains the actual threshold value used to flag water-current data as good or bad. If the error velocity value exceeds this threshold, the Workhorse flags all four beams of the affected bin as bad. Range is 0 to 5000 mm/s.

time_between_ping_groups

Time in seconds between ping groups in the ensemble.

coord

Bit mask whose information is conveyed by the attributes coord_sys, use_pitchroll, use_3beam, and bin_mapping.

coord_sys

One of beam, instrument, ship, or earth.

use_pitchroll

no, or yes.

use_3beam

no, or yes.

bin_mapping

no, or yes.

xducer_misalign

Heading Alignment field, contains a correction factor for physical heading misalignment. In degrees.

sensors_src

Sensor Source field, contains the selected source of environmental sensor data. These firmware switches indicate the following.

Bit Flags

x1xxxxxx

Calculates EC (speed of sound) from ED, ES, and ET.

xx1xxxxx

Uses ED from depth sensor.

xxx1xxxx

Uses EH from from transducer heading sensor.

xxxx1xxx

Uses EP from transducer pitch sensor.

xxxxx1xx

Uses ER from transducer roll sensor.

xxxxxx1x

Uses ES (salinity) from conductivity sensor.

xxxxxxx1

Uses ET from transducer temperature sensor.

The bit sequence is converted into a string.

sensors_avail

This field reflects if the Speed of Sound sensor is available. The bit pattern is the same as listed above, and is also converted into a string.

bin1_dist

The distance to the middle of the first depth cell (bin) in meters rather than cm.

xmit_pulse

The length of the transmit pulse in meters rather than cm.

water_ref_cells

Contains the starting depth cell and the ending depth cell used for water reference layer averaging. Range = 1 to 128 depth cells.

fls_target_threshold

Contains the threshold value used to reject data retrieved from a false target, usually fish (WA-command). Range = 0 to 255 counts.

xmit_lag

This field, determined mainly by the setting of the WM-command, contains the distance between pulse repetitions. In meters.

serialnum

CPU board serial number.

ranges

The depth to the middle of each bin. This usually does not take into account the instrument depth itself, which usually isn't dead on accurate itself. A good rule of thumb here is to add the instrument depth to this attribute, and if the depth values are within half the cell width of the ranges values, then we're probably ok. Good enough for government work, anyway. Oh wait, we're not government...