Level 3 data (velocity profilers): Difference between revisions
Jmmcmillan (talk | contribs) No edit summary |
m Update order of dimensions as per TEAMS discussion |
||
Line 22: | Line 22: | ||
| time | | time | ||
| TIME | | TIME | ||
| Units in Days since reference time specified in variable attribute. Provide bounds attribute to designate the variable containing the limits of each segment ([http://cfconventions.org/cf-conventions/v1.6.0/cf-conventions.html#methods-applied-to-a-timeseries-ex see CF-compliant example]). | | Segment midpoint time. Units in Days since reference time specified in variable attribute. Provide bounds attribute to designate the variable containing the limits of each segment ([http://cfconventions.org/cf-conventions/v1.6.0/cf-conventions.html#methods-applied-to-a-timeseries-ex see CF-compliant example]). | ||
|- | |- | ||
| Z_DIST | | Z_DIST | ||
Line 28: | Line 28: | ||
| Z_DIST | | Z_DIST | ||
| bin centre distance (in meters) from the transducer along the instrument's vertical axis | | bin centre distance (in meters) from the transducer along the instrument's vertical axis | ||
|- | |- | ||
| N_BEAM | | N_BEAM | ||
Line 39: | Line 33: | ||
| N_BEAM | | N_BEAM | ||
| Array of 1 to number of beams (3 to 5 typically) | | Array of 1 to number of beams (3 to 5 typically) | ||
|- | |||
| N_DEL | |||
| along-beam_separation_distance_over_ | |||
which_DLL_is_evaluated_in_number_of_bins | |||
| N_DEL | |||
| Number of bins separating two velocity measurements used to calculate DLL | |||
|} | |} | ||
</div> | </div> | ||
Line 54: | Line 54: | ||
| DLL | | DLL | ||
| second_order_structure_function | | second_order_structure_function | ||
| TIME, | | TIME, Z_DIST, N_BEAM, N_DEL | ||
| Differences in velocities squared have been time-averaged (units of m2/s2). | | Differences in velocities squared have been time-averaged (units of m2/s2). | ||
|- | |- | ||
| DLL_FLAGS | | DLL_FLAGS | ||
| | | second_order_structure_function_ | ||
| TIME, | status_flag | ||
| TIME, Z_DIST, N_BEAM, N_DEL | |||
| {{FontColor|fg=white|bg=red|text=To be linked, when boolean flags defined}} | | {{FontColor|fg=white|bg=red|text=To be linked, when boolean flags defined}} | ||
|- | |- | ||
| R_DEL | | R_DEL | ||
| along- | | along-beam_separation_distance_at_ | ||
which_structure_function_is_evaluated | |||
| | | TIME, Z_DIST, N_BEAM, N_DEL | ||
| Estimated quantity (in meters) from N_DEL (Level 3), BIN_SIZE (Level 2) and THETA (Level 2). | | Estimated quantity (in meters) from N_DEL (Level 3), BIN_SIZE (Level 2) and THETA (Level 2). | ||
|- | |- | ||
Line 74: | Line 75: | ||
|- | |- | ||
| DLL_N | | DLL_N | ||
| | | second_order_structure_function_number_ | ||
| TIME, | of_observations | ||
| TIME, Z_DIST, N_BEAM, N_DEL | |||
| The number of available measurements in each segment i.e., data quality. | | The number of available measurements in each segment i.e., data quality. | ||
|- | |- |
Revision as of 10:19, 22 April 2022
Page status: Ready for review | |
---|---|
Author(s): | Cynthia |
Reviewer(s): | |
Comment: |
The required dimensions and variables for the structure-function processing level within NetCDF ATOMIX format for velocity ADCP measurements are described below. This NetCDF group contains the structure function (DLL) calculated as a function of the along-beam separation for the available/usable ADCP bins.
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 |
---|---|---|---|
TIME | time | TIME | Segment midpoint time. Units in Days since reference time specified in variable attribute. Provide bounds attribute to designate the variable containing the limits of each segment (see CF-compliant example). |
Z_DIST | distance_from_sensor_along_vertical | Z_DIST | bin centre distance (in meters) from the transducer along the instrument's vertical axis |
N_BEAM | unique_identifier_for_each_beam | N_BEAM | Array of 1 to number of beams (3 to 5 typically) |
N_DEL | along-beam_separation_distance_over_
which_DLL_is_evaluated_in_number_of_bins |
N_DEL | Number of bins separating two velocity measurements used to calculate DLL |
Variables
Short name | Standard name | Dimensions | Comment |
---|---|---|---|
DLL | second_order_structure_function | TIME, Z_DIST, N_BEAM, N_DEL | Differences in velocities squared have been time-averaged (units of m2/s2). |
DLL_FLAGS | second_order_structure_function_
status_flag |
TIME, Z_DIST, N_BEAM, N_DEL | To be linked, when boolean flags defined |
R_DEL | along-beam_separation_distance_at_
which_structure_function_is_evaluated |
TIME, Z_DIST, N_BEAM, N_DEL | Estimated quantity (in meters) from N_DEL (Level 3), BIN_SIZE (Level 2) and THETA (Level 2). |
R_DIST | distance_from_sensor_along_beams | Z_DIST, N_BEAM | Along-beam bin centre distance (in meters) from the transducer |
DLL_N | second_order_structure_function_number_
of_observations |
TIME, Z_DIST, N_BEAM, N_DEL | The number of available measurements in each segment i.e., data quality. |
N_SEGMENT | unique_identifier_for_each_segment_
in_the_entire_available_timeseries |
TIME | Enables backtracking to previous processing level |
BURST_NUMBER [math]\displaystyle{ \dagger\dagger }[/math] | unique_identifier_for_each_burst | TIME | Only required when measuring in burst-mode. Integers of 1, 2, etc to designate which burst the velocities are associated with. |
[math]\displaystyle{ \dagger\dagger }[/math] Optional variable required only when measuring in bursts e.g., 18 min of continuous measurements every hour. |
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. |
| |
dll_calculation_type | Specify differencing technique used to estimate DLL | Examples include:
| |
Optional group attributes [math]\displaystyle{ \ddagger }[/math] | |||
stationarity_testing | Any testing done on the segment to verify stationarity? | To be revisited once testing begins. Tentatively refer to demo yaml file. | |
noise_testing | Details of testing the noise levels, or if the signal comprises mostly of noise? | ||
comment (optional) | Any additional information pertinent to other users who test their algorithms against the file. |
Return to Level 2 segmented velocities