Level 3 data (velocity point-measurements): Difference between revisions
New page for level 3 data |
mNo edit summary |
||
Line 1: | Line 1: | ||
{{ReviewStage | |||
|toreview=Draft | |||
|authors=Cynthia | |||
|instrument_type=Velocity point-measurements | |||
}} | |||
The required dimensions and variables associated with the '''Level 3 spectra''' processing level (NetCDF group) for velocity measurements 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. {{FontColor|bg=#fca1fd|text=Please refer to the [[NetCDF_parameter|complete list]] for the additional attributes}} related to each variable (e.g., units). | |||
__TOC__ | |||
=Dimensions= | |||
<div class="mw-collapsible" id="raw" data-collapsetext="Collapse" data-expandtext="Expand dimensions"> | |||
<br> | |||
The number of velocity instruments (N_VEL_INSTRUMENT) is here for completeness, but the benchmarks examples will have measurements only from one instrument stored. | |||
{| class="wikitable sortable" | |||
|- | |||
! Short name | |||
! Standard name | |||
! Dimensions | |||
! Comments | |||
|- | |||
| TIME | |||
| time | |||
| TIME | |||
| Units in Days since 1950-01-01T00:00:00Z, time-centered | |||
|- | |||
| FREQ | |||
| frequency | |||
| FREQ | |||
| Frequency in Hz for the spectra | |||
|- | |||
| N_VEL_COMPONENT | |||
| unique_identifier_for_each_velocity_component | |||
| N_VEL_COMPONENT | |||
| Maximum of 3 for u,v, w (east, north, up) velocities | |||
|- | |||
| N_VEL_INSTRUMENT | |||
| unique_identifier_for_each_velocity_instrument | |||
| N_VEL_INSTRUMENT | |||
| Required only if storing multiple synchronized instruments in the same file | |||
|} | |||
</div> | |||
=Variables= | |||
<div class="mw-collapsible" id="raw" data-collapsetext="Collapse" data-expandtext="Expand variables"> | |||
<br> | |||
{| class="wikitable" | |||
|- | |||
! Short name | |||
! Standard name | |||
! Dimensions | |||
! Comment | |||
|- | |||
| UVW_VEL_SPEC | |||
| XXXX | |||
_in_the_analysis_frame_or_reference | |||
| TIME, FREQ, N_VEL_COMPONENT, N_VEL_INSTRUMENT | |||
| This may be rotated in the direction of the mean flow, or left in XYZ_VEL if relying only on the vertical component when estimating <math>\varepsilon</math>. {{FontColor|fg=red|text=Please specify the analysis frame of reference}} in the variable attribute and/or group's attribute. | |||
|- | |||
| UVW_VEL_SPEC_FLAGS | |||
| status_flag | |||
| TIME, N_SAMPLE, N_VEL_COMPONENT, N_VEL_INSTRUMENT | |||
| Enumerated flag that denotes if and how missing samples were replaced | |||
|- | |||
| [[Level_1_data_(velocity_point-measurements)#Required_height_variable|HEIGHT or DEPTH]]<math>\dagger</math> | |||
| See [[Level_1_data_(velocity_point-measurements)#Required_height_variable|Level 1 table]] | |||
| TIME, N_VEL_INSTRUMENT | |||
| | |||
|- | |||
| colspan="4" style="text-align:center; font-weight:bold; background-color:#f9eddd"| Optional variables <math>\ddagger</math> | |||
|- | |||
| BURST_NUMBER <math>\dagger\dagger</math> | |||
| unique_identifier_for_each_burst | |||
| TIME, N_VEL_INSTRUMENT | |||
| Only required when measuring in burst-mode. Integers of 1, 2, etc to designate which burst the velocities are associated with. | |||
|- | |||
| colspan="4" | | |||
<math>\ddagger</math> One could re-write for convenience the optional variables in [[Level_1_data_(velocity_point-measurements)#Optional_variables|Level 1]] after segmenting them into smaller chunks. For instance, PRES (pressure) would be fairly common in surface wave studies. | |||
<math>\dagger</math> A variable situating the instruments in the water column is required. This may be a nominal depth (or height) or a time-varying depth or height above the bottom. | |||
<math>\dagger\dagger</math> Variable required only when measuring in bursts e.g., 18 min of continuous measurements every hour. | |||
|} | |||
</div> | |||
=Group attributes (metadata)= | |||
<div class="mw-collapsible" id="raw_att" data-expandtext="Expand group attributes" data-collapsetext="Collapse attributes"> | |||
This section describes attributes that may provide additional information about how the data was processed and manipulated at this stage. | |||
{| class="wikitable" | |||
|- | |||
! Attribute name | |||
! Purpose | |||
! Suggested content | |||
|- | |||
| processing_level | |||
| Boilerplate about the content of the NetCDF group. | |||
| <blockquote>''This group includes the spectral observation and ancillary information required for estimatng the dissipation of turbulent kinetic energy by fitting the spectra's inertial subrange.''</blockquote> | |||
|- | |||
| spectral_calculation_type | |||
| | |||
| | |||
|- | |||
| spectral_windowing | |||
| | |||
| | |||
|- | |||
| spectral_fft_length | |||
| | |||
| | |||
|- | |||
| colspan="4" style="text-align:center; font-weight:bold; background-color:#f9eddd"| Optional group attributes <math>\ddagger</math> | |||
|- | |||
| stationarity_testing | |||
| | |||
| | |||
|- | |||
| noise_testing | |||
| | |||
| | |||
|- | |||
| comment (optional) | |||
| Any additional information pertinent to other users who test their algorithms against the file. | |||
| | |||
|} | |||
</div> | |||
---- | ---- | ||
Go back to the previous level: [[Level 2 segmented (velocity point-measurements)| Level 2 segmented]] | Go back to the previous level: [[Level 2 segmented (velocity point-measurements)| Level 2 segmented]] |
Revision as of 13:04, 16 December 2021
Page status: Draft | |
---|---|
Author(s): | Cynthia |
Reviewer(s): | |
Comment: |
The required dimensions and variables associated with the Level 3 spectra processing level (NetCDF group) for velocity measurements 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).
Dimensions
The number of velocity instruments (N_VEL_INSTRUMENT) is here for completeness, but the benchmarks examples will have measurements only from one instrument stored.
Short name | Standard name | Dimensions | Comments |
---|---|---|---|
TIME | time | TIME | Units in Days since 1950-01-01T00:00:00Z, time-centered |
FREQ | frequency | FREQ | Frequency in Hz for the spectra |
N_VEL_COMPONENT | unique_identifier_for_each_velocity_component | N_VEL_COMPONENT | Maximum of 3 for u,v, w (east, north, up) velocities |
N_VEL_INSTRUMENT | unique_identifier_for_each_velocity_instrument | N_VEL_INSTRUMENT | Required only if storing multiple synchronized instruments in the same file |
Variables
Short name | Standard name | Dimensions | Comment |
---|---|---|---|
UVW_VEL_SPEC | XXXX
_in_the_analysis_frame_or_reference |
TIME, FREQ, N_VEL_COMPONENT, N_VEL_INSTRUMENT | This may be rotated in the direction of the mean flow, or left in XYZ_VEL if relying only on the vertical component when estimating [math]\displaystyle{ \varepsilon }[/math]. Please specify the analysis frame of reference in the variable attribute and/or group's attribute. |
UVW_VEL_SPEC_FLAGS | status_flag | TIME, N_SAMPLE, N_VEL_COMPONENT, N_VEL_INSTRUMENT | Enumerated flag that denotes if and how missing samples were replaced |
HEIGHT or DEPTH[math]\displaystyle{ \dagger }[/math] | See Level 1 table | TIME, N_VEL_INSTRUMENT | |
Optional variables [math]\displaystyle{ \ddagger }[/math] | |||
BURST_NUMBER [math]\displaystyle{ \dagger\dagger }[/math] | unique_identifier_for_each_burst | TIME, N_VEL_INSTRUMENT | Only required when measuring in burst-mode. Integers of 1, 2, etc to designate which burst the velocities are associated with. |
[math]\displaystyle{ \ddagger }[/math] One could re-write for convenience the optional variables in Level 1 after segmenting them into smaller chunks. For instance, PRES (pressure) would be fairly common in surface wave studies. [math]\displaystyle{ \dagger }[/math] A variable situating the instruments in the water column is required. This may be a nominal depth (or height) or a time-varying depth or height above the bottom. [math]\displaystyle{ \dagger\dagger }[/math] 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. |
| |
spectral_calculation_type | |||
spectral_windowing | |||
spectral_fft_length | |||
Optional group attributes [math]\displaystyle{ \ddagger }[/math] | |||
stationarity_testing | |||
noise_testing | |||
comment (optional) | Any additional information pertinent to other users who test their algorithms against the file. |
Go back to the previous level: Level 2 segmented
Go to the next level: Level 4 dissipation estimates