Aktionen

NetCDF Synoptische Daten auf Profilen: Unterschied zwischen den Versionen

Aus BAWiki

imported>Lang Guenther
(Die LinkTitles-Erweiterung hat automatisch Links zu anderen Seiten hinzugefügt (<a target="_blank" rel="nofollow noreferrer noopener" class="external free" href="https://github.com/bovender/LinkTitles">https://github.com/bovender/LinkTitles</a>).)
 
(109 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:


Synoptische Daten auf mehreren Längs- und Querprofilen.
Synoptische Daten auf mehreren Längs- und Querprofilen.
<font color=red>'''Die nachfolgende Beschreibung ist noch unvollständig. So fehlen z. B. noch die Bezeichnungen für Marker und Positionen. '''</font>


=Weitere Beschreibungen=
=Weitere Beschreibungen=
* [[NetCDF Profile]]: Koordinaten, Topologie sowie Koordinatentransformation;
* [[NetCDF Profile]]: Koordinaten, Topologie sowie Koordinatentransformation der Profile.
* [[NetCDF Zeitkoordinate]]: Koordinatenvariable ''time'';
* [[NetCDF Zeitkoordinate]]: Koordinatenvariable ''time''.
* [[NetCDF Vertikalkoordinate]]: zeit- und ortsvariable Vertikalkoordinate ''depth_zt'':
* [[NetCDF Vertikalkoordinate]]: zeit- und ortsvariable Vertikalkoordinate.
*# Mesh1_node_depth_zt_2d(<font color=green>time</font>,nMesh1_layer_2d,nMesh1_node): für ''tiefengemittelte'' Daten an Knoten;
*# Mesh1_node_depth_zt_3d(<font color=green>time</font>,nMesh1_layer_3d,nMesh1_node): für ''tiefenstrukturierte'' Daten an Knoten;
*# Mesh1_edge_depth_zt_2d(<font color=green>time</font>,nMesh1_layer_2d,nMesh1_edge): für ''tiefengemittelte'' Daten an Kanten;
*# Mesh1_edge_depth_zt_3d(<font color=green>time</font>,nMesh1_layer_3d,nMesh1_edge): für ''tiefenstrukturierte'' Daten an Kanten.
*: ''Hinweis'': Für die tiefenstrukturierten Daten können die letzten beiden Dimensionen durch die komprimierte Dimension nMesh1_vedge (an Knoten) und nMesh1_face (an Kanten) ersetzt werden. Siehe hierzu auch unten unter [[#Datenkompression|Datenkompression]].
 
=Dimensionen=
 
Soweit nicht schon oben festgelegt, kommen noch folgende Dimensionen hinzu:
: dimensions:
:: nMesh1_node    = ''total number of nodes'' ;
:: nMesh1_edge    = ''total number of edges'' ;
:: nMesh1_prof    = ''total number of profiles'' ;
:: nMesh1_vedge    = ''total number of computational data above nodes'' ;
:: nMesh1_face    = ''total number of computational data above edges'' ;
:: nMesh1_strlen1  = ''maximum number of characters used in long names'' ;
:: nMesh1_strlen2  = ''maximum number of characters used in code names'' ;
:: nMesh1_strlen3  = ''maximum number of characters used in short names'' ;
:: nMesh1_layer_2d = ''number of vertical layers for depth averaged data'' ;
:: nMesh1_layer_3d = ''number of vertical layers for depth structured data'' ;
:: nMesh1_geo_loc  = ''number of geographic locations (Geopositionen)'' ;
 
=Profile=
==Langer Name==
:: char Mesh1_prof_long_name(nMesh1_prof,nMesh1_strlen1) ;
::: Mesh1_node_long_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_long_name:long_name = "long name of profile" ;
::: (optional) Mesh1_node_long_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_long_name:location = "prof" ;
::: Mesh1_node_long_name:mesh = "Mesh1" ;
::: Mesh1_node_long_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
==Code-Name==
::char Mesh1_prof_code_name(nMesh1_prof,nMesh1_strlen2) ;
::: Mesh1_node_code_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_code_name:long_name = "code name of profile" ;
::: (optional) Mesh1_node_code_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_code_name:location = "prof" ;
::: Mesh1_node_code_name:mesh = "Mesh1" ;
::: Mesh1_node_code_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
==Kurzer Name==
:: char Mesh1_prof_short_name(nMesh1_prof,nMesh1_strlen3) ;
::: Mesh1_node_short_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_short_name:long_name = "short name of profile" ;
::: (optional) Mesh1_node_short_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_short_name:location = "prof" ;
::: Mesh1_node_short_name:mesh = "Mesh1" ;
::: Mesh1_node_short_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
==Kennzeichnung des Profiltyps==
:: integer Mesh1_prof_type(nMesh1_prof) ;
::: Mesh1_prof_type:standard_name = "'''???'''" ; \\ yet to be defined   
::: Mesh1_prof_type:long_name = "type of profile, longitudinal section or cross section" ;
::: (optional) Mesh1_node_short_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_prof_type:_FillValue = ''fillvalue'' ;
::: Mesh1_prof_type:valid_range = 0, 1 ;
::: Mesh1_prof_type:valid_values = 0, 1 ;
::: Mesh1_prof_type:flag_meanings = "longitudinal_profile, cross_profile"
::: Mesh1_node_short_name:location = "prof" ;
::: Mesh1_node_short_name:mesh = "Mesh1" ;
::: Mesh1_node_short_name:grid_mapping = "crs" ;
 
=Geopositionen=
==Langer Name==
:: char Mesh1_prof_long_name(nMesh1_prof,nMesh1_strlen1) ;
::: Mesh1_node_long_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_long_name:long_name = "long name of profile" ;
::: (optional) Mesh1_node_long_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_long_name:location = "prof" ;
::: Mesh1_node_long_name:mesh = "Mesh1" ;
::: Mesh1_node_long_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
==Code-Name==
::char Mesh1_prof_code_name(nMesh1_prof,nMesh1_strlen2) ;
::: Mesh1_node_code_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_code_name:long_name = "code name of profile" ;
::: (optional) Mesh1_node_code_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_code_name:location = "prof" ;
::: Mesh1_node_code_name:mesh = "Mesh1" ;
::: Mesh1_node_code_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
==Kurzer Name==
:: char Mesh1_prof_short_name(nMesh1_prof,nMesh1_strlen3) ;
::: Mesh1_node_short_name:standard_name = "'''???'''" ; \\ no standard name available
::: Mesh1_node_short_name:long_name = "short name of profile" ;
::: (optional) Mesh1_node_short_name:coordinates = "Mesh1_prof_lon Mesh1_prof_lat Mesh1_prof_x Mesh1_prof_y" ;
::: Mesh1_node_short_name:location = "prof" ;
::: Mesh1_node_short_name:mesh = "Mesh1" ;
::: Mesh1_node_short_name:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Liegen repräsentative Koordinaten für die Profile vor, so können diese über ''coordinates'' zugeordnet werden. Kann ggf. zum Anbringen einer Beschriftung genutzt werden.
 
=Gewichte=
 
Gewichte werden insbesondere im Postprocessing benötigt, um abgeleitete Daten korrekt berechnen zu können, falls die hierfür relevanten Gewichtsfaktoren, hier Längen und Flächen, nicht in einfacher Weise aus den Koordinaten abgeleitet werden können. Die Verwendung von Gewichten bringt daher eine große Sicherheit in die späteren Weiterverarbeitung der Daten. Beispiele für abgeleitete Daten sind insbesondere Tiefenmittelwerte oder (spezifische) Durchflussberechnungen.
 
==Längen==
 
===Maximale Kantenlänge===
:: double Mesh1_edge_max_length_2d(nMesh1_edge) ;
::: Mesh1_edge_max_length_2d:standard_name = "'''???'''" ; \\ eventually not required 
::: Mesh1_edge_max_length_2d:long_name = "total length above 1D mesh edges, vertically integrated" ;   
::: Mesh1_edge_max_length_2d:units = "m" ;
::: Mesh1_edge_max_length_2d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat" ;
::: Mesh1_edge_max_length_2d:_FillValue = ''fillvalue'' ;
::: Mesh1_edge_max_length_2d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_edge_max_length_2d:mesh = "mesh1" ;
::: Mesh1_edge_max_length_2d:location = "edge"
::: Mesh1_edge_max_length_2d:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Bei klassischen Gitternetzen ist die maximale Länge einer durchströmten Kante im Berechnungsgitter und im geometrischen Gitter identisch.
::# In neueren Verfahren, wie z. B. UnTRIM<sup>2</sup>, kann die durchströmte Kante während der Berechnung allerdings kleiner als die maximale (geometrische) Länge sein.
 
===Nasse Kantenlänge===
:: double Mesh1_edge_wet_length_2d(time,nMesh1_edge) ;
::: Mesh1_edge_wet_length_2d:standard_name = "'''???'''" ; \\ eventually not required 
::: Mesh1_edge_wet_length_2d:long_name = "wet length above 1D mesh edges, vertically integrated" ;   
::: Mesh1_edge_wet_length_2d:units = "m" ;
::: Mesh1_edge_wet_length_2d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat" ;
::: Mesh1_edge_wet_length_2d:_FillValue = ''fillvalue'' ;
::: Mesh1_edge_wet_length_2d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_edge_wet_length_2d:mesh = "mesh1" ;
::: Mesh1_edge_wet_length_2d:location = "edge"
::: Mesh1_edge_wet_length_2d:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Bei klassischen Gitternetzen ist die nasse, also von Wasser bedeckte Kantenlänge entweder Null oder gleich der maximalen Kantenlänge.
::# In neueren Verfahren, wie z. B. UnTRIM<sup>2</sup>, kann die nasse Kantenlänge hingegen kontinuierlich zwischen Null und der maximalen Kantenlänge je nach dem Grad der Wasserbedeckung, in stark nichtlinearer Weise variieren.
 
===Durchflusshöhe an Knoten===
:: double Mesh1_node_water_depth_2d(time,nMesh1_node) ;
::: Mesh1_node_water_depth_2d:standard_name = "'''sea_floor_depth_below_sea_surface'''" ; 
::: Mesh1_node_water_depth_2d:long_name = "water depth at 1D mesh nodes, vertically integrated" ;   
::: Mesh1_node_water_depth_2d:units = "m" ;
::: Mesh1_node_water_depth_2d:coordinates = "Mesh1_node_lon Mesh1_node_lat" ;
::: Mesh1_node_water_depth_2d:_FillValue = ''fillvalue'' ;
::: Mesh1_node_water_depth_2d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_node_water_depth_2d:mesh = "mesh1" ;
::: Mesh1_node_water_depth_2d:location = "node"
::: Mesh1_node_water_depth_2d:grid_mapping = "crs" ;
::''Hinweise'':
::# Entspricht der Wassertiefe an den Positionen.
 
===Durchflusshöhe an Knoten, differenziert nach Schichten===
:: double Mesh1_node_water_depth_3d(time,nMesh1_vedge) ;
::: Mesh1_node_water_depth_3d:standard_name = "'''???'''" ; 
::: Mesh1_node_water_depth_3d:long_name = "water depth at 1D mesh nodes, vertically structured" ;   
::: Mesh1_node_water_depth_3d:units = "m" ;
::: Mesh1_node_water_depth_3d:coordinates = "Mesh1_node_lon Mesh1_node_lat" ;
::: Mesh1_node_water_depth_3d:_FillValue = ''fillvalue'' ;
::: Mesh1_node_water_depth_3d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_node_water_depth_3d:mesh = "mesh1" ;
::: Mesh1_node_water_depth_3d:location = "node"
::: Mesh1_node_water_depth_3d:grid_mapping = "crs" ;
::''Hinweise'':
::# Die Wassertiefe in den einzelnen Schichten ist bei Verwendung von z-Schichten sowohl vom Wasserstand, der Lage der Gewässersohle, und zusätzlich noch von der Position der z-Schichten abhängig.
::# Diese Daten sind für einen Postprozessor nur unter Kenntnis der in dem erzeugenden HN-Verfahren benutzten Algorithmen exakt rekonstruierbar.
 
==Flächen==
===Durchflussfläche über Kanten===
:: double Mesh1_face_flow_area_2d(time,nMesh1_edge) ;
::: Mesh1_face_flow_area_2d:standard_name = "'''???'''" ; \\ eventually not required 
::: Mesh1_face_flow_area_2d:long_name = "flow area above 1D mesh edges, vertically integrated" ;   
::: Mesh1_face_flow_area_2d:units = "m2" ;
::: Mesh1_face_flow_area_2d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat" ;
::: Mesh1_face_flow_area_2d:_FillValue = ''fillvalue'' ;
::: Mesh1_face_flow_area_2d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_face_flow_area_2d:mesh = "mesh1" ;
::: Mesh1_face_flow_area_2d:location = "edge"
::: Mesh1_face_flow_area_2d:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Bei klassischen Gitternetzen entspricht die von Wasser durchflossene Fläche über einer Kante dem Produkt aus maximaler Kantenlänge und Wasserbedeckung.
::# In neueren Verfahren, wie z. B. UnTRIM<sup>2</sup>, hängt die durchströmte Fläche über einer Kante in stark nichtlinearer Weise vom Grad der Wasserbedeckung ab, und kann daher nicht einfach rekonstruiert werden.
 
===Durchflussfläche über Kanten, differenziert nach Schichten===
:: double Mesh1_face_flow_area_3d(time,nMesh1_face) ;
::: Mesh1_face_flow_area_3d:standard_name = "'''???'''" ; \\ eventually not required 
::: Mesh1_face_flow_area_3d:long_name = "flow area above 1D mesh edges, vertically structured" ;   
::: Mesh1_face_flow_area_3d:units = "m2" ;
::: Mesh1_face_flow_area_3d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat" ;
::: Mesh1_face_flow_area_3d:_FillValue = ''fillvalue'' ;
::: Mesh1_face_flow_area_3d:valid_range = ''valid minimum'', ''valid maximum'' ;
::: Mesh1_face_flow_area_3d:mesh = "mesh1" ;
::: Mesh1_face_flow_area_3d:location = "edge"
::: Mesh1_face_flow_area_3d:grid_mapping = "crs" ;
:: ''Hinweise'':
::# Die in einer z-Schicht von Wasser durchflossene Fläche ist eine Funktion des Wasserstands, der Lage der Gewässersohle, sowie der Lage der z-Schichten.
::# Insbesondere in neueren Verfahren, wie z. B. UnTRIM<sup>2</sup>, hängt die durchströmte Fläche in stark nichtlinearer Weise vom Grad der Wasserbedeckung ab, und kann daher nicht einfach rekonstruiert werden.


=Aktuelle (zeitvariable) Topografie=
=Version ''Discrete Sampling Geometry'' '''trajectoryProfile'''=
Es werden hier Angaben nur für zeitvariable Topografie gemacht. Bei stationärer Topografie entfällt die Dimension ''time''.
==Knoten==
Analog zu [[#Durchflusshöhe an Knoten|Durchflusshöhe an Knoten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
::: Mesh1_node_depth:standard_name = "'''sea_floor_depth_below_geoid'''" ;   
::: Mesh1_node_depth:long_name = "sea floor depth at 1D mesh nodes" ;   
::: Mesh1_node_depth:units = "m" ;


==Kanten==
Zur Ablage von Daten auf einem oder mehreren Profilen wird die in CF beschriebene ''Discrete Sampling Geometry'' mit '''featureType=trajectoryProfile''' verwendet. Ein Beispiel (NCDUMP) für Geometrie und Daten ist in  [[Medium:P_synop_ncdump_2D.pdf|P_synop_ncdump_2D.pdf]] zu sehen.
Analog zu [[#Durchflussfläche über Kanten|Durchflussfläche über Kanten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
::: Mesh1_edge_depth:standard_name = "'''sea_floor_depth_below_geoid'''" ;   
::: Mesh1_edge_depth:long_name = "sea floor depth for 1D mesh edges" ;   
::: Mesh1_edge_depth:units = "m" ;
::: Mesh1_edge_depth:cell_methods = "nMesh1_edge: mean" ;
::: Mesh1_edge_depth:cell_measures = "<font color=red>length</font>: Mesh1_edge_max_length_2d" ;
:: ''Hinweise'':
::# Hier entspricht die Tiefe der mittleren Tiefe entlang der Kante.
::# Im Einzelfall kann es sinnvoll sein, den Maximalwert zu verwenden. Dann müsste in dem Attribut ''cell_methods'' der Wert "max" an Stelle von "mean" benutzt werden. Bei Bedarf müsste eine zweite, zusätzliche Variable ausgegeben werden.


=Maximale zulässige Tiefe=
Daten dieses Typs stimmem im Wesentlichen mit [[NetCDF Synoptische Daten an Einzelpositionen]] überein. Auf die wesentlichen Unterschiede, die allen geophysikalischen Variablen gemein sind, wird am Beispiel der Variable für den [[Wasserstand]] eingegangen.


* Vollständig analog zu ''Aktuelle Tiefe'' vorgehen, jedoch ohne Dimension ''time''.
float Mesh0_node_[[Wasserstand]]_2d(nMesh0_data_time, nMesh0_trajectory, nMaxMesh0_trajectory_nodes) ;
* Vorschlag für die Namensgebung:
: :long_name = "[[Wasserstand]] [ node ]" ;
** Knoten: "Mesh1_node_max_depth(nMesh1_node)" , und
: :units = "m" ;
** Kanten: "Mesh1_edge_max_depth(nMesh1_edge)" .
: :name_id = 3 ;
*:''Hinweise'':  
: :_FillValue = 1.e+31f ;
*# Die in einer Gitterdatei, z. B. [[NetCDF Profile]], abgelegte Tiefe wird derzeit in BAW-Anwendungen unterschiedlich interpretiert:
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
*#* aktuelle bzw. für einen bestimmten Zeitraum gültige Tiefe, oder
: :cell_measures = "area: Mesh0_node_Wasserflaeche_2d" ;
*#* Tiefe der nicht weiter erodierbaren Schicht.
: :cell_methods = "nMesh0_data_time: point area: mean" ;
*#: Hierfür müssen unterschiedliche Standardnamen gewählt werden, um die jeweilige Bedeutung korrekt zu beschreiben.
: :comment = "ancillary variables may be used for visualization and data analysis as threshold and plot subgrid mask" ;
*# Es erscheint sinnvoll, dass diese Variable in jedem Fall die Zeit als Koordinate enthält, da die gespeicherten Daten i.d.R. immer für einen bestimmten Termin oder Zeitraum (''Bounds'') gelten.
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_trajectory_long_name Mesh0_trajectory_node_distance" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_surface_height" ;


=Wasserstand=
Die wesentlichen Unterschiede zu der entsprechenden Variablen für Einzelpositionen sind:
# Es sind zwei an Stelle einer (Horizontal-) Dimension vorhanden: ''nMesh0_trajectory'' für die Anzahl der Profile und ''nMaxMesh0_trajectory_nodes'' für die (maximale) Anzahl der Positionen entlang eines Profils. Hierdurch kann auf die Daten eines Profils sehr einfach zugegriffen werden.
# Es existiert eine weitere Hilfs-Koordinatenvariable '''Mesh0_trajectory_node_distance'''. Diese ermöglicht die einfache Auftragung der Daten eines Profils in Abhängigkeit von der Koordinate Profil-Meter.


Typischer Weise liegt der Wasserstand entweder (punktweise) am Knoten oder konstant entlang einer Kante vor.
=Version [[DATACONVERT]]=


==Knoten==
==Dimensionen==
Analog zu [[#Durchflusshöhe an Knoten|Durchflusshöhe an Knoten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
::: Mesh1_node_water_level:standard_name = "'''sea_surface_height_above_geoid'''" ;   
::: Mesh1_node_water_level:long_name = "water level for 1D mesh nodes" ;   
::: Mesh1_node_water_level:units = "m" ;


==Kanten==
# '''nMesh1_node''' = Anzahl der Profilknoten.
Analog zu [[#Durchflussfläche über Kanten|Durchflussfläche über Kanten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
# '''nMesh1_data_node''' = Anzahl der Profilknoten mit Daten.
::: Mesh1_edge_water_level:standard_name = "'''sea_surface_height_above_geoid'''" ;   
# '''nMesh1_edge''' = Anzahl der Profilkanten.
::: Mesh1_edge_water_level:long_name = "water level for 1D mesh edges" ;   
# '''nMesh1_prof''' = Anzahl der Profile.
::: Mesh1_edge_water_level:units = "m" ;
# '''nMesh1_strlen0''' = max. Anzahl der Zeichen für Dateinamen.
::: Mesh1_edge_water_level:cell_methods = "nMesh1_edge: mean"
# '''nMesh1_strlen1''' = max. Anzahl der Zeichen für lange Namen.
::: Mesh1_edge_water_level:cell_measures = "<font color=red>length</font>: Mesh1_edge_wet_length_2d" ;
# '''nMesh1_strlen2''' = max. Anzahl der Zeichen für Code-Bezeichnungen.
:: ''Hinweise'':
# '''nMesh1_strlen3''' = max. Anzahl der Zeichen für Kurzbezeichnungen.
::# Hier entspricht der Wasserstand dem mittleren Wasserstand entlang der (nassen) Kante.
# '''nMesh1_time''' = Anzahl der Zeitpunkte (Gitterdatei).
# '''nMehs1_data_time''' = UNLIMITED-Dimension, Anzahl der synoptischen Datensätze.
# '''nMesh1_layer_2d''' = Anzahl der Schichten für tiefengemittelte Daten.
# '''nMesh1_layer_3d''' = Anzahl der Schichten für tiefenstrukturierte Daten.
# '''nMaxMesh1_prof_edges''' = maximale Anzahl der Kanten eines Profils.
# '''nMaxMesh1_prof_nodes''' = maximale Anzahl der Knoten eines Profils.


=Tiefengemittelter Salzgehalt=
==Geo-Positionen==


==Knoten==
Obwohl die Anzahl der Geopositionen in der Regel sehr viel kleiner als die Anzahl der Knoten (aller Profile) ist, werden die nachfolgenden Felder ohne komprimierte Dimension deklariert, um Probleme beim Verwenden komprimierter Variablen auszuschließen.
Analog zu [[#Durchflusshöhe an Knoten|Durchflusshöhe an Knoten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
:: double Mesh1_node_salinity_2d(time,nMesh1_layer_2d,nMesh1_node) ;
::: Mesh1_node_salinity_2d:standard_name = "'''sea_water_salinity'''" ;   
::: Mesh1_node_salinity_2d:long_name = "salinity at 1D mesh nodes, depth averaged" ;   
::: Mesh1_node_salinity_2d:units = "0.001" ;
::: Mesh1_node_salinity_2d:coordinates = "Mesh1_node_lon Mesh1_node_lat Mesh1_node_depth_zt_2d" ;
::: Mesh1_node_salinity_2d:cell_methods = "nMesh1_layer_2d: mean" ;
::: Mesh1_node_salinity_2d:cell_measures = "<font color=red>length</font>: Mesh1_node_water_depth_2d" ;
:: ''Hinweise'':
::# Die Verwendung der ''Measure'' Variablen "[[#Durchflusshöhe an Knoten|Durchflusshöhe an Knoten]]" wird für eine sichere Interpretation der Daten im Post-Prozessing empfohlen.


==Kanten==
===Langer Name===
Analog zu [[#Durchflussfläche über Kanten|Durchflussfläche über Kanten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
char Mesh1_node_gp_long_name(nMesh1_node, nMesh1_strlen1) ;  
:: double Mesh1_node_salinity_2d(time,nMesh1_layer_2d,nMesh1_edge) ;  
: Mesh1_node_gp_long_name:long_name = "Name der Geoposition" ;  
::: Mesh1_edge_salinity_2d:standard_name = "'''sea_water_salinity'''" ;  
: Mesh1_node_gp_long_name:name_id = 1395 ;
::: Mesh1_edge_salinity_2d:long_name = "salinity at 1D mesh edges, depth averaged" ;  
: Mesh1_node_gp_long_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
::: Mesh1_edge_salinity_2d:units = "0.001" ;
: Mesh1_node_gp_long_name:_FillValue = "?" ;  
::: Mesh1_edge_salinity_2d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat Mesh1_edge_depth_zt_2d" ;
: Mesh1_node_gp_long_name:location = "node" ;
::: Mesh1_edge_salinity_2d:cell_methods = "nMesh1_layer_2d: mean" ;
: Mesh1_node_gp_long_name:mesh = "Mesh1" ;  
::: Mesh1_edge_salinity_2d:cell_measures = "area: Mesh1_face_flow_area_2d" ;
: Mesh1_node_gp_long_name:grid_mapping = "Mesh1_crs" ;  
:: ''Hinweise'':
Hinweise:
::# Die Verwendung der ''Measure'' Variablen "[[#Durchflussfläche über Kanten|Durchflussfläche über Kanten]]" wird für eine sichere Interpretation der Daten im Post-Prozessing empfohlen.
# Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-[[Kennung]] der Variablen.
# Für die meisten Knoten liegt keine gültige Bezeichnung vor.
# Diese Variable soll nicht als Koordinatenvariable verwendet werden, daher kann das Attribut "_FillValue" verwendet werden.  


=Tiefenstrukturierter Salzgehalt=
===Code-Name===
char Mesh1_node_gp_code_name(nMesh1_node, nMesh1_strlen2) ;
: Mesh1_node_gp_code_name:long_name = "[[Kennung]] der Geoposition" ;
: Mesh1_node_gp_code_name:name_id = 1394 ;
: Mesh1_node_gp_code_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
: Mesh1_node_gp_code_name:_FillValue = "?" ;
: Mesh1_node_gp_code_name:location = "node" ;
: Mesh1_node_gp_code_name:mesh = "Mesh1" ;
: Mesh1_node_gp_code_name:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-[[Kennung]] der Variablen.
# Für die meisten Knoten liegt keine gültige Bezeichnung vor.


==Knoten==
===Kurzer Name===
Analog zu [[#Durchflusshöhe an Knoten, differenziert nach Schichten|Durchflusshöhe an Knoten, differenziert nach Schichten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
char Mesh1_node_gp_short_name(nMesh1_node, nMesh1_strlen3) ;  
:: double Mesh1_node_salinity_3d(time,nMesh1_vedge) ; \\ compression used
: Mesh1_node_gp_short_name:long_name = "Kuerzel der Geoposition" ;  
:: double Mesh1_node_salinity_3d(time,nMesh1_layer_3d,nMesh1_node) ; \\ uncompressed definition
: Mesh1_node_gp_short_name:name_id = 1396 ;  
::: Mesh1_node_salinity_3d:standard_name = "'''sea_water_salinity'''" ;  
: Mesh1_node_gp_short_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;  
::: Mesh1_node_salinity_3d:long_name = "salinity at 1D mesh nodes, vertically structured" ;  
: Mesh1_node_gp_short_name:_FillValue = "?" ;  
::: Mesh1_node_salinity_3d:units = "0.001" ;
: Mesh1_node_gp_short_name:location = "node" ;
::: Mesh1_node_salinity_3d:coordinates = "Mesh1_node_lon Mesh1_node_lat Mesh1_node_depth_zt_3d" ;
: Mesh1_node_gp_short_name:mesh = "Mesh1" ;  
::: Mesh1_node_salinity_3d:cell_methods = "nMesh1_layer_3d: mean" ;
: Mesh1_node_gp_short_name:grid_mapping = "Mesh1_crs" ;
::: Mesh1_node_salinity_3d:cell_measures = "<font color=red>length</font>: Mesh1_node_water_depth_3d" ;
Hinweise:
::''Hinweise'':
# Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-[[Kennung]] der Variablen.
::# Die Verwendung der ''Measure'' Variablen "[[#Durchflusshöhe an Knoten, differenziert nach Schichten|Durchflusshöhe an Knoten, differenziert nach Schichten]]" wird für eine sichere Interpretation der Daten im Post-Prozessing empfohlen.
# Für die meisten Knoten liegt keine gültige Bezeichnung vor.
:: ''Fragen'':
::# Was muss in ''cell_methods'' korrekt verwendet werden, um über eine Schicht gemittelte Daten zu bezeichnen? Beziehen sich die Angaben auf die Dimensionen der dekomprimierten Variablen?


==Kanten==
===Geopositions-Identifikationsnummer===
Analog zu [[#Durchflussfläche über Kanten, differenziert nach Schichten|Durchflussfläche über Kanten, differenziert nach Schichten]] definieren, jedoch mit folgenden Änderungen in den Attributen:
int Mesh1_node_gp_id(nMesh1_node) ;  
:: double Mesh1_edge_salinity_3d(time,nMesh1_face) ; \\ compression used
: Mesh1_node_gp_id:long_name = "Identifikationsnummer der Geoposition eines Profilknotens" ;  
:: double Mesh1_edge_salinity_3d(time,nMesh1_layer_3d,nMesh1_edge) ; \\ uncompressed definition
: Mesh1_node_gp_id:name_id = -999 ;
::: Mesh1_edge_salinity_3d:standard_name = "'''sea_water_salinity'''" ;  
: Mesh1_node_gp_id:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;  
::: Mesh1_edge_salinity_3d:long_name = "salinity at 1D mesh edges, vertically structured" ;  
: Mesh1_node_gp_id:valid_range = 1, 100000 ;  
::: Mesh1_edge_salinity_3d:units = "0.001" ;
: Mesh1_node_gp_id:_FillValue = -999 ;  
::: Mesh1_edge_salinity_3d:coordinates = "Mesh1_edge_lon Mesh1_edge_lat Mesh1_edge_depth_zt_3d" ;
: Mesh1_node_gp_id:location = "node" ;
::: Mesh1_edge_salinity_3d:cell_methods = "nMesh1_layer_3d: mean" ;
: Mesh1_node_gp_id:mesh = "Mesh1" ;  
::: Mesh1_edge_salinity_3d:cell_measures = "area: Mesh1_face_flow_area_3d" ;
: Mesh1_node_gp_id:grid_mapping = "Mesh1_crs" ;  
::# Die Verwendung der ''Measure'' Variablen "[[#Durchflussfläche über Kanten, differenziert nach Schichten|Durchflussfläche über Kanten, differenziert nach Schichten]]" wird für eine sichere Interpretation der Daten im Post-Prozessing empfohlen.
Hinweise:
:: ''Fragen'':
# Für das Attribut "name_id" liegt noch keine (BAW) PHYDEF-Code-[[Kennung]] vor.
::# Was muss in ''cell_methods'' korrekt verwendet werden, um über eine Schicht gemittelte Daten zu bezeichnen? Beziehen sich die Angaben auf die Dimensionen der dekomprimierten Variablen?
# Für die meisten Knoten liegt keine gültige Bezeichnung vor.


=Tiefengemittelte Strömungsgeschwindigkeit=
==Geo-Profile==
Eine Datei wird i. d. R. mehrere Profile enthalten, die durch ein entsprechendes
[[NetCDF Profile#Kantenverzeichnis der Profile|Kantenverzeichnis der Profile]] beschrieben werden.<br>
Die Variable mit dem [[NetCDF Profile#Namensverzeichnis der Profile|Namensverzeichnis der Profile]]
übernimmt die Rolle einer Koordinatenvariable und erlaubt es die Profile über ihren langen Namen zu identifizieren.
===Code-Name===
char Mesh1_prof_code_name(nMesh1_prof, nMesh1_strlen2) ;
: Mesh1_prof_code_name:long_name = "[[Kennung]] eines Profils" ;
: Mesh1_prof_code_name:name_id = -999 ;
: Mesh1_prof_code_name:coordinates = "Mesh1_prof_long_name" ;
: Mesh1_prof_code_name:_FillValue = "?" ;
: Mesh1_prof_code_name:location = "prof" ;
: Mesh1_prof_code_name:mesh = "Mesh1" ;
: Mesh1_prof_code_name:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].


==Knoten==
===Kurzer Name===
Analog zu [[#Tiefengemittelter Salzgehalt|Tiefengemittelter Salzgehalt (Knoten)]] definieren, jedoch mit folgenden Änderungen in den Attributen:  
char Mesh1_prof_short_name(nMesh1_prof, nMesh1_strlen3) ;
::: Mesh1_node_velocity_x_2d:standard_name = "'''sea_water_x_velocity'''" ; \\ or better '''eastward_sea_water_velocity'''
: Mesh1_prof_short_name:long_name = "Kuerzel eines Profils" ;
::: Mesh1_node_velocity_x_2d:long_name = "current velocity in x-direction at 1D mesh nodes, depth integrated" ;  
: Mesh1_prof_short_name:name_id = -999 ;
::: Mesh1_node_velocity_x_2d:units = "m s-1" ;
: Mesh1_prof_short_name:coordinates = "Mesh1_prof_long_name" ;  
:: ''Bemerkung: y-Komponente '''sea_water_y_velocity''' ('''northward_sea_water_velocity''') analog''.
: Mesh1_prof_short_name:_FillValue = "?" ;
: Mesh1_prof_short_name:location = "prof" ;  
: Mesh1_prof_short_name:mesh = "Mesh1" ;
: Mesh1_prof_short_name:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].


==Kanten==
===Profil-Identifikationsnummer===
Analog zu [[#Tiefengemittelter Salzgehalt|Tiefengemittelter Salzgehalt (Kanten)]] definieren, jedoch mit folgenden Änderungen in den Attributen:  
int Mesh1_prof_id(nMesh1_prof) ;
::: Mesh1_edge_velocity_x_2d:standard_name = "'''sea_water_x_velocity'''" ; \\ or better '''eastward_sea_water_velocity'''
: Mesh1_prof_id:long_name = "Identifikationsnummer eines Profils" ;
::: Mesh1_edge_velocity_x_2d:long_name = "current velocity in x-direction for 1D mesh edges, depth integrated" ;  
: Mesh1_prof_id:name_id = -999 ;
::: Mesh1_edge_velocity_x_2d:units = "m s-1" ;
: Mesh1_prof_id:coordinates = "Mesh1_prof_long_name" ;  
:: ''Bemerkung: y-Komponente '''sea_water_y_velocity''' ('''northward_sea_water_velocity''') analog''.
: Mesh1_prof_id:valid_range = 1, 100000 ;
: Mesh1_prof_id:_FillValue = -999 ;  
: Mesh1_prof_id:location = "prof" ;
: Mesh1_prof_id:mesh = "Mesh1" ;  
: Mesh1_prof_id:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].


Falls die Normalkomponente der Strömungsgeschwindigkeit ebenfalls ausgegeben werden soll, so kann diese analog zu oben mit folgenden Änderungen an den Attributen definiert werden:  
===Profiltyp===
::: Mesh1_edge_velocity_n_2d:standard_name = "'''???'''" ;  
int Mesh1_prof_type(nMesh1_prof) ;
::: Mesh1_edge_velocity_n_2d:long_name = "normal current velocity for 1D mesh edges, depth integrated" ;  
: Mesh1_prof_type:long_name = "Typ des Profils" ;
::: Mesh1_edge_velocity_n_2d:units = "m s-1" ;
: Mesh1_prof_type:name_id = -999 ;
: Mesh1_prof_type:coordinates = "Mesh1_prof_long_name" ;
: Mesh1_prof_type:valid_range = 0, 1 ;
: Mesh1_prof_type:_FillValue = -999 ;
: Mesh1_prof_type:flag_values = 0, 1 ;
: Mesh1_prof_type:flag_meanings = "longitudinal_profile cross_profile" ;
: Mesh1_prof_type:location = "prof" ;
: Mesh1_prof_type:mesh = "Mesh1" ;  
: Mesh1_prof_type:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Gültige Indizes beginnen hier mit Null!
# Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].
# Kann in einer anderen Variablen mit dem Attribut "ancillary_variables" referenziert werden.


=Tiefenstrukturierte Strömungsgeschwindigkeit=
==Marker==


==Knoten==
===Markertyp===
Analog zu [[#Tiefenstrukturierter Salzgehalt|Tiefenstrukturierter Salzgehalt (Knoten)]] definieren, jedoch mit folgenden Änderungen in den Attributen:
int Mesh1_node_marker_type(nMesh1_node) ;
:: double Mesh1_node_velocity_x_3d(time,nMesh1_vedge) ; \\ compression used
: Mesh1_node_marker_type:long_name = "Marker-Information der Profilknoten" ;
:: double Mesh1_node_velocity_x_3d(time,nMesh1_layer_3d,nMesh1_node) ; \\ uncompressed definition
: Mesh1_node_marker_type:name_id = -999 ;  
::: Mesh1_node_velocity_x_3d:standard_name = "'''sea_water_x_velocity'''" ; \\ or better '''eastward_sea_water_velocity'''
: Mesh1_node_marker_type:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;  
::: Mesh1_node_velocity_x_3d:long_name = "current velocity in x-direction at 1D mesh nodes, vertically structured" ;  
: Mesh1_node_marker_type:valid_range = 0, 7 ;
::: Mesh1_node_velocity_x_3d:units = "m s-1" ;
: Mesh1_node_marker_type:_FillValue = -999 ;  
:: ''Bemerkung: y-Komponente '''sea_water_y_velocity''' ('''northward_sea_water_velocity''') analog''.
: Mesh1_node_marker_type:flag_values = 0, 1, 2, 3, 4, 5, 6, 7 ;
: Mesh1_node_marker_type:flag_meanings = "PolPuMitDaten PolPuOhnDaten ZwiPuMitDaten ZwiPuOhnDaten PolExMitDaten PolExOhnDaten ZwiExMitDaten ZwiExOhnDaten" ;
: Mesh1_node_marker_type:location = "node" ;
: Mesh1_node_marker_type:mesh = "Mesh1" ;  
: Mesh1_node_marker_type:grid_mapping = "Mesh1_crs" ;
Hinweise:
# Gültige Indizes beginnen hier mit Null!
# Die fehlenden Komponenten der Struktur "geo_marker" (in P_GRID) müssen beim Lesen dynamisch ergänzt werden.
# Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].
# Kann in einer anderen Variablen mit dem Attribut "ancillary_variables" referenziert werden.
# Alle Knoten müssen über gültige Informationen verfügen.


Falls die Vertikalkomponente ebenfalls ausgegeben werden soll, so könnte diese mit folgenden Änderungen an den Attributen zu oben  formuliert werden:
==Daten an Knoten==
::: Mesh1_node_velocity_z_3d:standard_name = "'''upward_sea_water_velocity'''" ;  
===Profilmeter===
::: Mesh1_node_velocity_z_3d:long_name = "current velocity in z-direction at 1D mesh nodes, vertically structured" ;  
double Mesh1_prof_node_distance(nMesh1_prof,nMesh1_node) ;
::: Mesh1_node_velocity_z_3d:units = "m s-1" ;
: Mesh1_prof_node_distance:long_name = "Profilmeter - Abstand zum Profilanfang" ;
::: Mesh1_node_velocity_z_3d:coordinates = "Mesh1_node_lon Mesh1_node_lat" ;
: Mesh1_prof_node_distance:units = "m" ;
:: ''Hinweise'':
: Mesh1_prof_node_distance:name_id = -999 ;
::# Hier wird die Vertikalgeschwindigkeit als ''Mittelwert'' über jede Berechnungsschicht aufgefasst.
: Mesh1_prof_node_distance:valid_range = 0.0, 1000000.0 ;
::# Sollte die Vertikalgeschwindigkeit an den Schichtgrenzen benötigt werden, so müsste hierfür eine weitere (Hilfs-) Vertikalkoordinate benutzt werden.
: Mesh1_prof_node_distance:_FillValue = 1.e+31 ;
: Mesh1_prof_node_distance:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
: Mesh1_prof_node_distance:grid_mapping = "Mesh1_crs" ;
: Mesh1_prof_node_distance:standard_name = "???" ;
: Mesh1_prof_node_distance:comment = "distance along profile, with respect to origin of profile" ;
Hinweise:
# Da ein Knoten zu mehreren Profilen gehören kann, muss dieser Wert für alle Profile angegeben werden.
# Kann (als Koordinate) zur Darstellung von Daten entlang von Profilen benutzt werden.
# Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-[[Kennung]].


==Kanten==
===Sonstige===
Analog zu [[#Tiefenstrukturierter Salzgehalt|Tiefenstrukturierter Salzgehalt (Kanten)]] definieren, jedoch mit folgenden Änderungen in den Attributen:
Hinweise:
::: Mesh1_edge_velocity_x_3d:standard_name = "'''sea_water_x_velocity'''" ; \\ or better '''eastward_sea_water_velocity'''
# Es kann analog zu [[NetCDF Synoptische Daten an Einzelpositionen]] vorgegangen werden:
::: Mesh1_edge_velocity_x_3d:long_name = "current velocity in x-direction for 1D mesh edges, vertically structured" ;   
#* [[NetCDF Synoptische Daten an Einzelpositionen#Gewichte|Gewichte]],
::: Mesh1_edge_velocity_x_3d:units = "m s-1" ;
#* [[NetCDF Synoptische Daten an Einzelpositionen#Zeitkoordinaten|Zeitkoordinaten]],
:: ''Bemerkung: y-Komponente '''sea_water_y_velocity''' ('''northward_sea_water_velocity''') analog''.
#* [[NetCDF Synoptische Daten an Einzelpositionen#Vertikalkoordinaten|Vertikalkoordinaten]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Aktuelle (zeitvariable) Topografie|Topografie]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Maximale zulässige Tiefe|maximale zulässige Tiefe]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Wasserstand|Wasserstand]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefengemittelter Salzgehalt|Tiefengemittelter Salzgehalt]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefenstrukturierter Salzgehalt|Tiefenstrukturierter Salzgehalt]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefengemittelte Strömungsgeschwindigkeit|Tiefengemittelte Strömungsgeschwindigkeit]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefenstrukturierte Strömungsgeschwindigkeit|Tiefenstrukturierte Strömungsgeschwindigkeit]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Bezeichnung der Schwebstoffklassen|Bezeichnung der Schwebstoffklassen]],
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefengemittelter Schwebstoffgehalt|Tiefengemittelter Schwebstoffgehalt]], und
#* [[NetCDF Synoptische Daten an Einzelpositionen#Tiefenstrukturierter Schwebstoffgehalt|Tiefenstrukturierter Schwebstoffgehalt]].
# Um auf Daten einzelner Profile zugreifen zu können, kann (eine Label-Koordinate) "Mesh1_prof_long_name" nicht verwendet werden, da hierfür die Datenvariablen die Dimension nMesh1_prof enthalten müssten. Der Zugriff auf Daten einzelner Profile muss mit Hilfe der entsprechenden Konnektivitätslisten umgesetzt werden.


Falls die Vertikalkomponente der Strömungsgeschwindigkeit benötigt wird, so könnte man diese mit folgenden Abwandlungen zu oben beschreiben:
==Daten an Kanten==
::: Mesh1_edge_velocity_z_3d:standard_name = "'''upward_sea_water_velocity'''" ;
::: Mesh1_edge_velocity_z_3d:long_name = "current velocity in z-direction for 1D mesh edges, vertically structured" ;   
::: Mesh1_edge_velocity_z_3d:units = "m s-1" ;
:: ''Hinweise:''
::# Die Vertikalkomponente der Strömung wird hier als ''Mittelwert'' für jede schichtspezifische Durchflussfläche betrachtet. Dies mag nicht für alle Anwendungen ausreichend sein.


Falls die Normalkomponente der Strömungsgeschwindigkeit ebenfalls ausgegeben werden soll, so kann diese analog zu oben mit folgenden Änderungen an den Attributen definiert werden:  
Hinweise:
::: Mesh1_edge_velocity_n_3d:standard_name = "'''???'''" ; \\ compression used
# Bislang liegen keine Daten an Kanten vor. Dies wird sich wahrscheinlich mit Übergang zur SubGrid Technologie ändern.
::: Mesh1_edge_velocity_n_3d:long_name = "normal current velocity for 1D mesh edges, vertically structured" ;   
::: Mesh1_edge_velocity_n_3d:units = "m s-1" ;


=Anmerkungen, Fragen=
==Anmerkungen, Fragen==
* Datei ist nicht vollständig CF-konform. Für das Attribut ''cell_measures'' müsste ''<font color=red>depth</font>'' als Wert zugelassen werden. Allerdings ist ''depth'' ein [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/standard-name-table/15/cf-standard-name-table.html CF Standardname], und dann könnte dieser Wert doch gemäß Abschnitt 7.3.4 in der [http://cf-pcmdi.llnl.gov/documents/cf-conventions/1.4/cf-conventions.pdf CF-Metadaten Konvention] zulässig sein.
* Datei ist CF-konform gemäß [http://puma.nerc.ac.uk/cgi-bin/cf-checker.pl NCAS ''CF Compliance Checker''].
* Soll das BAW-Attribut ''name_id'' (für den Code) zusätzlich benutzt werden?
* Können wir Vektoren zwischen verschiedenen Koordinatensystemen transformieren, um z. B. aus der x- und der y-Komponente die Ostkomponente zu berechnen?
* Benötigen wir ID und COLOR noch (in dieser Datei)? (sind oben vernachlässigt).
----
----
zurück zu [[NetCDF]]
zurück zu [[NetCDF]]
----
----
[[Strukturübersicht]]
[[Strukturübersicht]]

Aktuelle Version vom 21. Oktober 2022, 09:29 Uhr

Kurze Beschreibung

Synoptische Daten auf mehreren Längs- und Querprofilen.

Weitere Beschreibungen

Version Discrete Sampling Geometry trajectoryProfile

Zur Ablage von Daten auf einem oder mehreren Profilen wird die in CF beschriebene Discrete Sampling Geometry mit featureType=trajectoryProfile verwendet. Ein Beispiel (NCDUMP) für Geometrie und Daten ist in P_synop_ncdump_2D.pdf zu sehen.

Daten dieses Typs stimmem im Wesentlichen mit NetCDF Synoptische Daten an Einzelpositionen überein. Auf die wesentlichen Unterschiede, die allen geophysikalischen Variablen gemein sind, wird am Beispiel der Variable für den Wasserstand eingegangen.

float Mesh0_node_Wasserstand_2d(nMesh0_data_time, nMesh0_trajectory, nMaxMesh0_trajectory_nodes) ;

:long_name = "Wasserstand [ node ]" ;
:units = "m" ;
:name_id = 3 ;
:_FillValue = 1.e+31f ;
:ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
:cell_measures = "area: Mesh0_node_Wasserflaeche_2d" ;
:cell_methods = "nMesh0_data_time: point area: mean" ;
:comment = "ancillary variables may be used for visualization and data analysis as threshold and plot subgrid mask" ;
:coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_trajectory_long_name Mesh0_trajectory_node_distance" ;
:grid_mapping = "Mesh0_crs" ;
:standard_name = "sea_surface_height" ;

Die wesentlichen Unterschiede zu der entsprechenden Variablen für Einzelpositionen sind:

  1. Es sind zwei an Stelle einer (Horizontal-) Dimension vorhanden: nMesh0_trajectory für die Anzahl der Profile und nMaxMesh0_trajectory_nodes für die (maximale) Anzahl der Positionen entlang eines Profils. Hierdurch kann auf die Daten eines Profils sehr einfach zugegriffen werden.
  2. Es existiert eine weitere Hilfs-Koordinatenvariable Mesh0_trajectory_node_distance. Diese ermöglicht die einfache Auftragung der Daten eines Profils in Abhängigkeit von der Koordinate Profil-Meter.

Version DATACONVERT

Dimensionen

  1. nMesh1_node = Anzahl der Profilknoten.
  2. nMesh1_data_node = Anzahl der Profilknoten mit Daten.
  3. nMesh1_edge = Anzahl der Profilkanten.
  4. nMesh1_prof = Anzahl der Profile.
  5. nMesh1_strlen0 = max. Anzahl der Zeichen für Dateinamen.
  6. nMesh1_strlen1 = max. Anzahl der Zeichen für lange Namen.
  7. nMesh1_strlen2 = max. Anzahl der Zeichen für Code-Bezeichnungen.
  8. nMesh1_strlen3 = max. Anzahl der Zeichen für Kurzbezeichnungen.
  9. nMesh1_time = Anzahl der Zeitpunkte (Gitterdatei).
  10. nMehs1_data_time = UNLIMITED-Dimension, Anzahl der synoptischen Datensätze.
  11. nMesh1_layer_2d = Anzahl der Schichten für tiefengemittelte Daten.
  12. nMesh1_layer_3d = Anzahl der Schichten für tiefenstrukturierte Daten.
  13. nMaxMesh1_prof_edges = maximale Anzahl der Kanten eines Profils.
  14. nMaxMesh1_prof_nodes = maximale Anzahl der Knoten eines Profils.

Geo-Positionen

Obwohl die Anzahl der Geopositionen in der Regel sehr viel kleiner als die Anzahl der Knoten (aller Profile) ist, werden die nachfolgenden Felder ohne komprimierte Dimension deklariert, um Probleme beim Verwenden komprimierter Variablen auszuschließen.

Langer Name

char Mesh1_node_gp_long_name(nMesh1_node, nMesh1_strlen1) ;

Mesh1_node_gp_long_name:long_name = "Name der Geoposition" ;
Mesh1_node_gp_long_name:name_id = 1395 ;
Mesh1_node_gp_long_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_node_gp_long_name:_FillValue = "?" ;
Mesh1_node_gp_long_name:location = "node" ;
Mesh1_node_gp_long_name:mesh = "Mesh1" ;
Mesh1_node_gp_long_name:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-Kennung der Variablen.
  2. Für die meisten Knoten liegt keine gültige Bezeichnung vor.
  3. Diese Variable soll nicht als Koordinatenvariable verwendet werden, daher kann das Attribut "_FillValue" verwendet werden.

Code-Name

char Mesh1_node_gp_code_name(nMesh1_node, nMesh1_strlen2) ;

Mesh1_node_gp_code_name:long_name = "Kennung der Geoposition" ;
Mesh1_node_gp_code_name:name_id = 1394 ;
Mesh1_node_gp_code_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_node_gp_code_name:_FillValue = "?" ;
Mesh1_node_gp_code_name:location = "node" ;
Mesh1_node_gp_code_name:mesh = "Mesh1" ;
Mesh1_node_gp_code_name:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-Kennung der Variablen.
  2. Für die meisten Knoten liegt keine gültige Bezeichnung vor.

Kurzer Name

char Mesh1_node_gp_short_name(nMesh1_node, nMesh1_strlen3) ;

Mesh1_node_gp_short_name:long_name = "Kuerzel der Geoposition" ;
Mesh1_node_gp_short_name:name_id = 1396 ;
Mesh1_node_gp_short_name:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_node_gp_short_name:_FillValue = "?" ;
Mesh1_node_gp_short_name:location = "node" ;
Mesh1_node_gp_short_name:mesh = "Mesh1" ;
Mesh1_node_gp_short_name:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-Kennung der Variablen.
  2. Für die meisten Knoten liegt keine gültige Bezeichnung vor.

Geopositions-Identifikationsnummer

int Mesh1_node_gp_id(nMesh1_node) ;

Mesh1_node_gp_id:long_name = "Identifikationsnummer der Geoposition eines Profilknotens" ;
Mesh1_node_gp_id:name_id = -999 ;
Mesh1_node_gp_id:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_node_gp_id:valid_range = 1, 100000 ;
Mesh1_node_gp_id:_FillValue = -999 ;
Mesh1_node_gp_id:location = "node" ;
Mesh1_node_gp_id:mesh = "Mesh1" ;
Mesh1_node_gp_id:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Für das Attribut "name_id" liegt noch keine (BAW) PHYDEF-Code-Kennung vor.
  2. Für die meisten Knoten liegt keine gültige Bezeichnung vor.

Geo-Profile

Eine Datei wird i. d. R. mehrere Profile enthalten, die durch ein entsprechendes Kantenverzeichnis der Profile beschrieben werden.
Die Variable mit dem Namensverzeichnis der Profile übernimmt die Rolle einer Koordinatenvariable und erlaubt es die Profile über ihren langen Namen zu identifizieren.

Code-Name

char Mesh1_prof_code_name(nMesh1_prof, nMesh1_strlen2) ;

Mesh1_prof_code_name:long_name = "Kennung eines Profils" ;
Mesh1_prof_code_name:name_id = -999 ;
Mesh1_prof_code_name:coordinates = "Mesh1_prof_long_name" ;
Mesh1_prof_code_name:_FillValue = "?" ;
Mesh1_prof_code_name:location = "prof" ;
Mesh1_prof_code_name:mesh = "Mesh1" ;
Mesh1_prof_code_name:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.

Kurzer Name

char Mesh1_prof_short_name(nMesh1_prof, nMesh1_strlen3) ;

Mesh1_prof_short_name:long_name = "Kuerzel eines Profils" ;
Mesh1_prof_short_name:name_id = -999 ;
Mesh1_prof_short_name:coordinates = "Mesh1_prof_long_name" ;
Mesh1_prof_short_name:_FillValue = "?" ;
Mesh1_prof_short_name:location = "prof" ;
Mesh1_prof_short_name:mesh = "Mesh1" ;
Mesh1_prof_short_name:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.

Profil-Identifikationsnummer

int Mesh1_prof_id(nMesh1_prof) ;

Mesh1_prof_id:long_name = "Identifikationsnummer eines Profils" ;
Mesh1_prof_id:name_id = -999 ;
Mesh1_prof_id:coordinates = "Mesh1_prof_long_name" ;
Mesh1_prof_id:valid_range = 1, 100000 ;
Mesh1_prof_id:_FillValue = -999 ;
Mesh1_prof_id:location = "prof" ;
Mesh1_prof_id:mesh = "Mesh1" ;
Mesh1_prof_id:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
  2. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.

Profiltyp

int Mesh1_prof_type(nMesh1_prof) ;

Mesh1_prof_type:long_name = "Typ des Profils" ;
Mesh1_prof_type:name_id = -999 ;
Mesh1_prof_type:coordinates = "Mesh1_prof_long_name" ;
Mesh1_prof_type:valid_range = 0, 1 ;
Mesh1_prof_type:_FillValue = -999 ;
Mesh1_prof_type:flag_values = 0, 1 ;
Mesh1_prof_type:flag_meanings = "longitudinal_profile cross_profile" ;
Mesh1_prof_type:location = "prof" ;
Mesh1_prof_type:mesh = "Mesh1" ;
Mesh1_prof_type:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Gültige Indizes beginnen hier mit Null!
  2. Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
  3. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.
  4. Kann in einer anderen Variablen mit dem Attribut "ancillary_variables" referenziert werden.

Marker

Markertyp

int Mesh1_node_marker_type(nMesh1_node) ;

Mesh1_node_marker_type:long_name = "Marker-Information der Profilknoten" ;
Mesh1_node_marker_type:name_id = -999 ;
Mesh1_node_marker_type:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_node_marker_type:valid_range = 0, 7 ;
Mesh1_node_marker_type:_FillValue = -999 ;
Mesh1_node_marker_type:flag_values = 0, 1, 2, 3, 4, 5, 6, 7 ;
Mesh1_node_marker_type:flag_meanings = "PolPuMitDaten PolPuOhnDaten ZwiPuMitDaten ZwiPuOhnDaten PolExMitDaten PolExOhnDaten ZwiExMitDaten ZwiExOhnDaten" ;
Mesh1_node_marker_type:location = "node" ;
Mesh1_node_marker_type:mesh = "Mesh1" ;
Mesh1_node_marker_type:grid_mapping = "Mesh1_crs" ;

Hinweise:

  1. Gültige Indizes beginnen hier mit Null!
  2. Die fehlenden Komponenten der Struktur "geo_marker" (in P_GRID) müssen beim Lesen dynamisch ergänzt werden.
  3. Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.
  4. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.
  5. Kann in einer anderen Variablen mit dem Attribut "ancillary_variables" referenziert werden.
  6. Alle Knoten müssen über gültige Informationen verfügen.

Daten an Knoten

Profilmeter

double Mesh1_prof_node_distance(nMesh1_prof,nMesh1_node) ;

Mesh1_prof_node_distance:long_name = "Profilmeter - Abstand zum Profilanfang" ;
Mesh1_prof_node_distance:units = "m" ;
Mesh1_prof_node_distance:name_id = -999 ;
Mesh1_prof_node_distance:valid_range = 0.0, 1000000.0 ;
Mesh1_prof_node_distance:_FillValue = 1.e+31 ;
Mesh1_prof_node_distance:coordinates = "Mesh1_node_x Mesh1_node_y Mesh1_node_lon Mesh1_node_lat" ;
Mesh1_prof_node_distance:grid_mapping = "Mesh1_crs" ;
Mesh1_prof_node_distance:standard_name = "???" ;
Mesh1_prof_node_distance:comment = "distance along profile, with respect to origin of profile" ;

Hinweise:

  1. Da ein Knoten zu mehreren Profilen gehören kann, muss dieser Wert für alle Profile angegeben werden.
  2. Kann (als Koordinate) zur Darstellung von Daten entlang von Profilen benutzt werden.
  3. Für das Attribut "name_id" gibt es noch keine gültige (BAW) PHYDEF-Code-Kennung.

Sonstige

Hinweise:

  1. Es kann analog zu NetCDF Synoptische Daten an Einzelpositionen vorgegangen werden:
  2. Um auf Daten einzelner Profile zugreifen zu können, kann (eine Label-Koordinate) "Mesh1_prof_long_name" nicht verwendet werden, da hierfür die Datenvariablen die Dimension nMesh1_prof enthalten müssten. Der Zugriff auf Daten einzelner Profile muss mit Hilfe der entsprechenden Konnektivitätslisten umgesetzt werden.

Daten an Kanten

Hinweise:

  1. Bislang liegen keine Daten an Kanten vor. Dies wird sich wahrscheinlich mit Übergang zur SubGrid Technologie ändern.

Anmerkungen, Fragen


zurück zu NetCDF


Strukturübersicht