Level 2 data (velocity profilers): Difference between revisions

From Atomix
Updated names for consistency with Cynthia'a netcdf tools
Update time description
Line 65: Line 65:
| TIME
| TIME
| N_SEGMENT,  N_SAMPLE
| N_SEGMENT,  N_SAMPLE
| Units in Days since 1950-01-01T00:00:00Z
| Units in Days since reference time specified in variable attribute
|-
|-
| PROFILE_NUMBER  
| PROFILE_NUMBER  

Revision as of 13:56, 20 April 2022

Velocities have now been segmented and detrended. Each segment is stored separately from each other, which allows segmenting data using overlapping windows i.e., some velocity samples can belong to more than one segment.

The dimensions and variables for this processing level are described below.

Only a few attributes for each variable are listed since the page's purpose is to describe the information layout within each NetCDF file. Please refer to the complete list for the additional attributes related to each variable (e.g., units, bounds, cell_methods).

Dimensions


Short name Standard name Dimensions Comments
N_SEGMENT unique_identifier_for_each_

segment_in_the_entire_available_timeseries

N_SEGMENT Replacement for using TIME centred in the segment as dimension
N_SAMPLE unique_identifier_for_each_

sample_within_the_segment

N_SAMPLE Max sample number is the segment length (seconds) multiplied by the sampling rate
N_BEAM unique_identifier_for_each_beam N_BEAM Array of 1 to number of beams (3 to 5 typically)
Z_DIST distance_from_sensor_along_vertical Z_DIST bin centre distance (in meters) from the transducer along the instrument's vertical axis

Variables


Short name Standard name Dimensions Comment
R_VEL water_radial_velocity_of_scatterers_

towards_instrument

N_SEGMENT, Z_DIST,N_SAMPLE, N_BEAM Along beam velocity [m/s] for each of the beams.
R_VEL_DETRENDED water_radial_velocity_of_scatterers_

towards_instrument_detrended

N_SEGMENT, Z_DIST, N_SAMPLE, N_BEAM High-frequency content of the along-beam velocities [m/s], which may include surface wave, motion contamination, in addition to the turbulence signal. Calculated from R_VEL by removing the segment mean or trend. Detrending method should be specified by detrending_method in group attributes (see below). Link to own detrending page
TIME TIME N_SEGMENT, N_SAMPLE Units in Days since reference time specified in variable attribute
PROFILE_NUMBER unique_identifier_for_each_profile N_SEGMENT, N_SAMPLE This variable identifies each record (velocity) profile
THETA beam_angle_from_instrument_z_axis N_BEAM Units in degrees, positive (usually ~20-30[math]\displaystyle{ ^\circ }[/math]) except vertical-pointing beams (0[math]\displaystyle{ ^\circ }[/math])
BIN_SIZE instrument_measurement_volume_bin_size constant Vertical size of the ADCP bins [m]. Usually the same for all 4 diverging beams.

[math]\displaystyle{ \ddagger }[/math] One could re-write for convenience the optional variables in Level 1 after segmenting them into smaller chunks.

Group attributes (metadata)

This section describes attributes that may provide additional information about how the data was processed and manipulated at this stage.


Attribute name Purpose Suggested content
processing_level Boilerplate about the content of the NetCDF group.

In this group, quality-controlled velocities have been split into smaller segments for processing. The timeseries are also detrended to recover the turbulence, and potentially surface wave and motion contamination.

segment_length Provide length in seconds of each segment Usually about 300 to 600 s dependent on time and length scales of turbulence
segment_overlap_proportion Provide proportion overlap of each segment, i.e., window overlap Often set to 0 or 0.5
detrending_method Specify which filter or technique was used to detrend velocities, which is required for spectral and turbulence analysis. Some examples include

High-pass YY order butterworth filter with XX seconds cutoff frequency on the entire burst/timeseries

Linear detrending on each segment

Optional group attributes
comment (optional) Any additional information pertinent to other users who test their algorithms against the file.

Return to: Level 1 raw

Go to Level 3 structure function