NCPLOT.DAT

2022-11-10T13:53:21Z

Ak3spohr: neue Keys ab ncplot_2022_09_28 Teil 1

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=März 2022
|version_beschr=April 2022
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für die Bilddatei(en).
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.
* (optional) Key '''"Output_Format" :''' Ausgabeformat für die erzeugten Grafiken.
:*'''CGM''' = Von GKS erzeugtes binäres CGM-Format
:*'''SVG''' = Scalable Vector Graphics (XML-basiertes ASCII-Format)

===Block "SVG_Specifications"===
Optionaler Block mit Attributen für die Ausgabe der Grafik im SVG-Format.
* (optional) Key '''"SVG_Maximum_Size" :''' Maximale Ausdehnung der SVG-Grafik, d.h Faktor für die Umrechnung von NDC-Raum in GKS in den SVG-Raum.
* (optional) Key '''"SVG_Font_Family" :''' Schriftartbezeichnung(en), bzw. Wert für das SVG-Attribut ''font-family''. Wird dann bei allen Text-Elementen der SVG-Grafik gesetzt.
* (optional) Key '''"SVG_Free_Text_Attributes" :''' Schrift-Attribut(e), die ALLEN Texten der SVG-Grafik mitgegeben werden.
* (optional) Key '''"SVG_Axis_Text_by_Char" :''' Texte an Diagrammachsen zeichenweise schreiben (wie bei CGM-Format).
* (optional) Key '''"SVG_Legend_Box_by_Char" :''' Legendentexte von Liniendiagrammen zeichenweise schreiben (wie bei CGM-Format).

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!
* (optional) Key '''"Dataset_UUID_Textbox" :''' Textbox für Eintrag der UUID der NetCDF-Datei des Datasets.

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich grundsätzlich von den flächenhaften Achsendiagrammen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''. Konstante Faktoren in Rechenoperation möglich.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:*'''XY_data''' = Kartenansicht, Draufsicht-Darstellung, horizontale Ebene
:*'''PZ''' = Vertikalschnitt entlang Profil (3D-Daten)
:*'''TZ''' = Tiefenzeitreihe an einem Ort (3D-Daten)
:*'''PT''' = Hovmöller Variante 1: X-Achse=Profilachse (P), Y-Achse=Zeitachse (T)
:*'''TP''' = Hovmöller Variante 2: X-Achse=Zeitachse (T), Y-Achse=Profilachse (P)
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines (nur Layer_Type ''XY_data'')
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren (nur Layer_Type ''XY_data'')
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.
* (optional) Key '''"Layer_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"Layer_Legend_Number_Format" :''' Formatvorgabe für Zahlenwerte an der Farblegende.
* (optional) Key '''"Layer_ASCII_Output" :''' Dargestellte Daten des Layers in Textdatei ausgeben.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.
* (optional) Key '''"LineChart_FillArea_Between_Series" :''' Einfärben von Flächen zwischen zwei Datenreihen.
* (optional) Key '''"LineChart_FillArea_Series_Values" :''' Einfärben von Flächen zwischen einer Datenreihen und einem bestimmten Wert.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.
* (optional) Key '''"Axis_Number_Format" :''' Formatvorgabe für Zahlenwerte der Achsenskalierung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
:*'''Interpolation''' = eine gerade Linie schließt die Datenlücke der Kurve
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"DataRow_Linked_Textbox" :''' Name einer Textbox, die mit der Datenreihengruppe verknüpft wird.
* (optional) Key '''"DataRow_Legend_Box" :''' Name einer Legend_Box, in der die Kurvenlegenden für diese Datenreihengruppe platziert werden.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT.DAT

2022-04-20T12:30:50Z

Ak3spohr: Änderungen für Version ncplot_2022_03_29 eingepflegt

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=März 2022
|version_beschr=April 2022
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für die Bilddatei(en).
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.
* (optional) Key '''"Output_Format" :''' Ausgabeformat für die erzeugten Grafiken.
:*'''CGM''' = Von GKS erzeugtes binäres CGM-Format
:*'''SVG''' = Scalable Vector Graphics (XML-basiertes ASCII-Format)

===Block "SVG_Specifications"===
Optionaler Block mit Attributen für die Ausgabe der Grafik im SVG-Format.
* (optional) Key '''"SVG_Maximum_Size" :''' Maximale Ausdehnung der SVG-Grafik, d.h Faktor für die Umrechnung von NDC-Raum in GKS in den SVG-Raum.
* (optional) Key '''"SVG_Font_Family" :''' Schriftartbezeichnung(en), bzw. Wert für das SVG-Attribut ''font-family''. Wird dann bei allen Text-Elementen der SVG-Grafik gesetzt.
* (optional) Key '''"SVG_Free_Text_Attributes" :''' Schrift-Attribut(e), die ALLEN Texten der SVG-Grafik mitgegeben werden.
* (optional) Key '''"SVG_Axis_Text_by_Char" :''' Texte an Diagrammachsen zeichenweise schreiben (wie bei CGM-Format).
* (optional) Key '''"SVG_Legend_Box_by_Char" :''' Legendentexte von Liniendiagrammen zeichenweise schreiben (wie bei CGM-Format).

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich grundsätzlich von den flächenhaften Achsendiagrammen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''. Konstante Faktoren in Rechenoperation möglich.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:*'''XY_data''' = Kartenansicht, Draufsicht-Darstellung, horizontale Ebene
:*'''PZ''' = Vertikalschnitt entlang Profil (3D-Daten)
:*'''TZ''' = Tiefenzeitreihe an einem Ort (3D-Daten)
:*'''PT''' = Hovmöller Variante 1: X-Achse=Profilachse (P), Y-Achse=Zeitachse (T)
:*'''TP''' = Hovmöller Variante 2: X-Achse=Zeitachse (T), Y-Achse=Profilachse (P)
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines (nur Layer_Type ''XY_data'')
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren (nur Layer_Type ''XY_data'')
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.
* (optional) Key '''"Layer_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"Layer_Legend_Number_Format" :''' Formatvorgabe für Zahlenwerte an der Farblegende.
* (optional) Key '''"Layer_ASCII_Output" :''' Dargestellte Daten des Layers in Textdatei ausgeben.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.
* (optional) Key '''"LineChart_FillArea_Between_Series" :''' Einfärben von Flächen zwischen zwei Datenreihen.
* (optional) Key '''"LineChart_FillArea_Series_Values" :''' Einfärben von Flächen zwischen einer Datenreihen und einem bestimmten Wert.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.
* (optional) Key '''"Axis_Number_Format" :''' Formatvorgabe für Zahlenwerte der Achsenskalierung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
:*'''Interpolation''' = eine gerade Linie schließt die Datenlücke der Kurve
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT

2022-04-20T11:08:54Z

Ak3spohr: version aktualisiert

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=März 2022
|version_beschr=April 2022
|stichworte=Graphik-Postprozessor 
Darstellung von Berechnungsergebnissen 
CF-NetCDF-Format für 2D-/3D-Daten (unbekannte Attribute werden ignoriert) 
Finite Elemente Verfahren 
Finite Differenzen Verfahren 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Umrechnung bzw. Transformation (extensiv - intensiv) der physikalischen Einheit 
Verknüpfung mehrerer Eingangsgrößen zu einer neuen Größe für Darstellungszwecke 
(optional) Filterung der Darstellung basierend auf der Wassertiefe 
(optional) Filterung der Darstellung baiserend auf der Anzahl der Beobachtungen 

Danksagung: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''

|kurzbeschreibung=
Das Programm NCPLOT dient der Darstellung von Berechnungs- und Analyseergebnissen,
die im CF-NetCDF-Format abgelegt sind.
Die Daten können an Knoten (node), für Kanten (edge) oder für Polygone (face)
vorliegen. Es können 2D-, und 3D-Daten, sowie Daten mit subgridskaligen Details
verarbeitet werden. 
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT. 
[[Beispiel-Grafiken: NCPLOT|NCPLOT: Beispiel-Grafiken]]

Grundsätzlich unterscheidet NCPLOT linienhafte von flächenhaften Diagrammtypen.
Bei flächenhaften Diagrammen ist die Symbolisierung der Daten im Allgemeinen von
ihrem Wert abhängig (Farblegende, Proportionalpfeil).
Bei linienhaften Diagrammen werden die Werte von Datenreihen an einer Achse angetragen,
die Symbolisierung der Datenreihe ist vom Datenwert unabhängig. 

[[NCPLOT: Flächenhafte Diagramme|Flächenhafte Diagramme]]:
* Karte, bzw. Draufsicht-Darstellung
* Vertikalschnitt entlang Profil (3D-Daten)
* Tiefenzeitreihe an einem Ort (3D-Daten)
* Hovmöller: zeitliche Entwicklung über Profil

[[NCPLOT: Liniendiagramme|Liniendiagramme]]: 
* Zeitreihe
* Profildarstellung
* Tiefenprofil

NCPLOT erlaubt es auf einem Bild verschiedene Diagramme unterschiedlichen Typs
darzustellen. Liniendiagramme neben flächenhaften Darstellungen mit statischen
und ggf. dynamischen Anteilen.
 

Bildserien: 
Sowohl linien- als auch flächenhafte Diagrammdefinitionen können das Erstellen von
Bildserien anfordern. Ein Plot kann somit neben statischen auch dynamische, also
über die Bildserie veränderliche Bildanteile beinhalten.
 

Damit das Programm den sich dadurch ergebenden Kombinationsmöglichkeiten irgendwie
Herr wird, gilt folgende Regel: 
Sind dynamische Diagramm-Definitionen vorhanden, so bestimmt die zuerst gelesene
dynamische Definition die erlaubte Bildserien-Länge. Ergeben andere vorhandene
dynamische Diagramm-Definitionen eine abweichende Bildanzahl bricht das Programm ab.
 

Weitere Prüfungen hinsichtlich der Sinnhaftigkeit der Daten-Adressierung zwischen
beteiligten Bildelementen werden nicht vorgenommen.
 

Verschiedene Seriendiagramme aus dynamischen Diagramm-Defintionen gleicher
Länge werden vom Programm verarbeitet. Die statischen Bildelemente finden
sich dabei auf jedem Bild der Serie.
 

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCPLOT.DAT|ncplot.dat]])
# '''Berechnungs und/oder Analyseergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# Datei mit '''Intervalldefinitionen''' von Farblegenden ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# Datei mit '''Verweisen zu Palettendefinitionen''' ([[PALETTES.CFG.DAT|palettes.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
# Datei mit '''Farbdefinitionen''' ([[COLORS.CFG.DAT|colors.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.

Desweiteren werden von dem Programm NCPLOT folgende Standard-Konfigurationsdateien aus dem Verzeichnis
'''$PROGHOME/cfg/''' benötigt:
:* GKS-Parameter: '''gkssystem.rechnername.dat'''

|ausgabedateien=
# '''Grafikdatei(en)''' (Format: CGM oder SVG) Hinweis: Die erzeugten Vektorgrafiken können ggf. unhandlich groß werden. Ein direktes Konvertieren in ein Bitmap-Format (z.B. PNG) wird daher empfohlen.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncplot.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)

|methode=
NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
Interaktion mit dem Anwender statt.
Das Layout des Bildes und die graphische Darstellung der Daten wird über Angaben
in den Eingabedateien des Programmes festgelegt.
 

NCPLOT erzeugt Vektorgrafiken im CGM- oder SVG-Format.
 

Für originale UnTRIM-Ergebnisse, d.h. für Daten die direkt von einem der UnTRIM-Programme im
CF-NetCDF-Format ausgegeben wurden, besteht die Möglichkeit, die Daten nur dann in die
Darstellung einzubeziehen, wenn am Ort eine bestimmte, minimale Wasserbedeckung gegeben ist.
 

Hinweis: '''HDF error''' 
Falls beim Lesen von Daten ein HDF error auftritt wird versucht,
die Werte des gewünschten Datenrecords aus den Werten zeitlich benachbarter
Records zu rekonstruieren (Interpolation).
Diese Reparatur funktioniert ausschließlich für von der Zeit abhängige Variablen.
 

|preprozessor=[[BOE2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

NCPLOT.DAT

2021-10-18T13:37:15Z

Ak3spohr: Version 6 mit SVG-Output

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Oktober 2021
|version_beschr=Oktober 2021
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für die Bilddatei(en).
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.
* (optional) Key '''"Output_Format" :''' Ausgabeformat für die erzeugten Grafiken.
:*'''CGM''' = Von GKS erzeugtes binäres CGM-Format
:*'''SVG''' = Scalable Vector Graphics (XML-basiertes ASCII-Format)

===Block "SVG_Specifications"===
Optionaler Block mit Attributen für die Ausgabe der Grafik im SVG-Format.
* (optional) Key '''"SVG_Maximum_Size" :''' Maximale Ausdehnung der SVG-Grafik, d.h Faktor für die Umrechnung von NDC-Raum in GKS in den SVG-Raum.
* (optional) Key '''"SVG_Font_Family" :''' Schriftartfamilie für Text-Elemente.
:*'''monospace''' = alle Zeichen gleiche Breite
:*'''sans-serif''' = schnörkellose Schrift

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich grundsätzlich von den flächenhaften Achsendiagrammen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:*'''XY_data''' = Kartenansicht, Draufsicht-Darstellung, horizontale Ebene
:*'''PZ''' = Vertikalschnitt entlang Profil (3D-Daten)
:*'''TZ''' = Tiefenzeitreihe an einem Ort (3D-Daten)
:*'''PT''' = Hovmöller Variante 1: X-Achse=Profilachse (P), Y-Achse=Zeitachse (T)
:*'''TP''' = Hovmöller Variante 2: X-Achse=Zeitachse (T), Y-Achse=Profilachse (P)
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines (nur Layer_Type ''XY_data'')
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren (nur Layer_Type ''XY_data'')
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.
* (optional) Key '''"Layer_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"Layer_Legend_Number_Format" :''' Formatvorgabe für Zahlenwerte an der Farblegende.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.
* (optional) Key '''"LineChart_FillArea_Between_Series" :''' Einfärben von Flächen zwischen zwei Datenreihen.
* (optional) Key '''"LineChart_FillArea_Series_Values" :''' Einfärben von Flächen zwischen einer Datenreihen und einem bestimmten Wert.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.
* (optional) Key '''"Axis_Number_Format" :''' Formatvorgabe für Zahlenwerte der Achsenskalierung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
:*'''Interpolation''' = eine gerade Linie schließt die Datenlücke der Kurve
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT

2021-10-18T12:57:02Z

Ak3spohr: Version 6 mit SVG-Output

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=Oktober 2021
|version_beschr=Oktober 2021
|stichworte=Graphik-Postprozessor 
Darstellung von Berechnungsergebnissen 
CF-NetCDF-Format für 2D-/3D-Daten (unbekannte Attribute werden ignoriert) 
Finite Elemente Verfahren 
Finite Differenzen Verfahren 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Umrechnung bzw. Transformation (extensiv - intensiv) der physikalischen Einheit 
Verknüpfung mehrerer Eingangsgrößen zu einer neuen Größe für Darstellungszwecke 
(optional) Filterung der Darstellung basierend auf der Wassertiefe 
(optional) Filterung der Darstellung baiserend auf der Anzahl der Beobachtungen 

Danksagung: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''

|kurzbeschreibung=
Das Programm NCPLOT dient der Darstellung von Berechnungs- und Analyseergebnissen,
die im CF-NetCDF-Format abgelegt sind.
Die Daten können an Knoten (node), für Kanten (edge) oder für Polygone (face)
vorliegen. Es können 2D-, und 3D-Daten, sowie Daten mit subgridskaligen Details
verarbeitet werden. 
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT. 
[[Beispiel-Grafiken: NCPLOT|NCPLOT: Beispiel-Grafiken]]

Grundsätzlich unterscheidet NCPLOT linienhafte von flächenhaften Diagrammtypen.
Bei flächenhaften Diagrammen ist die Symbolisierung der Daten im Allgemeinen von
ihrem Wert abhängig (Farblegende, Proportionalpfeil).
Bei linienhaften Diagrammen werden die Werte von Datenreihen an einer Achse angetragen,
die Symbolisierung der Datenreihe ist vom Datenwert unabhängig. 

[[NCPLOT: Flächenhafte Diagramme|Flächenhafte Diagramme]]:
* Karte, bzw. Draufsicht-Darstellung
* Vertikalschnitt entlang Profil (3D-Daten)
* Tiefenzeitreihe an einem Ort (3D-Daten)
* Hovmöller: zeitliche Entwicklung über Profil

[[NCPLOT: Liniendiagramme|Liniendiagramme]]: 
* Zeitreihe
* Profildarstellung
* Tiefenprofil

NCPLOT erlaubt es auf einem Bild verschiedene Diagramme unterschiedlichen Typs
darzustellen. Liniendiagramme neben flächenhaften Darstellungen mit statischen
und ggf. dynamischen Anteilen.
 

Bildserien: 
Sowohl linien- als auch flächenhafte Diagrammdefinitionen können das Erstellen von
Bildserien anfordern. Ein Plot kann somit neben statischen auch dynamische, also
über die Bildserie veränderliche Bildanteile beinhalten.
 

Damit das Programm den sich dadurch ergebenden Kombinationsmöglichkeiten irgendwie
Herr wird, gilt folgende Regel: 
Sind dynamische Diagramm-Definitionen vorhanden, so bestimmt die zuerst gelesene
dynamische Definition die erlaubte Bildserien-Länge. Ergeben andere vorhandene
dynamische Diagramm-Definitionen eine abweichende Bildanzahl bricht das Programm ab.
 

Weitere Prüfungen hinsichtlich der Sinnhaftigkeit der Daten-Adressierung zwischen
beteiligten Bildelementen werden nicht vorgenommen.
 

Verschiedene Seriendiagramme aus dynamischen Diagramm-Defintionen gleicher
Länge werden vom Programm verarbeitet. Die statischen Bildelemente finden
sich dabei auf jedem Bild der Serie.
 

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCPLOT.DAT|ncplot.dat]])
# '''Berechnungs und/oder Analyseergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# Datei mit '''Intervalldefinitionen''' von Farblegenden ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# Datei mit '''Verweisen zu Palettendefinitionen''' ([[PALETTES.CFG.DAT|palettes.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
# Datei mit '''Farbdefinitionen''' ([[COLORS.CFG.DAT|colors.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.

Desweiteren werden von dem Programm NCPLOT folgende Standard-Konfigurationsdateien aus dem Verzeichnis
'''$PROGHOME/cfg/''' benötigt:
:* GKS-Parameter: '''gkssystem.rechnername.dat'''

|ausgabedateien=
# '''Grafikdatei(en)''' (Format: CGM oder SVG) Hinweis: Die erzeugten Vektorgrafiken können ggf. unhandlich groß werden. Ein direktes Konvertieren in ein Bitmap-Format (z.B. PNG) wird daher empfohlen.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncplot.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)

|methode=
NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
Interaktion mit dem Anwender statt.
Das Layout des Bildes und die graphische Darstellung der Daten wird über Angaben
in den Eingabedateien des Programmes festgelegt.
 

NCPLOT erzeugt Vektorgrafiken im CGM- oder SVG-Format.
 

Für originale UnTRIM-Ergebnisse, d.h. für Daten die direkt von einem der UnTRIM-Programme im
CF-NetCDF-Format ausgegeben wurden, besteht die Möglichkeit, die Daten nur dann in die
Darstellung einzubeziehen, wenn am Ort eine bestimmte, minimale Wasserbedeckung gegeben ist.
 

Hinweis: '''HDF error''' 
Falls beim Lesen von Daten ein HDF error auftritt wird versucht,
die Werte des gewünschten Datenrecords aus den Werten zeitlich benachbarter
Records zu rekonstruieren (Interpolation).
Diese Reparatur funktioniert ausschließlich für von der Zeit abhängige Variablen.
 

|preprozessor=[[BOE2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

NCPLOT: Flächenhafte Diagramme

2020-10-23T13:56:50Z

Ak3spohr:

[[en:NCPLOT: Area Charts]]
__NOAUTOLINKS__
__NOAUTOLINKTARGET__

__TOC__
 

=Allgemein=

Die Visualisierung eines Datensatzes als Flächendiagramm wird in einem
sogenannten ''Layer'' beschrieben.
Die Zuordnung von Farben zu Datenwerten und die Repräsentationsform der
zugrundeliegenden Geometrie werden dort festgelegt.
Verschiedene Layer können übereinander geplottet werden.
 

Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich
von den flächenhaften Achsendiagrammen.
Statt Angabe von Bildfläche und Achsendefinitionen wird bei einer Karte
der Zusammenhang zwischen Welt- und Bild-Koordinaten mit Hilfe einer
sogenannten ''Normalization_Transformation'' beschrieben.
 

Von Layern verwendete Farblegenden können eingeblendet und auf der Bildfläche
horizontal oder vertikal positioniert werden.
Ein weiteres layerabhängiges, optionales Bildelement ist ein Textfeld
für die Daten-Beschriftung (z.B. Angabe des Zeitpunktes).
 

Des Weiteren können auch einfache Berechnungen (Addition, Subtraktion,
Multiplikation, Division, Absolutbetrag, Quadratwurzel) durchgeführt werden.

=Flächenhafte Diagramm-Typen=

==Karte, bzw. Draufsicht-Darstellung==
Maßstäbliche Karten, bzw. Draufsicht-Darstellung von Berechnungs- und Analyseergebnissen.
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

===Optionen der Darstellung===
Die Daten können vom Programm an ihren originalen Positionen (node, edge, face)
dargestellt werden. Eine horizontale Interpolation der Daten ist aber auch möglich.
Neben der Flächenfüllung können die Daten auch auf Linien, als Marker oder auch als
Text visualisiert werden.
Die Marker oder Texte werden in dem Fall an der Kantenmitte, bzw. am Polygonschwerpunkt
verortet.
Für die Liniensymbolisierung von FACE-Daten werden die Kanten der Polygone eingefärbt.

Die Beispiel-Grafiken veranschaulichen die von NCPLOT gebotenen Möglichkeiten. 
[[NCPLOT: Beispiel-Grafiken Draufsicht|Beispiel-Grafiken: Draufsicht-Darstellung]]

===Koordinatenrahmen===
Jede Karte kann mit einem Rahmen ausgestattet werden, wobei es sich
um eine einfache Umrandung oder einen ausgefeilten Koordinatenrahmen handeln kann.
Die Koordinatenrahmen sind für Gauß-Krüger- und UTM-Projektionen optimiert.
Auf einem Bild können mehrere Kartenfenster angeordnet werden.

===Vektor-Darstellung===
Liegen X-und Y-Komponente einer vektoriellen Größe vor, ist die Visualisierung
des Gesamtvektors möglich.
Auf Kanten abgespeicherte Normalkomponenten einer vektoriellen Größe können sowohl als
Normalenvektor oder als auch als Gesamtvektor visualisiert werden. 
Das Ausdünnen der Anzeige von Vektorpfeilen ist möglich.

[[Bild:NcplotBspAcPzElbeLP.png|thumb|250px|Bild 2: Vertikalschnitt (3D-Daten).]]
[[Bild:NcplotBspAcTzBrunCU.png|thumb|250px|Bild 3: Tiefen-Zeitreihe (3D-Daten).]]
[[Bild:NcplotBspAcPtElbeHov.png|thumb|250px|Bild 4: Hovmöller-Diagramm PT.]]
[[Bild:NcplotBspAcTpElbeQp.png|thumb|250px|Bild 5: Hovmöller-Diagramm TP.]]
 

==Vertikalschnitt==
Darstellung von tiefenabhängigen, skalaren Berechnungs- und Analyseergebnissen
entlang einer Ortsachse (Bild 2).
 

==Tiefen-Zeitreihe==
Darstellung der zeitlichen Entwicklung von tiefenabhängigen, skalaren Berechnungs-
und Analyseergebnissen an einem Ort (Bild 3).
 

==Hovmöller-Diagramm==
Darstellung der zeitlichen Entwicklung skalarer Berechnungs-
und Analyseergebnissen über einer Ortsachse, z.B. Profil. 
Variante PT: X-Achse=Profilachse, Y-Achse=Zeitachse (Bild 4). 
Variante TP: X-Achse=Zeitachse, Y-Achse=Profilachse (Bild 5).
 

----
zurück zu [[NCPLOT]]

NCPLOT: Flächenhafte Diagramme

2020-10-23T13:41:06Z

Ak3spohr: + Hovmöller Varainte TP

[[en:NCPLOT: Area Charts]]
__NOAUTOLINKS__
__NOAUTOLINKTARGET__

__TOC__
 

=Allgemein=

Die Visualisierung eines Datensatzes als Flächendiagramm wird in einem
sogenannten ''Layer'' beschrieben.
Die Zuordnung von Farben zu Datenwerten und die Repräsentationsform der
zugrundeliegenden Geometrie werden dort festgelegt.
Verschiedene Layer können übereinander geplottet werden.
 

Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich
von den flächenhaften Achsendiagrammen.
Statt Angabe von Bildfläche und Achsendefinitionen wird bei einer Karte
der Zusammenhang zwischen Welt- und Bild-Koordinaten mit Hilfe einer
sogenannten ''Normalization_Transformation'' beschrieben.
 

Von Layern verwendete Farblegenden können eingeblendet und auf der Bildfläche
horizontal oder vertikal positioniert werden.
Ein weiteres layerabhängiges, optionales Bildelement ist ein Textfeld
für die Daten-Beschriftung (z.B. Angabe des Zeitpunktes).
 

Des Weiteren können auch einfache Berechnungen (Addition, Subtraktion,
Multiplikation, Division, Absolutbetrag, Quadratwurzel) durchgeführt werden.

=Flächenhafte Diagramm-Typen=

==Karte, bzw. Draufsicht-Darstellung==
Maßstäbliche Karten, bzw. Draufsicht-Darstellung von Berechnungs- und Analyseergebnissen.
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

===Optionen der Darstellung===
Die Daten können vom Programm an ihren originalen Positionen (node, edge, face)
dargestellt werden. Eine horizontale Interpolation der Daten ist aber auch möglich.
Neben der Flächenfüllung können die Daten auch auf Linien, als Marker oder auch als
Text visualisiert werden.
Die Marker oder Texte werden in dem Fall an der Kantenmitte, bzw. am Polygonschwerpunkt
verortet.
Für die Liniensymbolisierung von FACE-Daten werden die Kanten der Polygone eingefärbt.

Die Beispiel-Grafiken veranschaulichen die von NCPLOT gebotenen Möglichkeiten. 
[[NCPLOT: Beispiel-Grafiken Draufsicht|Beispiel-Grafiken: Draufsicht-Darstellung]]

===Koordinatenrahmen===
Jede Karte kann mit einem Rahmen ausgestattet werden, wobei es sich
um eine einfache Umrandung oder einen ausgefeilten Koordinatenrahmen handeln kann.
Die Koordinatenrahmen sind für Gauß-Krüger- und UTM-Projektionen optimiert.
Auf einem Bild können mehrere Kartenfenster angeordnet werden.

===Vektor-Darstellung===
Liegen X-und Y-Komponente einer vektoriellen Größe vor, ist die Visualisierung
des Gesamtvektors möglich.
Auf Kanten abgespeicherte Normalkomponenten einer vektoriellen Größe können sowohl als
Normalenvektor oder als auch als Gesamtvektor visualisiert werden. 
Das Ausdünnen der Anzeige von Vektorpfeilen ist möglich.

[[Bild:NcplotBspAcPzElbeLP.png|thumb|250px|Bild 2: Vertikalschnitt (3D-Daten).]]
[[Bild:NcplotBspAcTzBrunCU.png|thumb|250px|Bild 3: Tiefen-Zeitreihe (3D-Daten).]]
[[Bild:NcplotBspAcPtElbeHov.png|thumb|250px|Bild 4: Hovmöller-Diagramm PT.]]
[[Bild:NcplotBspAcTpElbeQp.png|thumb|250px|Bild 5: Hovmöller-Diagramm TP.]]
 

==Vertikalschnitt==
Darstellung von tiefenabhängigen, skalaren Berechnungs- und Analyseergebnissen
entlang einer Ortsachse (Bild 2).
 

==Tiefen-Zeitreihe==
Darstellung der zeitlichen Entwicklung von tiefenabhängigen, skalaren Berechnungs-
und Analyseergebnissen an einem Ort (Bild 3).
 

==Hovmöller-Diagramm==
Darstellung der zeitlichen Entwicklung skalarer Berechnungs-
und Analyseergebnissen über einer Ortsachse, z.B. Profil. 
Variante PT: X-Achse=Zeitachse, Y-Achse=Profilachse (Bild 4). 
Variante TP: X-Achse=Profilachse, Y-Achse=Zeitachse (Bild 5).
 

----
zurück zu [[NCPLOT]]

Beispiel-Grafiken: NCPLOT

2020-10-23T13:19:56Z

Ak3spohr:

__NOAUTOLINKS__
__NOAUTOLINKTARGET__
[[en:NCPLOT: Example figures]]
Die hier gezeigten Grafiken sollen einen Eindruck vom Leistungsumfang des Programms [[NCPLOT]] vermitteln.
__TOC__
 

=Beispiele=

===Flächenhaftes Diagramm: Draufsicht===
{| border="1"
! width="50%" | Topografie mit subgridskaligen Details
! width="50%" | Gegenüberstellung von Wasserstand und Salzgehalt
|-
|[[Bild:NcplotBspSubgridTopo.png|zentriert|500px|Topografie mit subgridskaligen Details]]
|[[Bild:NcplotBspTwo_Maps.png|zentriert|500px|Gegenüberstellung von Wasserstand und Salzgehalt]]
|}
 

===Flächenhaftes Achsendiagramm: Vertikalschnitt (3D-Daten)===
{| border="1"
! width="50%" | Salzgehalt entlang Elbe-Längsprofil
! width="50%" | Salzgehalt Querprofil Elbe-KM 703
|-
|[[Bild:NcplotBspAcPzElbeLP.png|zentriert|500px|Salzgehalt entlang Elbe-Längsprofil]]
|[[Bild:NcplotBspAcPzElbeQP.png|zentriert|500px|Salzgehalt Querprofil Elbe-KM 703]]
|}
 

===Flächenhaftes Achsendiagramm: Tiefenzeitreihe (3D-Daten)===
{| border="1"
! width="50%" | skalare Strömungsgeschwindigkeit
! width="50%" | Salzgehalt Elbe Höhe Brunsbüttel
|-
|[[Bild:NcplotBspAcTzBrunCU.png|zentriert|500px|skalare Strömungsgeschwindigkeit]]
|[[Bild:NcplotBspAcTzBrunSA.png|zentriert|500px|Salzgehalt Elbe Höhe Brunsbüttel]]
|}
 

===Flächenhaftes Achsendiagramm: Hovmöller-Diagramm===
{| border="1"
! width="50%" | Variante PT: X-Achse=Profilachse, Y-Achse=Zeitachse
! width="50%" | Variante TP: X-Achse=Zeitachse, Y-Achse=Profilachse
|-
|[[Bild:NcplotBspAcPtElbeHov.png|zentriert|500px|Wasserstandsentwicklung entlang Elbe]]
|[[Bild:NcplotBspAcTpElbeQp.png|zentriert|500px|Salzgehaltsentwicklung an Elbe-Querprofil]]
|}
 

===Linien-Diagramm: Zeitreihe===
{| border="1"
! width="50%" | ADCP-Querprofil-Messung Gandersum
! width="50%" | Aggregierter Schwebstofftransport über Kantenflächen
|-
|[[Bild:NcplotBspLcTgAdcpGandersum.png|zentriert|500px|ADCP-Querprofil-Messung Gandersum]]
|[[Bild:NcplotBspAggSchwStTp.png|zentriert|500px|Aggregierter Schwebstofftransport über Kantenflächen]]
|}
 

===Linien-Diagramm: Profildarstellung===
{| border="1"
! width="50%" | Wasserstände entlang Elbe
! width="50%" |
|-
|[[Bild:NcplotBspLcPgElbeLP.png|zentriert|500px|Wasserstände entlang Elbe]]
|
|}
 

===Linien-Diagramm: Tiefenprofil===
{| border="1"
! width="50%" | mittlerer Betrag der Strömung (Weser)
! width="50%" |
|-
|[[Bild:NcplotBspLcGzWeserCU.png|zentriert|500px|mittlerer Betrag der Strömung (Weser)]]
|
|}
 

----
zurück zu [[NCPLOT]]

Beispiel-Grafiken: NCPLOT

2020-10-23T13:18:35Z

Ak3spohr: + 2. Hovmöller Variante TP

__NOAUTOLINKS__
__NOAUTOLINKTARGET__
[[en:NCPLOT: Example figures]]
Die hier gezeigten Grafiken sollen einen Eindruck vom Leistungsumfang des Programms [[NCPLOT]] vermitteln.
__TOC__
 

=Beispiele=

===Flächenhaftes Diagramm: Draufsicht===
{| border="1"
! width="50%" | Topografie mit subgridskaligen Details
! width="50%" | Gegenüberstellung von Wasserstand und Salzgehalt
|-
|[[Bild:NcplotBspSubgridTopo.png|zentriert|500px|Topografie mit subgridskaligen Details]]
|[[Bild:NcplotBspTwo_Maps.png|zentriert|500px|Gegenüberstellung von Wasserstand und Salzgehalt]]
|}
 

===Flächenhaftes Achsendiagramm: Vertikalschnitt (3D-Daten)===
{| border="1"
! width="50%" | Salzgehalt entlang Elbe-Längsprofil
! width="50%" | Salzgehalt Querprofil Elbe-KM 703
|-
|[[Bild:NcplotBspAcPzElbeLP.png|zentriert|500px|Salzgehalt entlang Elbe-Längsprofil]]
|[[Bild:NcplotBspAcPzElbeQP.png|zentriert|500px|Salzgehalt Querprofil Elbe-KM 703]]
|}
 

===Flächenhaftes Achsendiagramm: Tiefenzeitreihe (3D-Daten)===
{| border="1"
! width="50%" | skalare Strömungsgeschwindigkeit
! width="50%" | Salzgehalt Elbe Höhe Brunsbüttel
|-
|[[Bild:NcplotBspAcTzBrunCU.png|zentriert|500px|skalare Strömungsgeschwindigkeit]]
|[[Bild:NcplotBspAcTzBrunSA.png|zentriert|500px|Salzgehalt Elbe Höhe Brunsbüttel]]
|}
 

===Flächenhaftes Achsendiagramm: Hovmöller-Diagramm===
{| border="1"
! width="50%" | Variante 1 "PT": X-Achse=Profilachse, Y-Achse=Zeitachse
! width="50%" | Variante 2 "TP": X-Achse=Zeitachse, Y-Achse=Profilachse
|-
|[[Bild:NcplotBspAcPtElbeHov.png|zentriert|500px|Wasserstandsentwicklung entlang Elbe]]
|[[Bild:NcplotBspAcTpElbeQp.png|zentriert|500px|Salzgehaltsentwicklung an Elbe-Querprofil]]
|}
 

===Linien-Diagramm: Zeitreihe===
{| border="1"
! width="50%" | ADCP-Querprofil-Messung Gandersum
! width="50%" | Aggregierter Schwebstofftransport über Kantenflächen
|-
|[[Bild:NcplotBspLcTgAdcpGandersum.png|zentriert|500px|ADCP-Querprofil-Messung Gandersum]]
|[[Bild:NcplotBspAggSchwStTp.png|zentriert|500px|Aggregierter Schwebstofftransport über Kantenflächen]]
|}
 

===Linien-Diagramm: Profildarstellung===
{| border="1"
! width="50%" | Wasserstände entlang Elbe
! width="50%" |
|-
|[[Bild:NcplotBspLcPgElbeLP.png|zentriert|500px|Wasserstände entlang Elbe]]
|
|}
 

===Linien-Diagramm: Tiefenprofil===
{| border="1"
! width="50%" | mittlerer Betrag der Strömung (Weser)
! width="50%" |
|-
|[[Bild:NcplotBspLcGzWeserCU.png|zentriert|500px|mittlerer Betrag der Strömung (Weser)]]
|
|}
 

----
zurück zu [[NCPLOT]]

Datei:NcplotBspAcTpElbeQp.png

2020-10-23T13:07:38Z

Ak3spohr: NCPLOT-Beispielgrafik Hovmöller-Diagramm Variante 2: zeitliche Entwicklung Salzgehalt entlang Querprofil bei Elbe-KM703.

== Beschreibung ==
NCPLOT-Beispielgrafik Hovmöller-Diagramm Variante 2: zeitliche Entwicklung Salzgehalt entlang Querprofil bei Elbe-KM703.

NCPLOT.DAT

2020-10-23T11:41:38Z

Ak3spohr: Änderungen für Version ncplot_2020_09_18

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Oktober 2020
|version_beschr=Oktober 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für CGM-Ausgabedatei.
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich grundsätzlich von den flächenhaften Achsendiagrammen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:*'''XY_data''' = Kartenansicht, Draufsicht-Darstellung, horizontale Ebene
:*'''PZ''' = Vertikalschnitt entlang Profil (3D-Daten)
:*'''TZ''' = Tiefenzeitreihe an einem Ort (3D-Daten)
:*'''PT''' = Hovmöller Variante 1: X-Achse=Profilachse (P), Y-Achse=Zeitachse (T)
:*'''TP''' = Hovmöller Variante 2: X-Achse=Zeitachse (T), Y-Achse=Profilachse (P)
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines (nur Layer_Type ''XY_data'')
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren (nur Layer_Type ''XY_data'')
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.
* (optional) Key '''"Layer_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms und Möglichkeit dem Diagramm eine andere Plot-Ebene zuzuordnen.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.
* (optional) Key '''"Axis_Number_Format" :''' Formatvorgabe für Zahlenwerte der Achsenskalierung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT: Flächenhafte Diagramme

2020-04-30T10:21:00Z

Ak3spohr: + flächenhafte Achsendiagramme PZ,GZ,PT

[[en:NCPLOT: Area Charts]]
__NOAUTOLINKS__
__NOAUTOLINKTARGET__

__TOC__
 

=Allgemein=

Die Visualisierung eines Datensatzes als Flächendiagramm wird in einem
sogenannten ''Layer'' beschrieben.
Die Zuordnung von Farben zu Datenwerten und die Repräsentationsform der
zugrundeliegenden Geometrie werden dort festgelegt.
Verschiedene Layer können übereinander geplottet werden.
 

Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich
von den flächenhaften Achsendiagrammen.
Statt Angabe von Bildfläche und Achsendefinitionen wird bei einer Karte
der Zusammenhang zwischen Welt- und Bild-Koordinaten mit Hilfe einer
sogenannten ''Normalization_Transformation'' beschrieben.
 

Von Layern verwendete Farblegenden können eingeblendet und auf der Bildfläche
horizontal oder vertikal positioniert werden.
Ein weiteres layerabhängiges, optionales Bildelement ist ein Textfeld
für die Daten-Beschriftung (z.B. Angabe des Zeitpunktes).
 

Des Weiteren können auch einfache Berechnungen (Addition, Subtraktion,
Multiplikation, Division, Absolutbetrag, Quadratwurzel) durchgeführt werden.

=Flächenhafte Diagramm-Typen=

==Karte, bzw. Draufsicht-Darstellung==
Maßstäbliche Karten, bzw. Draufsicht-Darstellung von Berechnungs- und Analyseergebnissen.
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

===Optionen der Darstellung===
Die Daten können vom Programm an ihren originalen Positionen (node, edge, face)
dargestellt werden. Eine horizontale Interpolation der Daten ist aber auch möglich.
Neben der Flächenfüllung können die Daten auch auf Linien, als Marker oder auch als
Text visualisiert werden.
Die Marker oder Texte werden in dem Fall an der Kantenmitte, bzw. am Polygonschwerpunkt
verortet.
Für die Liniensymbolisierung von FACE-Daten werden die Kanten der Polygone eingefärbt.

Die Beispiel-Grafiken veranschaulichen die von NCPLOT gebotenen Möglichkeiten. 
[[NCPLOT: Beispiel-Grafiken Draufsicht|Beispiel-Grafiken: Draufsicht-Darstellung]]

===Koordinatenrahmen===
Jede Karte kann mit einem Rahmen ausgestattet werden, wobei es sich
um eine einfache Umrandung oder einen ausgefeilten Koordinatenrahmen handeln kann.
Die Koordinatenrahmen sind für Gauß-Krüger- und UTM-Projektionen optimiert.
Auf einem Bild können mehrere Kartenfenster angeordnet werden.

===Vektor-Darstellung===
Liegen X-und Y-Komponente einer vektoriellen Größe vor, ist die Visualisierung
des Gesamtvektors möglich.
Auf Kanten abgespeicherte Normalkomponenten einer vektoriellen Größe können sowohl als
Normalenvektor oder als auch als Gesamtvektor visualisiert werden. 
Das Ausdünnen der Anzeige von Vektorpfeilen ist möglich.

[[Bild:NcplotBspAcPzElbeLP.png|thumb|250px|Bild 2: Vertikalschnitt (3D-Daten).]]
[[Bild:NcplotBspAcTzBrunCU.png|thumb|250px|Bild 3: Tiefen-Zeitreihe (3D-Daten).]]
[[Bild:NcplotBspAcPtElbeHov.png|thumb|250px|Bild 4: Hovmöller-Diagramm.]]
 

==Vertikalschnitt==
Darstellung von tiefenabhängigen, skalaren Berechnungs- und Analyseergebnissen
entlang einer Ortsachse (Bild 2).
 

==Tiefen-Zeitreihe==
Darstellung der zeitlichen Entwicklung von tiefenabhängigen, skalaren Berechnungs-
und Analyseergebnissen an einem Ort (Bild 3).
 

==Hovmöller-Diagramm==
Darstellung der zeitlichen Entwicklung skalarer Berechnungs-
und Analyseergebnissen über einer Ortsachse, z.B. Profil (Bild 4).
 

----
zurück zu [[NCPLOT]]

NCPLOT

2020-04-30T08:12:39Z

Ak3spohr: + flächenhafte Achsendiagramme PZ,TZ,PT

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=April 2020
|version_beschr=April 2020
|stichworte=Graphik-Postprozessor 
Darstellung von Berechnungsergebnissen 
CF-NetCDF-Format für 2D-/3D-Daten (unbekannte Attribute werden ignoriert) 
Finite Elemente Verfahren 
Finite Differenzen Verfahren 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Umrechnung bzw. Transformation (extensiv - intensiv) der physikalischen Einheit 
Verknüpfung mehrerer Eingangsgrößen zu einer neuen Größe für Darstellungszwecke 
(optional) Filterung der Darstellung basierend auf der Wassertiefe 
(optional) Filterung der Darstellung baiserend auf der Anzahl der Beobachtungen 

Danksagung: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''

|kurzbeschreibung=
Das Programm NCPLOT dient der Darstellung von Berechnungs- und Analyseergebnissen,
die im CF-NetCDF-Format abgelegt sind.
Die Daten können an Knoten (node), für Kanten (edge) oder für Polygone (face)
vorliegen. Es können 2D-, und 3D-Daten, sowie Daten mit subgridskaligen Details
verarbeitet werden. 
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT. 
[[Beispiel-Grafiken: NCPLOT|NCPLOT: Beispiel-Grafiken]]

Grundsätzlich unterscheidet NCPLOT linienhafte von flächenhaften Diagrammtypen.
Bei flächenhaften Diagrammen ist die Symbolisierung der Daten im Allgemeinen von
ihrem Wert abhängig (Farblegende, Proportionalpfeil).
Bei linienhaften Diagrammen werden die Werte von Datenreihen an einer Achse angetragen,
die Symbolisierung der Datenreihe ist vom Datenwert unabhängig. 

[[NCPLOT: Flächenhafte Diagramme|Flächenhafte Diagramme]]:
* Karte, bzw. Draufsicht-Darstellung
* Vertikalschnitt entlang Profil (3D-Daten)
* Tiefenzeitreihe an einem Ort (3D-Daten)
* Hovmöller: zeitliche Entwicklung über Profil

[[NCPLOT: Liniendiagramme|Liniendiagramme]]: 
* Zeitreihe
* Profildarstellung
* Tiefenprofil

NCPLOT erlaubt es auf einem Bild verschiedene Diagramme unterschiedlichen Typs
darzustellen. Liniendiagramme neben flächenhaften Darstellungen mit statischen
und ggf. dynamischen Anteilen.
 

Bildserien: 
Sowohl linien- als auch flächenhafte Diagrammdefinitionen können das Erstellen von
Bildserien anfordern. Ein Plot kann somit neben statischen auch dynamische, also
über die Bildserie veränderliche Bildanteile beinhalten.
 

Damit das Programm den sich dadurch ergebenden Kombinationsmöglichkeiten irgendwie
Herr wird, gilt folgende Regel: 
Sind dynamische Diagramm-Definitionen vorhanden, so bestimmt die zuerst gelesene
dynamische Definition die erlaubte Bildserien-Länge. Ergeben andere vorhandene
dynamische Diagramm-Definitionen eine abweichende Bildanzahl bricht das Programm ab.
 

Weitere Prüfungen hinsichtlich der Sinnhaftigkeit der Daten-Adressierung zwischen
beteiligten Bildelementen werden nicht vorgenommen.
 

Verschiedene Seriendiagramme aus dynamischen Diagramm-Defintionen gleicher
Länge werden vom Programm verarbeitet. Die statischen Bildelemente finden
sich dabei auf jedem Bild der Serie.
 

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCPLOT.DAT|ncplot.dat]])
# '''Berechnungs und/oder Analyseergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# Datei mit '''Intervalldefinitionen''' von Farblegenden ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# Datei mit '''Verweisen zu Palettendefinitionen''' ([[PALETTES.CFG.DAT|palettes.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
# Datei mit '''Farbdefinitionen''' ([[COLORS.CFG.DAT|colors.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.

Desweiteren werden von dem Programm NCPLOT folgende Standard-Konfigurationsdateien aus dem Verzeichnis
'''$PROGHOME/cfg/''' benötigt:
:* GKS-Parameter: '''gkssystem.rechnername.dat'''

|ausgabedateien=
# '''Plot-Metafiles''' (CGM) Hinweis: Die erzeugten CGM-Dateien werden, aus verschiedenen Gründen, schnell unhandlich groß. Ein direktes Konvertieren in ein Bitmap-Format (z.B. PNG) wird empfohlen.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncplot.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)

|methode=
NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
Interaktion mit dem Anwender statt.
Das Layout des Bildes und die graphische Darstellung der Daten wird über Angaben
in den Eingabedateien des Programmes festgelegt.
 

NCPLOT erzeugt Vektorgrafiken im CGM-Format.
 

Für originale UnTRIM-Ergebnisse, d.h. für Daten die direkt von einem der UnTRIM-Programme im
CF-NetCDF-Format ausgegeben wurden, besteht die Möglichkeit, die Daten nur dann in die
Darstellung einzubeziehen, wenn am Ort eine bestimmte, minimale Wasserbedeckung gegeben ist.
 

Hinweis: '''HDF error''' 
Falls beim Lesen von Daten ein HDF error auftritt wird versucht,
die Werte des gewünschten Datenrecords aus den Werten zeitlich benachbarter
Records zu rekonstruieren (Interpolation).
Diese Reparatur funktioniert ausschließlich für von der Zeit abhängige Variablen.
 

|preprozessor=[[BOE2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

Beispiel-Grafiken: NCPLOT

2020-04-29T14:45:24Z

Ak3spohr: flächenhafte Achsendiagramme PZ,TZ,PT

__NOAUTOLINKS__
__NOAUTOLINKTARGET__
[[en:NCPLOT: Example figures]]
Die hier gezeigten Grafiken sollen einen Eindruck vom Leistungsumfang des Programms [[NCPLOT]] vermitteln.
__TOC__
 

=Beispiele=

===Flächenhaftes Diagramm: Draufsicht===
{| border="1"
! width="50%" | Topografie mit subgridskaligen Details
! width="50%" | Gegenüberstellung von Wasserstand und Salzgehalt
|-
|[[Bild:NcplotBspSubgridTopo.png|zentriert|500px|Topografie mit subgridskaligen Details]]
|[[Bild:NcplotBspTwo_Maps.png|zentriert|500px|Gegenüberstellung von Wasserstand und Salzgehalt]]
|}
 

===Flächenhaftes Achsendiagramm: Vertikalschnitt (3D-Daten)===
{| border="1"
! width="50%" | Salzgehalt entlang Elbe-Längsprofil
! width="50%" | Salzgehalt Querprofil Elbe-KM 703
|-
|[[Bild:NcplotBspAcPzElbeLP.png|zentriert|500px|Salzgehalt entlang Elbe-Längsprofil]]
|[[Bild:NcplotBspAcPzElbeQP.png|zentriert|500px|Salzgehalt Querprofil Elbe-KM 703]]
|}
 

===Flächenhaftes Achsendiagramm: Tiefenzeitreihe (3D-Daten)===
{| border="1"
! width="50%" | skalare Strömungsgeschwindigkeit
! width="50%" | Salzgehalt Elbe Höhe Brunsbüttel
|-
|[[Bild:NcplotBspAcTzBrunCU.png|zentriert|500px|skalare Strömungsgeschwindigkeit]]
|[[Bild:NcplotBspAcTzBrunSA.png|zentriert|500px|Salzgehalt Elbe Höhe Brunsbüttel]]
|}
 

===Flächenhaftes Achsendiagramm: Hovmöller-Diagramm===
{| border="1"
! width="50%" | Wasserstand entlang Elbe
! width="50%" |
|-
|[[Bild:NcplotBspAcPtElbeHov.png|zentriert|500px|Wasserstand entlang Elbe]]
|
|}
 

===Linien-Diagramm: Zeitreihe===
{| border="1"
! width="50%" | ADCP-Querprofil-Messung Gandersum
! width="50%" | Aggregierter [[Schwebstofftransport]] über Kantenflächen
|-
|[[Bild:NcplotBspLcTgAdcpGandersum.png|zentriert|500px|ADCP-Querprofil-Messung Gandersum]]
|[[Bild:NcplotBspAggSchwStTp.png|zentriert|500px|Aggregierter Schwebstofftransport über Kantenflächen]]
|}
 

===Linien-Diagramm: Profildarstellung===
{| border="1"
! width="50%" | Wasserstände entlang Elbe
! width="50%" |
|-
|[[Bild:NcplotBspLcPgElbeLP.png|zentriert|500px|Wasserstände entlang Elbe]]
|
|}
 

===Linien-Diagramm: Tiefenprofil===
{| border="1"
! width="50%" | mittlerer Betrag der Strömung (Weser)
! width="50%" |
|-
|[[Bild:NcplotBspLcGzWeserCU.png|zentriert|500px|mittlerer Betrag der Strömung (Weser)]]
|
|}
 

----
zurück zu [[NCPLOT]]

Datei:NcplotBspAcPtElbeHov.png

2020-04-29T14:43:47Z

Ak3spohr: NCPLOT-Beispielgrafik Hovmöller-Diagramm: zeitliche Entwicklung Wasserstand entlang Elbe.

== Beschreibung ==
NCPLOT-Beispielgrafik Hovmöller-Diagramm: zeitliche Entwicklung Wasserstand entlang Elbe.

Datei:NcplotBspAcTzBrunSA.png

2020-04-29T14:43:19Z

Ak3spohr: NCPLOT-Beispielgrafik Tiefenzeitreihe (3D-Daten): Salzgehalt Elbe Höhe Brunsbüttel.

== Beschreibung ==
NCPLOT-Beispielgrafik Tiefenzeitreihe (3D-Daten): Salzgehalt Elbe Höhe Brunsbüttel.

Datei:NcplotBspAcTzBrunCU.png

2020-04-29T14:42:52Z

Ak3spohr: NCPLOT-Beispielgrafik Tiefenzeitreihe (3D-Daten): skalare Strömungsgeschwindigkeit.

== Beschreibung ==
NCPLOT-Beispielgrafik Tiefenzeitreihe (3D-Daten): skalare Strömungsgeschwindigkeit.

Datei:NcplotBspAcPzElbeQP.png

2020-04-29T14:42:21Z

Ak3spohr: NCPLOT-Beispielgrafik Vertikalschnitt (3D-Daten): Salzgehalt Querprofil Höhe Elbe-KM 703.

== Beschreibung ==
NCPLOT-Beispielgrafik Vertikalschnitt (3D-Daten): Salzgehalt Querprofil Höhe Elbe-KM 703.

Datei:NcplotBspAcPzElbeLP.png

2020-04-29T14:41:39Z

Ak3spohr: NCPLOT-Beispielgrafik Vertikalschnitt (3D-Daten): Salzgehalt entlang Elbe-Längsprofil.

== Beschreibung ==
NCPLOT-Beispielgrafik Vertikalschnitt (3D-Daten): Salzgehalt entlang Elbe-Längsprofil.

NCPLOT.DAT

2020-04-29T14:10:19Z

Ak3spohr: +flächenhafte Achsendiagramme PZ,TZ,PT

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=April 2020
|version_beschr=April 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für CGM-Ausgabedatei.
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Die Darstellung in horizontaler Ebene (Kartenansicht) unterscheidet sich grundsätzlich von den flächenhaften Achsendiagrammen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:*'''XY_data''' = Kartenansicht, Draufsicht-Darstellung, horizontale Ebene
:*'''PZ''' = Vertikalschnitt entlang Profil (3D-Daten)
:*'''TZ''' = Tiefenzeitreihe an einem Ort (3D-Daten)
:*'''PT''' = Hovmöller: zeitliche Entwicklung über Profil
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines (nur Layer_Type ''XY_data'')
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text (nur Layer_Type ''XY_data'')
::*'''VEC''' = als Vektoren (nur Layer_Type ''XY_data'')
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
:Hinweis: Erforderlich für Definition eines flächenhaften Achsendiagramms.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NetCDF Synoptische Daten an Einzelpositionen

2020-02-21T08:56:32Z

Ak3spohr: zurück zum PDF; 'Datei:' durch 'Medium:' ersetzt

[[en:NetCDF synoptic data at multiple locations]]
=Kurze Beschreibung=

Synoptische Daten an Einzelpositionen. Es werden einige Beispiele für typische, wichtige Variablen vorgestellt.

=Weitere Beschreibungen=

* [[NetCDF Einzelpositionen]]: Koordinaten und Koordinatentransformation für Einzelpositionen.
* [[NetCDF Zeitkoordinate]]: Koordinatenvariable ''time''.
* [[NetCDF Vertikalkoordinate]]: zeit- und ortsvariable Vertikalkoordinate.

=Version ''Discrete Sampling Geometry'' '''timeSeriesProfile'''=

Zur Ablage von Daten an Einzelpositionen wird die in CF beschriebene ''Discrete Sampling Geometry'' mit '''featureType=timeSeriesProfile''' verwendet. Ein vereinfachtes Beispiel (NCDUMP) für Geometrie und synoptische Daten ist in [[Medium:L_synop_ncdump_2D.pdf|L_synop_ncdump_2D.pdf]] zu sehen.

==Daten ohne z-Abhängigkeit==

Die Lage des Wasserspiegels ist nur von der Zeit und der Position abhängig. Eine Abhängigkeit von der z-Koordinate ist nicht vorhanden. Daher dient der Wasserstand als Beispiel für eine geophysikalische Variable ohne z-Abhängigkeit.

float '''Mesh0_node_Wasserstand_2d'''(nMesh0_data_time, nMesh0_node) ;
: :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 nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_long_name" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_surface_height" ;

Anmerkungen:
# Es können ungültige Daten vorhanden sein (siehe ''_FillValue'').
# Die Hilfsvariable (siehe ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' kann bei der weiteren Verarbeitung (Analyse, Visualisierung) dazu verwendet werden, Orte mit sehr geringer Wasserbedeckung nicht auszuwerten.
# Der Wasserstand ist ein (synoptischer) Augenblickswert und ein Flächen-Mittelwert (siehe ''cell_methods'').
# In der Variable '''Mesh0_node_Wasserflaeche_2d''' ist die für den räumlichen Mittelwert relevante Fläche enthalten.
# Die Label-Koordinatenvariable '''Mesh0_node_long_name''' kann zur Auswahl von Position(en) verwendet werden (siehe ''coordinates'').

==Daten mit z-Abhängigkeit==

Der über die Wassertiefe gemittelte Salzgehalt ist von der Zeit und der Position abhängig. Eine Abhängigkeit von der z-Koordinate ist hier vorhanden, da in unserem Fall die z-Koordinate den Schwerpunkt (des Wasserkörpers) beschreibt. Daher dient der Salzgehalt als Beispiel für eine geophysikalische Variable mit z-Abhängigkeit.

float Mesh0_node_Salzgehalt_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: :long_name = "Salzgehalt [ node ]" ;
: :units = "1e-3" ;
: :name_id = 5 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "volume: Mesh0_node_Wasservolumen_2d area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_z_node_2d Mesh0_node_long_name" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "sea_water_salinity" ;

Anmerkungen:
# Es können ungültige Daten vorhanden sein (siehe ''_FillValue'').
# Die Hilfsvariable (siehe ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' kann bei der weiteren Verarbeitung (Analyse, Visualisierung) dazu verwendet werden, Orte mit sehr geringer Wasserbedeckung nicht auszuwerten.
# Der Salzgehalt ist ein (synoptischer) Augenblickswert und ein Volumen-Mittelwert (siehe ''cell_methods'').
# In der Variable '''Mesh0_node_Wasservolumen_2d''' ist das für den Volumen-Mittelwert relevante Volumen enthalten.
# Mit zusätzlicher Hilfe von '''Mesh0_node_Wasserflaeche_2d''' kann in exakter Weise das Salzvolumen/Fläche ermittelt werden.
# Die Label-Koordinatenvariable '''Mesh0_node_long_name''' kann zur Auswahl von Position(en) verwendet werden (siehe ''coordinates'').

==Daten für mehrere Fraktionen==

Der über die Wassertiefe gemittelte Sschwebstoffgehalt ist von der Zeit und der Position abhängig. Eine Abhängigkeit von der z-Koordinate ist hier vorhanden, da in unserem Fall die z-Koordinate den Schwerpunkt des Wasserkörpers beschreibt. Zusätzlich kann der Schwebstoffgehalt für mehrere Schwebstoff-Fraktionen ''nMesh0_suspension_classes'' vorhanden sein. Daher dient der Schwebstoffgehalt als Beispiel für eine geophysikalische Variable mit mehreren Fraktionen.

float Mesh0_node_Schwebstoffgehalt_2d(nMesh0_data_time, nMesh0_suspension_classes, nMesh0_layer_2d, nMesh0_node) ;
: :long_name = "Schwebstoffgehalt [ node ]" ;
: :units = "kg m-3" ;
: :name_id = 7 ;
: :_FillValue = 1.e+31f ;
: :ancillary_variables = "Mesh0_node_Gesamtwassertiefe_2d" ;
: :cell_measures = "volume: Mesh0_node_Wasservolumen_2d area: Mesh0_node_Wasserflaeche_2d" ;
: :cell_methods = "nMesh0_data_time: point nMesh0_suspension_classes: point nMesh0_layer_2d: mean nMesh0_node: mean" ;
: :comment = "ancillary variables may be used ..." ;
: :coordinates = "Mesh0_node_lon Mesh0_node_lat Mesh0_node_x Mesh0_node_y Mesh0_node_z_node_2d Mesh0_node_long_name Mesh0_Schwebstoffklassen_2d" ;
: :grid_mapping = "Mesh0_crs" ;
: :standard_name = "concentration_of_suspended_matter_in_sea_water" ;

Anmerkungen:
# Es können ungültige Daten vorhanden sein (siehe ''_FillValue'').
# Die Hilfsvariable (siehe ''ancillary_variables'') '''Mesh0_node_Gesamtwassertiefe_2d''' kann bei der weiteren Verarbeitung (Analyse, Visualisierung) dazu verwendet werden, Orte mit sehr geringer Wasserbedeckung nicht auszuwerten.
# Der Schwebstoffgehalt ist für jede Fraktion ein (synoptischer) Augenblickswert und ein Volumen-Mittelwert (siehe ''cell_methods'').
# In der Variable '''Mesh0_node_Wasservolumen_2d''' ist das für den Volumen-Mittelwert relevante Volumen enthalten.
# Mit zusätzlicher Hilfe von '''Mesh0_node_Wasserflaeche_2d''' kann in exakter Weise die Schwebstoffmasse/Fläche ermittelt werden.
# Die Label-Koordinatenvariable '''Mesh0_node_long_name''' kann zur Auswahl von Position(en) verwendet werden (siehe ''coordinates'').
# Die Label-Koordinatenvariable '''Mesh0_Schwebstoffklassen_2d''' kann zur Auswahl von Fraktionen verwendet werden (siehe ''coordinates'').

=Version [[DATACONVERT]]=

==Dimensionen==

# '''nMesh0_node''' : Anzahl der Einzelpositionen.
# '''nMesh0_strlen1''' : max. Anzahl der Zeichen für lange Namen.
# '''nMesh0_strl'''en2 : max. Anzahl der Zeichen für Code-Bezeichnungen.
# '''nMesh0_strlen3''' : max. Anzahl der Zeichen für Kurzbezeichnungen.
# '''nMesh0_class_names_strlen''' : max. Anzahl der Zeichen in Schwebstoffklassennamen.
# '''nMesh0_time''' : Anzahl der Zeitpunkte (Gitterdatei).
# '''nMesh0_data_time''' : UNLIMITED-Dimension, Anzahl der synoptischen Datensätze.
# '''nMesh0_layer_2d''' : Anzahl der Schichten für tiefengemittelte Daten.
# '''nMesh0_layer_3d''' : Anzahl der Schichten für tiefenstrukturierte Daten.
# '''nMesh0_suspension_classes''' : Anzahl der Schwebstoffklassen, inklusive Summe aller Fraktionen.
# '''two''' : Konstante.

==Positionsbezeichnungen==

===Langer Name===
char Mesh0_node_long_name(nMesh0_node, nMesh0_strlen1) ;
: Mesh0_node_long_name:long_name = "Name Geoposition" ;
: Mesh0_node_long_name:name_id = 1395 ;

Hinweise:
# Variable wird als Label-Koordinate benutzt, daher werden die Attribute "coordinates" und "grid_mapping" hier nicht benutzt.
# Das Attribut "name_id" entspricht der (BAW) PHYDEF-Code-Kennung der Variablen.

===Code-Name===
char Mesh0_node_code_name(nMesh0_node, nMesh0_strlen2) ;
: Mesh0_node_code_name:long_name = "Kennung der Geoposition" ;
: Mesh0_node_code_name:name_id = 1394 ;
: Mesh0_node_code_name:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_code_name:grid_mapping = "Mesh0_crs" ;

===Kurzer Name===
char Mesh0_node_short_name(nMesh0_node, nMesh0_strlen3) ;
: Mesh0_node_short_name:long_name = "Kuerzel Geoposition" ;
: Mesh0_node_short_name:name_id = 1396 ;
: Mesh0_node_short_name:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_short_name:grid_mapping = "Mesh0_crs" ;

==Positions-Farbcodes==
int Mesh0_node_colour(nMesh0_node) ;
: Mesh0_node_colour:long_name = "colour code of location" ;
: Mesh0_node_colour:valid_range = 0, 9999 ;
: Mesh0_node_colour:_FillValue = -999 ;
: Mesh0_node_colour:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_colour:grid_mapping = "Mesh0_crs" ;

Hinweise:
# Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.

==Positions-Identifikationsnummern==
int Mesh0_node_id(nMesh0_node) ;
: Mesh0_node_id:long_name = "identification number of location" ;
: Mesh0_node_id:valid_range = 0, 9999 ;
: Mesh0_node_id:_FillValue = -999 ;
: Mesh0_node_id:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_id:grid_mapping = "Mesh0_crs" ;

Hinweise:
# Dimensionslose Variable, daher ist kein "units" Attribut vorhanden.

==Datenkompression==

Siehe [[NetCDF Kompression von Daten durch Aufsammeln]].

==Gewichte==

Gewichte werden insbesondere im Postprocessing benötigt, um abgeleitete Daten korrekt berechnen zu können, falls die hierfür relevanten Gewichtsfaktoren, nicht in einfacher Weise aus den Koordinaten abgeleitet werden können.

===Längen===

====Durchflusshöhe an Positionen====
float Mesh0_node_z_2d_bnd(nMesh0_data_time, nMesh0_node, two) ;

Hinweise:
# Weitere Informationen unter [[#Vertikalkoordinaten|Vertikalkoordinaten]] (siehe nachfolgenden Abschnitt).

====Durchflusshöhe an Positionen, differenziert nach Schichten====
float Mesh0_node_z_3d_bnd(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node, two) ;

Hinweise:
# Weitere Informationen unter [[#Vertikalkoordinaten|Vertikalkoordinaten]] (siehe nachfolgenden Abschnitt).

==Zeitkoordinaten==

===Gitter-Daten===
double nMesh0_time(nMesh0_time) ;
: nMesh0_time:long_name = "time" ;
: nMesh0_time:units = "seconds since 2005-07-01 00:00:00 01:00" ;
: nMesh0_time:name_id = 1640 ;
: nMesh0_time:axis = "T" ;
: nMesh0_time:bounds = "nMesh0_time_bnd" ;
: nMesh0_time:calendar = "gregorian" ;
: nMesh0_time:standard_name = "time" ;

double nMesh0_time_bnd(nMesh0_time, two) ;

Hinweise:
# Die Topografie des Gitters (der ursprünglichen Gitterdatei) gilt entweder für einen bestimmten Termin oder Zeitraum.
# Falls die topografischen Daten des Gitters für einen Zeitraum gültig sind, so ist die entsprechende Boundary-Variable ebenfalls vorhanden.

===Synoptische Daten===
double nMesh0_data_time(nMesh0_data_time) ;
: nMesh0_data_time:long_name = "time" ;
: nMesh0_data_time:units = "seconds since 2005-05-01 01:30:00 01:00" ;
: nMesh0_data_time:name_id = 1640 ;
: nMesh0_data_time:axis = "T" ;
: nMesh0_data_time:calendar = "gregorian" ;
: nMesh0_data_time:standard_name = "time" ;

Hinweise:
# Die synoptischen Daten gelten für bestimmte Termine. Daher ist keine ergänzende Boundary-Variable erforderlich.

==Vertikalkoordinaten==

===Tiefengemittelte Daten===
float Mesh0_node_z_2d(nMesh0_data_time, nMesh0_node) ;
: Mesh0_node_z_2d:long_name = "zeit- und ortsvariable Tiefe der Datenpunkte" ;
: Mesh0_node_z_2d:units = "m" ;
: Mesh0_node_z_2d:positive = "down" ;
: Mesh0_node_z_2d:bounds = "Mesh0_node_z_2d_bnd" ;
: Mesh0_node_z_2d:standard_name = "depth" ;

float Mesh0_node_z_2d_bnd(nMesh0_data_time, nMesh0_node, two) ;

Hinweise:
# Über die Wassertiefe gemittelte Daten benutzen diese zeitvariable Vertikalkoordinate.
# Der aktuelle Wert bezeichnet die Mitte zwischen aktueller Wasseroberfläche und Gewässersohle.
# Aus der Boundary-Variablen ergibt sich die Höhe (Länge), über die gemittelt wurde.
# Das Attribut "axis" ist nicht zulässig, da es sich um eine Hilfs-Vertikalkoordinate handelt.

===Tiefenstrukturierte Daten===
float Mesh0_node_z_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_node_z_3d:long_name = "zeit- und ortsvariable Tiefe der Datenpunkte" ;
: Mesh0_node_z_3d:units = "m" ;
: Mesh0_node_z_3d:positive = "down" ;
: Mesh0_node_z_3d:bounds = "Mesh0_node_z_3d_bnd" ;
: Mesh0_node_z_3d:standard_name = "depth" ;

: float Mesh0_node_z_3d_bnd(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node, two) ;

Hinweise:
# Tiefenstrukturierte, in z-Schichten gemittelte Daten benutzen diese zeitvariable Vertikalkoordinate.
# Der aktuelle Wert bezeichnet die Mitte der jeweiligen z-Schicht.
# Aus der Boundary-Variablen ergibt sich die Höhe (Länge), über die gemittelt wurde.
# Das Attribut "axis" ist nicht zulässig, da es sich um eine Hilfs-Vertikalkoordinate handelt.

==Aktuelle (zeitvariable) Topografie==
===Knoten===
====Konstant in Zeitraum====
double Mesh0_node_depth(nMesh0_time, nMesh0_node) ;
: Mesh0_node_depth:long_name = "Topographie" ;
: Mesh0_node_depth:units = "m" ;
: Mesh0_node_depth:name_id = 17 ;
: Mesh0_node_depth:valid_range = -2000., 2000. ;
: Mesh0_node_depth:_FillValue = 1.e+31 ;
: Mesh0_node_depth:cell_methods = "nMesh0_time: mean area: point" ;
: Mesh0_node_depth:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_depth:grid_mapping = "Mesh0_crs" ;
: Mesh0_node_depth:standard_name = "sea_floor_depth_below_geoid" ;

Hinweise:
# Das Attribut "cell_methods" beschreibt hier u. a., dass die Tiefen Mittelwerte für einen Zeitraum sind.

====Zeitvariabel====
float Mesh0_zeitvariable_Topographie_2d(nMesh0_data_time, nMesh0_node) ;
: Mesh0_zeitvariable_Topographie_2d:long_name = "zeitvariable Topographie" ;
: Mesh0_zeitvariable_Topographie_2d:units = "m" ;
: Mesh0_zeitvariable_Topographie_2d:name_id = 617 ;
: Mesh0_zeitvariable_Topographie_2d:_FillValue = 1.e+31f ;
: Mesh0_zeitvariable_Topographie_2d:cell_methods = "nMesh0_data_time: point area: point" ;
: Mesh0_zeitvariable_Topographie_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_zeitvariable_Topographie_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_zeitvariable_Topographie_2d:standard_name = "sea_floor_depth_below_geoid" ;

==Maximale zulässige Tiefe==
double Mesh0_node_depth(nMesh0_time, nMesh0_node) ;
: Mesh0_node_depth:long_name = "Tiefe der unerodierbaren Schicht" ;
: Mesh0_node_depth:units = "m" ;
: Mesh0_node_depth:name_id = 1149 ;
: Mesh0_node_depth:valid_range = -2000., 2000. ;
: Mesh0_node_depth:_FillValue = 1.e+31 ;
: Mesh0_node_depth:cell_methods = "nMesh0_time: mean area: point" ;
: Mesh0_node_depth:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_node_depth:grid_mapping = "Mesh0_crs" ;
: Mesh0_node_depth:standard_name = "depth" ;

Hinweise:
# Das Attribut "cell_methods" beschreibt hier u. a., dass die Tiefen Mittelwerte für einen Zeitraum sind.
# Ggf. muss noch ein spezifischerer Standardname gefunden werden, z. B. "bedrock_altitude".

==Wasserstand==

===Knoten===
float Mesh0_Wasserstand_2d(nMesh0_data_time, nMesh0_node) ;
: Mesh0_Wasserstand_2d:long_name = "Wasserstand" ;
: Mesh0_Wasserstand_2d:units = "m" ;
: Mesh0_Wasserstand_2d:name_id = 3 ;
: Mesh0_Wasserstand_2d:_FillValue = 1.e+31f ;
: Mesh0_Wasserstand_2d:cell_methods = "nMesh0_data_time: point area: point" ;
: Mesh0_Wasserstand_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_long_name" ;
: Mesh0_Wasserstand_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Wasserstand_2d:standard_name = "sea_surface_height" ;

==Tiefengemittelter Salzgehalt==

===Knoten===
float Mesh0_Salzgehalt_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: Mesh0_Salzgehalt_2d:long_name = "Salzgehalt" ;
: Mesh0_Salzgehalt_2d:units = "1e-3" ;
: Mesh0_Salzgehalt_2d:name_id = 5 ;
: Mesh0_Salzgehalt_2d:_FillValue = 1.e+31f ;
: Mesh0_Salzgehalt_2d:cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean area: point" ;
: Mesh0_Salzgehalt_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_2d Mesh0_node_long_name" ;
: Mesh0_Salzgehalt_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Salzgehalt_2d:standard_name = "sea_water_salinity" ;

==Tiefenstrukturierter Salzgehalt==

===Knoten===
float Mesh0_Salzgehalt_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Salzgehalt_3d:long_name = "Salzgehalt" ;
: Mesh0_Salzgehalt_3d:units = "1e-3" ;
: Mesh0_Salzgehalt_3d:name_id = 5 ;
: Mesh0_Salzgehalt_3d:_FillValue = 1.e+31f ;
: Mesh0_Salzgehalt_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Salzgehalt_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name" ;
: Mesh0_Salzgehalt_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Salzgehalt_3d:standard_name = "sea_water_salinity" ;

==Tiefengemittelte Strömungsgeschwindigkeit==

===Knoten===
====x-Komponente====
float Mesh0_Stroemungsgeschwindigkeit_x_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:long_name = "Stroemungsgeschwindigkeit (x-Komponente)" ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_2d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_x_2d:standard_name = "sea_water_x_velocity" ;

====y-Komponente====
float Mesh0_Stroemungsgeschwindigkeit_y_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:long_name = "Stroemungsgeschwindigkeit (y-Komponente)" ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_2d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_y_2d:standard_name = "sea_water_y_velocity" ;

====Betrag====
float Mesh0_Stroemungsgeschwindigkeit_m_2d(nMesh0_data_time, nMesh0_layer_2d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:long_name = "Stroemungsgeschwindigkeit (Betrag)" ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_2d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_m_2d:standard_name = "magnitude_of_sea_water_velocity" ;

==Tiefenstrukturierte Strömungsgeschwindigkeit==

===Knoten===
====x-Komponente====
float Mesh0_Stroemungsgeschwindigkeit_x_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:long_name = "Stroemungsgeschwindigkeit (x-Komponente)" ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_x_3d:standard_name = "sea_water_x_velocity" ;

====y-Komponente====
float Mesh0_Stroemungsgeschwindigkeit_y_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:long_name = "Stroemungsgeschwindigkeit (y-Komponente)" ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_y_3d:standard_name = "sea_water_y_velocity" ;

====z-Komponente====
float Mesh0_Stroemungsgeschwindigkeit_z_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:long_name = "Stroemungsgeschwindigkeit (z-Komponente)" ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_z_3d:standard_name = "upward_sea_water_velocity" ;

====Betrag====
float Mesh0_Stroemungsgeschwindigkeit_m_3d(nMesh0_data_time, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:long_name = "Stroemungsgeschwindigkeit (Betrag)" ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:units = "m s-1" ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:name_id = 2 ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:_FillValue = 1.e+31f ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name" ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Stroemungsgeschwindigkeit_m_3d:standard_name = "magnitude_of_sea_water_velocity" ;

==Bezeichnung der Schwebstoffklassen==
char Mesh0_suspension_classes(nMesh0_suspension_classes, nMesh0_class_names_strlen) ;
: Mesh0_suspension_classes:long_name = "Klassenbezeichner" ;
: Mesh0_suspension_classes:name_id = 1655 ;

==Tiefengemittelter Schwebstoffgehalt==

===Knoten===
float Mesh0_Schwebstoffgehalt_2d(nMesh0_data_time, nMesh0_suspension_classes, nMesh0_layer_2d, nMesh0_node) ;
: Mesh0_Schwebstoffgehalt_2d:long_name = "Schwebstoffgehalt" ;
: Mesh0_Schwebstoffgehalt_2d:units = "kg m-3" ;
: Mesh0_Schwebstoffgehalt_2d:name_id = 7 ;
: Mesh0_Schwebstoffgehalt_2d:_FillValue = 1.e+31f ;
: Mesh0_Schwebstoffgehalt_2d:cell_methods = "nMesh0_data_time: point nMesh0_layer_2d: mean area: point" ;
: Mesh0_Schwebstoffgehalt_2d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_2d Mesh0_node_long_name Mesh0_suspension_classes" ;
: Mesh0_Schwebstoffgehalt_2d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Schwebstoffgehalt_2d:standard_name = "concentration_of_suspended_matter_in_sea_water" ;
: Mesh0_Schwebstoffgehalt_2d:comment = "class_names No 1 : Summe aller Fraktionen\\nclass_names No 2 : Schluff" ;

Hinweise:
# Sowohl die Summe aller Fraktionen als auch die einzelnen Fraktionen sind in einer Variablen abgelegt.
# Unter dem Attribut "comment" sind auch noch ein Mal die Definitionen der einzelnen Klassen angegeben.

==Tiefenstrukturierter Schwebstoffgehalt==

===Knoten===
float Mesh0_Schwebstoffgehalt_3d(nMesh0_data_time, nMesh0_suspension_classes, nMesh0_layer_3d, nMesh0_node) ;
: Mesh0_Schwebstoffgehalt_3d:long_name = "Schwebstoffgehalt" ;
: Mesh0_Schwebstoffgehalt_3d:units = "kg m-3" ;
: Mesh0_Schwebstoffgehalt_3d:name_id = 7 ;
: Mesh0_Schwebstoffgehalt_3d:_FillValue = 1.e+31f ;
: Mesh0_Schwebstoffgehalt_3d:cell_methods = "nMesh0_data_time: point nMesh0_layer_3d: mean area: point" ;
: Mesh0_Schwebstoffgehalt_3d:coordinates = "Mesh0_node_x Mesh0_node_y Mesh0_node_lon Mesh0_node_lat Mesh0_node_z_3d Mesh0_node_long_name Mesh0_suspension_classes" ;
: Mesh0_Schwebstoffgehalt_3d:grid_mapping = "Mesh0_crs" ;
: Mesh0_Schwebstoffgehalt_3d:standard_name = "concentration_of_suspended_matter_in_sea_water" ;
: Mesh0_Schwebstoffgehalt_3d:comment = "class_names No 1 : Summe aller Fraktionen\\nclass_names No 2 : Schluff" ;

Hinweise:
# Sowohl die Summe aller Fraktionen als auch die einzelnen Fraktionen sind in einer Variablen abgelegt.
# Unter dem Attribut "comment" sind auch noch ein Mal die Definitionen der einzelnen Klassen angegeben.

==Anmerkungen==
* Datei ist CF-konform gemäß [http://puma.nerc.ac.uk/cgi-bin/cf-checker.pl NCAS ''CF Compliance Checker''].
* Bislang fehlende CF konforme Standardnamen der physikalischen Größen sollten nur bei echtem Bedarf gemäß den dafür vorgesehenen Regeln ergänzt werden. Details siehe [http://cfconventions.org/Data/cf-standard-names/docs/guidelines.html ''Guidelines of Construction for CF Standard Names''].
----
zurück zu [[NetCDF]]
----
[[Strukturübersicht]]

NCPLOT.DAT

2020-01-27T13:54:40Z

Ak3spohr: KEY NTN_Framing ist optional

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Januar 2020
|version_beschr=Januar 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für CGM-Ausgabedatei.
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Derzeit ist nur die Darstellung in horizontaler Ebene, d.h. Draufsicht-Darstellung realisiert. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''.
* Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:Hinweis: Derzeit nur XY_data = horizontale Ebene, bzw. Draufsicht implementiert.
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* (optional) Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT

2020-01-24T16:21:07Z

Ak3spohr: Versionsdatum modifiziert

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=Januar 2020
|version_beschr=Januar 2020
|stichworte=Graphik-Postprozessor 
Darstellung von Berechnungsergebnissen 
CF-NetCDF-Format für 2D-/3D-Daten (unbekannte Attribute werden ignoriert) 
Finite Elemente Verfahren 
Finite Differenzen Verfahren 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Umrechnung bzw. Transformation (extensiv - intensiv) der physikalischen Einheit 
Verknüpfung mehrerer Eingangsgrößen zu einer neuen Größe für Darstellungszwecke 
(optional) Filterung der Darstellung basierend auf der Wassertiefe 
(optional) Filterung der Darstellung baiserend auf der Anzahl der Beobachtungen 

Danksagung: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''

|kurzbeschreibung=
Das Programm NCPLOT dient der Darstellung von Berechnungs- und Analyseergebnissen,
die im CF-NetCDF-Format abgelegt sind.
Die Daten können an Knoten (node), für Kanten (edge) oder für Polygone (face)
vorliegen. Es können 2D-, und 3D-Daten, sowie Daten mit subgridskaligen Details
verarbeitet werden. 
[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]

Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT. 
[[Beispiel-Grafiken: NCPLOT|NCPLOT: Beispiel-Grafiken]]

Grundsätzlich unterscheidet NCPLOT linienhafte von flächenhaften Diagrammtypen.
Bei flächenhaften Diagrammen ist die Symbolisierung der Daten im Allgemeinen von
ihrem Wert abhängig (Farblegende, Proportionalpfeil).
Bei linienhaften Diagrammen werden die Werte von Datenreihen an einer Achse angetragen,
die Symbolisierung der Datenreihe ist vom Datenwert unabhängig. 

[[NCPLOT: Flächenhafte Diagramme|Flächenhafte Diagramme]]:
* Karte, bzw. Draufsicht-Darstellung

[[NCPLOT: Liniendiagramme|Liniendiagramme]]: 
* Zeitreihe
* Profildarstellung
* Tiefenprofil

NCPLOT erlaubt es auf einem Bild verschiedene Diagramme unterschiedlichen Typs
darzustellen. Liniendiagramme neben flächenhaften Darstellungen mit statischen
und ggf. dynamischen Anteilen.
 

Bildserien: 
Sowohl linien- als auch flächenhafte Diagrammdefinitionen können das Erstellen von
Bildserien anfordern. Ein Plot kann somit neben statischen auch dynamische, also
über die Bildserie veränderliche Bildanteile beinhalten.
 

Damit das Programm den sich dadurch ergebenden Kombinationsmöglichkeiten irgendwie
Herr wird, gilt folgende Regel: 
Sind dynamische Diagramm-Definitionen vorhanden, so bestimmt die zuerst gelesene
dynamische Definition die erlaubte Bildserien-Länge. Ergeben andere vorhandene
dynamische Diagramm-Definitionen eine abweichende Bildanzahl bricht das Programm ab.
 

Weitere Prüfungen hinsichtlich der Sinnhaftigkeit der Daten-Adressierung zwischen
beteiligten Bildelementen werden nicht vorgenommen.
 

Verschiedene Seriendiagramme aus dynamischen Diagramm-Defintionen gleicher
Länge werden vom Programm verarbeitet. Die statischen Bildelemente finden
sich dabei auf jedem Bild der Serie.
 

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCPLOT.DAT|ncplot.dat]])
# '''Berechnungs und/oder Analyseergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# Datei mit '''Intervalldefinitionen''' von Farblegenden ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# Datei mit '''Verweisen zu Palettendefinitionen''' ([[PALETTES.CFG.DAT|palettes.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
# Datei mit '''Farbdefinitionen''' ([[COLORS.CFG.DAT|colors.cfg.dat]]) Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.

Desweiteren werden von dem Programm NCPLOT folgende Standard-Konfigurationsdateien aus dem Verzeichnis
'''$PROGHOME/cfg/''' benötigt:
:* GKS-Parameter: '''gkssystem.rechnername.dat'''

|ausgabedateien=
# '''Plot-Metafiles''' (CGM) Hinweis: Die erzeugten CGM-Dateien werden, aus verschiedenen Gründen, schnell unhandlich groß. Ein direktes Konvertieren in ein Bitmap-Format (z.B. PNG) wird empfohlen.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncplot.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)

|methode=
NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
Interaktion mit dem Anwender statt.
Das Layout des Bildes und die graphische Darstellung der Daten wird über Angaben
in den Eingabedateien des Programmes festgelegt.
 

NCPLOT erzeugt Vektorgrafiken im CGM-Format.
 

Für originale UnTRIM-Ergebnisse, d.h. für Daten die direkt von einem der UnTRIM-Programme im
CF-NetCDF-Format ausgegeben wurden, besteht die Möglichkeit, die Daten nur dann in die
Darstellung einzubeziehen, wenn am Ort eine bestimmte, minimale Wasserbedeckung gegeben ist.
 

Hinweis: '''HDF error''' 
Falls beim Lesen von Daten ein HDF error auftritt wird versucht,
die Werte des gewünschten Datenrecords aus den Werten zeitlich benachbarter
Records zu rekonstruieren (Interpolation).
Diese Reparatur funktioniert ausschließlich für von der Zeit abhängige Variablen.
 

|preprozessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

NCPLOT: Umrahmung

2020-01-24T16:16:37Z

Ak3spohr: Framing in NTN-Block verschoben

__NOAUTOLINKS__
__NOAUTOLINKTARGET__
[[en:NCPLOT: Framing]]

Diese Seite zeigt die von [[NCPLOT]] angebotenen Möglichkeiten der Umrahmung einer Karte.

Die Art der Rahmung einer Karte, wird im entsprechenden "Normalization_Transformation"-Block der Steuerdatei [[NCPLOT.DAT]] über die KEY-Zeile "NTN_Framing" und ihre beiden Eingabeparameter angefordert.
Die Angabe der Zeile ist optional. Fehlt die Zeile wird kein Rahmen geplottet.

Bei dem Rahmen kann es sich um eine einfache Umrandung oder einen ausgefeilten Koordinatenrahmen handeln.
Die Koordinatenrahmen sind für Gauß-Krüger-Werte optimiert.
Gitternetzlinien können bei der Orientierung in der Karte helfen.
 

* Key '''NTN_Framing''': Art des Koordinatenrahmens einer Draufsichtdarstellung
:* 1. Parameter: '''Art des Rahmens'''
::*'''Rechteck''' = Rechteckrahmen ohne Beschriftung
::*'''Standard''' = Rechteckrahmen mit Beschriftung unten und links
::*'''Schachlinie''' = abwechselnd kleine schwarze und weisse Rechtecke ohne Beschriftung
::*'''BSH''' = Wie Schachlinie aber mit Beschriftung oben, unten, rechts und links
::*'''BWK''' = Umrahmung ähnlich wie Bundeswasserstrassenkarten mit Beschriftung oben, unten, rechts und links
:* 2. Parameter: '''Art des Gitternetzes'''
::*'''NONE''' = kein Gitternetz darstellen
::*'''mit_x_Gitternetzlinien''' = Gitternetzlinien für die Stützstellen entlang der X-Achse darstellen
::*'''mit_y_Gitternetzlinien''' = Gitternetzlinien für die Stützstellen entlang der Y-Achse darstellen
::*'''mit_xy_Gitternetzlinien''' = Gitternetzlinien für die Stützstellen entlang beider (X und Y) Achsen darstellen
 

{| border="1"
! width="50%" | Rahmentyp: Rechteck
! width="50%" | Rahmentyp: Standard
|-
|[[Bild:NcplotBspFrameRechteck.png|zentriert|500px|Kartenrahmen vom Typ "Rechteck"]]
|[[Bild:NcplotBspFrameStandard.png|zentriert|500px|Kartenrahmen vom Typ "Standard"]]
|}
{| border="1"
! width="50%" | Rahmentyp: Schachlinie
! width="50%" | Rahmentyp: BSH
|-
|[[Bild:NcplotBspFrameSchachlinie.png|zentriert|500px|Kartenrahmen vom Typ "Schachlinie"]]
|[[Bild:NcplotBspFrameBSH.png|zentriert|500px|Kartenrahmen vom Typ "BSH"]]
|}
{| border="1"
! width="50%" | Rahmentyp: BWK
! width="50%" | Rahmen mit Gitternetzlinien
|-
|[[Bild:NcplotBspFrameBWK.png|zentriert|500px|Kartenrahmen vom Typ "BWK"]]
|[[Bild:NcplotBspFrameGrid.png|zentriert|500px|Rahmen und Netzlinien]]
|}
 

----
zurück zu [[NCPLOT.DAT]]

NCPLOT.DAT

2020-01-24T16:07:29Z

Ak3spohr: GO-konforme Units; Framing in NTN-Block verschoben

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Januar 2020
|version_beschr=Januar 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPLOT]]
|dateiinhalt=

===Block "Program_Parameters"===
Der Block '''Program_Parameters''' enthält allgemeine Steuerdaten.
* Key '''"Language" :''' Spracheinstellung für Beschriftungen und Texte:
:*'''DE''' = Deutsch,
:*'''EN''' = Englisch.
* Key '''"Max_Read_Storage" :''' max. Lesespeicher (in Byte) für Analysen
* (optional) Key '''"Min_Water_Depth" :''' minimale Wasserbedeckung in [m].
:Hinweis: Das Aussparen der Darstellung bei zu geringer Wasserbedeckung ist nur möglich, wenn die darzustellende Variable auf bestimmte Weise auf eine Variable mit der zugehörige Gesamtwassertiefe verweist. Die CF-NetCDF-Ausgabe der UnTRIM-Programme erfüllt diese Voraussetzung. Die Seite '''''[[NCPLOT: Min_Water_Depth]]''''' illustriert die Wirkung dieses Steuerparameters.
* (optional) Key '''"Infobox_Plot_Area" :''' Bildbereich für die Metadaten-Infobox.
:Bei Angabe dieses Bildbereichs werden der Grafik Informationen zur Ploterstellung mitgegeben. Dazu gehören auch Angaben zu den zugrundeliegenden Datendateien sowie Hinweise auf ggf. bei der Darstellung eingesetzte Datenfilterung.
* (optional) Key '''"PLR_Representation" :''' Grundeinstellung für Liniensymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Representation" :''' Grundeinstellung für Markersymbol von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PLR_Palette" :''' Farbpalette und Startfarbe für Liniensymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"PMR_Palette" :''' Farbpalette und Startfarbe für Markersymboliserung von Datenreihen in Liniendiagrammen.
* (optional) Key '''"Picture_Name_Fixum" :''' Namensstamm für CGM-Ausgabedatei.
* (optional) Key '''"Phydef_Units" :''' Physikalische Einheiten wie in PHYDEF-Verwaltung darstellen.
:Hinweis: Ohne explizite Anforderung erfolgt die Darstellung der Einheiten gemäß BAW-Geschäftsordnung.

===Block "Dataset"===
Ein Block vom Typ '''Dataset''' enthält die Beschreibung eines darzustellenden Datensatzes. 
 
Für die Adressierung der darzustellenden Daten steht entweder die Start-Step-Stride-Technik oder die DimSelect-Methode zur Verfügung. Der Anwender muss sich für den einen oder anderen Weg entscheiden, die Verfahren schließen sich gegenseitig aus.
Jede Start-Step-Stride-Adressierung läßt sich per DimSelect nachbauen, andersherum ist das nicht
der Fall. Da mit DimSelect auch nicht-äquidistante Indexauswahl realisiert werden kann, bietet es
zusätzliche Möglichkeiten der Datenauswahl.
;Start-Step-Stride-Technik:
:Für jede Dimension der Variablen wird der Startindex, die Anzahl der auszuwählenden Indizes und die Index-Schrittweite angegeben. Die Seite '''''[[NCPLOT: DataSet definieren]]''''' hilft beim Start-Step-Stride-Adressieren der gewünschten Daten.
;DimSelect-Methode:
:Auch DimSelect erfordert für jede Dimension der darzustellenden Datenvariablen die Adressierung der Indizes, was aber auch indirekt geschehen kann. Es werden unterschiedlich geeignete Auswahlverfahren bereitgestellt. Der Anwender kann bspw. per DimSelect_All alle Faces auswählen ohne die konkrete Anzahl zu kennen, oder dem Programm per DimSelect_Various_Date eine Auswahl an darzustellenden Zeitpunkten übergeben. Das Auffinden der zugehörigen Indizes obliegt dann dem Programm. Im Zusammenhang mit Datenreihen von Liniendiagrammen bietet die DimSelect-Auswahl einen weiteren Vorteil: Für die einzelnen Dimensionen der Datenvariablen lassen sich über diese Mimik Textbestandteile für die Namen der Datenreihen/Kurvenlegende realisieren. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Datensatzes.
* Key '''"File" :''' Name der CF-NetCDF-Datei (*.nc) mit den darzustellenden Daten.
* Key '''"Variable" :''' Beschreibung der Daten deren Werte visualisiert werden sollen.
:* Parameter '''1''' = Name der Variablen (in *.nc Datei)
:* (optional) Parameter '''2''' = Rolle der Variablen bei Vektor-Komponenten
::* X-component = Variable ist X-Komponente eines Vektors
::* Y-component = Variable ist Y-Komponente eines Vektors
::* normal_component = Variable ist Normalkomponente eines Vektors
:Hinweis: Der Befehl "ncdump -h <filename>.nc" zeigt den Header der CF-NetCDF-Datei. Die Namen der angebotenen Variablen und deren Dimensionierung lassen sich den Metadaten entnehmen.
* (optional) Key '''"Start" :''' Startadresse für die darzustellenden Daten.
* (optional) Key '''"Step" :''' Anzahl der auszuwählenden Indizes (Schritte+1) für die darzustellenden Daten.
* (optional) Key '''"Stride" :''' Index-Schrittweite für die darzustellenden Daten.
* (optional) Key '''"DimSelect_EquiDist_Index" :''' Äquidistante Auswahl von Indizes für eine bestimmte Dimension. Exemplarisch:
:* Parameter '''1''' = Name der Dimension
:* Parameter '''2''' = NONE oder Textbestandteil für Kurvenlegende
:* Parameter '''3''' = Index wird Teil der Kurvenlegende .true./.false.
:* Parameter '''4''' = Start-Index
:* Parameter '''5''' = Index-Schrittweite
:* Parameter '''6''' = Anzahl der Schritte
* (optional) Key '''"DimSelect_EquiDist_Date" :''' Äquidistante Auswahl von Zeitpunkten.
* (optional) Key '''"DimSelect_StartEnd_Index" :''' Auswahl aller Indizes von Start- bis End-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis End-Zeitpunkt.
* (optional) Key '''"DimSelect_Single_Index" :''' Auswahl eines bestimmten Index.
* (optional) Key '''"DimSelect_Single_Date" :''' Auswahl eines bestimmten Zeitpunktes.
* (optional) Key '''"DimSelect_Various_Index" :''' Liste beliebiger Indizes.
* (optional) Key '''"DimSelect_Various_Date" :''' Liste beliebiger Zeitpunkte.
* (optional) Key '''"DimSelect_All" :''' Auswahl aller Indizes einer Dimension.
* (optional) Key '''"DimSelect_ByLabel_LabVar" :''' Indizes mit Liste von Namen per Label-Variable ermitteln.
* (optional) Key '''"DimSelect_ByLabel_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_ByLabel_LabVar".
* (optional) Key '''"DimSelect_Location_Coord" :''' Auswahl von Orten über Koordinatenangabe.
* (optional) Key '''"DimSelect_LocByFile_File" :''' Auswahl von Orten aus Datei mit Lokationen.
* (optional) Key '''"DimSelect_LocByFile_List" :''' Fortsetzungszeile(n) zu Key "DimSelect_LocByFile_File".
* (optional) Key '''"Dimensions_for_Picture_Series" :''' Anforderung von Einzeldarstellungen für ausgewählte Dimensionen.
:Hinweis: Veranlasst Serienverarbeitung, d.h. für jeden selektierten Index der hier gelisteten Dimensionen wird ein eigenes Bild erzeugt. Wirkt nur bei Liniendiagrammen. Bildserien, d.h. mehr als eine Bilddatei wird erzeugt, müssen gleich lang sein!

===Block "Layer"===
Ein Block vom Typ '''Layer''' definiert ein flächenhaftes Diagramm. Derzeit ist nur die Darstellung in horizontaler Ebene, d.h. Draufsicht-Darstellung realisiert. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name des Layers.
* Key '''"Layer_Dataset_Name" :''' Name des Datensatzes, der dargestellt werden soll. Oder eine zulässige Verknüpfung (OPERATOR-String) aus bekannten Datensatz Namen, z. B. '''[DSet2-DSet1]/[DSet1+DSet2]''', '''ABS[DSet]''', '''SQR[DSet]''' oder '''G18[DSet]'''.
* Key '''"Layer_Normalization_Transformation_Name" :''' Name der Normalisierungstransformation für diesen Layer.
* Key '''"Layer_Type" :''' Art der Darstellung des Layers.
:Hinweis: Derzeit nur XY_data = horizontale Ebene, bzw. Draufsicht implementiert.
* Key '''"Layer_Primitive_Name" :''' Grafik-Primitiv mit dem die Daten des Layers visualisiert werden.
:* Parameter '''1''' = Symbolisierung des Layers
::*'''GPM''' = als Poly-Marker
::*'''GPL''' = als Poly-Lines
::*'''GFA''' = als Fill-Areas
::*'''GTX''' = als Text
::*'''VEC''' = als Vektoren
:* (optional) Parameter '''2''' = Art des dargestellten Vektors ... optionaler Parameter, nur bei VEC-Visualisierung zulässig ... erlaubt bspw. die Interpolation des Gesamtvektors aus der Normalkomponente einer vektoriellen Größe.
::*'''total''' = Gesamtvektor
::*'''normal''' = Normalenvektor
* Key '''"Layer_Primitive_Representation_Name" :''' Name der Repräsentation, die das Grafik-Primitiv des Layers umsetzt.
* Key '''"Layer_Bounds_Name" :''' Name der Intervalldefinition für diesen Layer (aus Datei '''''[[BOUNDS.CFG.DAT|bounds.cfg.dat]]''''').
:Hinweis: Die Anzahl der Intervalle der Intervalldefinition und die Anzahl der Farben der zugeordneten Palette müssen übereinstimmen.
* Key '''"Layer_Palette_Name" :''' Name der Farblegende für diesen Layer (entspricht Attribut ''Name'' der Datei vom Typ ''palette.dat''. Mehr Information dazu liefert Dateikennblatt '''''[[PALETTES.CFG.DAT|palettes.cfg.dat]]''''').
* Key '''"Layer_Invert_Palette" :''' Farbverlauf invertieren.
* (optional) Key '''"Layer_Legend_Plot_Area" :''' Bildbereich für die Farb-Legende dieses Layers. Je nach Platz kann die Farblegende horizontal oder vertikal aufgetragen werden.
* (optional) Key '''"Layer_Legend_Label_Switch" :''' Schalterliste zum Abschalten, bzw. Positionieren von Labels der Farblegende.
* (optional) Key '''"Layer_Data_Description_Name" :''' Name des Data_Description-Textfeldes, welches die Daten-Beschriftung (u.a. Angabe des Zeitpunktes) dieses Layers aufnimmt.
* (optional) Key '''"Layer_Display_Units" :''' Physikalische Einheit, in die die Daten für die grafische Darstellung konvertiert werden sollen.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Layer_Display_Name" :''' Name der physikalischen Größe, wird an Stelle des in den Eingabedaten vorhandenen Namens verwendet. Ohne diese Zeile wird bei vorhandenem Attribut '''''name_id''''' die PHYDEF-Bezeichnung eingesetzt. Dynamische Textteile können mit speziellen Platzhaltern realisiert werden:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
* (optional) Key '''"Layer_Vector_Legend_Plot_Area" :''' Bildbereich für die Längen-Legende zu einem Proportionalpfeil.
* (optional) Key '''"Layer_Vector_Thinout_Raster" :''' Abmessungen des Rasters für das Ausdünnen der Anzeige von Pfeilen bei vektoriellen Größen.
* (optional) Key '''"Layer_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.
* (optional) Key '''"Layer_Description_Textbox" :''' Name einer Textbox, die mit dem Layer verknüpft werden soll.

===Block "Normalization_Transformation"===
Der Block '''Normalization_Transformation''' enthält die Normalisierungstransformation (NTN),
die der Positionierung von Kartenfenstern dient.
Es handelt sich dabei um die Definition eines Bildausschnitts und die Beschreibung des
Zusammenhangs zwischen Welt- und Bild-Koordinaten. 
Ein Block diesen Typs wird nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Die Koordinaten der Zeichenfläche, dem sogenannten NDC-Raum, reichen von [0.0,0.0] bis [1.0,1.0]. 
Für eine unverzerrte Darstellung des Gebietes muss der Darstellungs-Maßstab in X-Richtung
mit dem in Y-Richtung übereinstimmen (dWC/dNDC=const);
optional kann hierfür auch der Key '''"Autoscale"''' genutzt werden.
Verzerrte Darstellungen sind aber auch möglich. 
* Key '''"Name" :''' eindeutiger Name der Normalisierungstransformation.
* Key '''"EPSG" :''' EPSG-Code der "Window_Coordinates".
* Key '''"EPSG_Window" :''' EPSG-Code der Koordinaten wie sie intern (zur grafischen Darstellung) verwendet werden sollen.
* Key '''"Left_Lower_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_Window_Coordinates" :''' Welt-Koordinaten (WC gemäß EPSG) der rechten oberen Ecke des Projektionsfensters.
* Key '''"Left_Lower_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der linken unteren Ecke des Projektionsfensters.
* Key '''"Right_Upper_NDC_Coordinates" :''' Bild-Koordinaten (NDC innerhalb [0.0,1.0]) der rechten oberen Ecke des Projektionsfensters.
* (optional) Key '''"Autoscale"''' : automatische Angleichung (.true.) des Maßstabs in X- und Y-Richtung. Default ist .false. (keine Angleichung).
* (optional) Key '''"Scale_Bar_Request"''' : Zeichnen eines Maßstabsbalkens anfordern. Autoscale muss dazu eingeschaltet sein.
* Key '''"NTN_Framing" :''' Art des Koordinatenrahmens bei Draufsichtdarstellung.
:Hinweis: Weitere Info unter '''''[[NCPLOT: Umrahmung|Optionen Kartenrahmen]]'''''.

===Block "Data_Description"===
Der Block '''Data_Description''' beschreibt ein Data_Description-Objekt.
Ein derartiges Objekt sammelt Daten-Beschreibungen auf und stellt sie gemeinsam
in einem Textfeld dar. 
Ein Block diesen Typs wird derzeit nur bei flächenhafter Darstellung in horizontaler Ebene, bzw. Draufsicht-Darstellung (Layer-Definition mit Type==XY_Data) benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Data_Desc_Name" :''' eindeutiger Name des Textfeldes für Daten-Beschreibungen.
* Key '''"Data_Desc_Plot_Area" :''' Bildbereich für das Data_Description-Textfeld.
* (optional) Key '''"Data_Desc_Draw_Frame" :''' Rahmen um Data_Description-Textfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Data_Desc_Color_Name" :''' Name der Farbe für Schrift und Umrandung.

===Block "LineChart"===
Der Block '''LineChart''' dient der Definition eines Liniendiagramms. 
Ein "LineChart" besitzt jeweils nur eine X- und eine Y-Achse.
Eine sekundäre Y-Achse muss über die Definition eines zweiten LineChart-Objekts
auf der gleichen Zeichenfläche mit derselben X-Achse realisiert werden. 
Beliebig viele LineCharts können aufeinander gelegt werden, die zugehörigen
Achsen können an allen vier Seiten des Diagramms positioniert werden und von
der Zeichenfläche auch verschieden weit abgerückt werden.
So läßt sich bspw. auf dem Blatt "ein" Zeitreihendiagramm erzeugen, dass
die Kurven für Strömungsbetrag, Strömungsrichtung und Salzghalt gemeinsam
darstellt und dafür drei Y-Achsen besitzt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"LineChart_Name" :''' eindeutiger Name des Liniendiagramms.
* Key '''"LineChart_Type" :''' Art des Liniendiagramms.
:*'''TG''' = Zeitreihen; Daten über die Zeit
:*'''PG''' = Profildiagramm; Daten über Profilachse
:*'''GZ''' = Tiefenprofil; 3D-Daten entlang Tiefenachse
* Key '''"LineChart_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird.
* Key '''"LineChart_Extent" :''' Gesamtfläche, die das Diagramm auf dem Bild einnimmt.
* Key '''"LineChart_X-Axis" :''' X-Achse des Diagramms und ihre Positionierung.
* Key '''"LineChart_Y-Axis" :''' Y-Achse des Diagramms und ihre Positionierung.
* (optional) Key '''"LineChart_Legend_Box" :''' Name einer Legend_Box, d.h. dem Bereich in dem die Kurvenlegenden des Diagramms abgelegt werden.
* (optional) Key '''"LineChart_Route_Dataset" :''' Dataset mit Profilroute für das Sortieren und Filtern darzustellender Daten.
* (optional) Key '''"LineChart_PLR_Representation" :''' Liniensymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PMR_Representation" :''' Markersymboliserung für die Datenreihen dieses Diagramms.
* (optional) Key '''"LineChart_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung des Diagramms.
* (optional) Key '''"LineChart_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung des Diagramms.

===Block "Axis"===
Der Block '''Axis''' dient der Definition einer Diagrammachse. 
Eine Achsendefinition kann für mehrere Diagramme verwendet werden.
Bspw. aufeinanderliegende "LineCharts" oder mehrere untereinander
angeordnete Diagramme mit derselben Zeit-Achse. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Axis_Name" :''' eindeutiger Name der Achsendefinition.
* Key '''"Axis_Type" :''' Art der Achse.
:*'''T''' = Zeitachse
:*'''G''' = Achse für physikalische Größen
:*'''P''' = Profilachse
:*'''Z''' = Tiefenachse
* (optional) Key '''"Axis_Value_Range" :''' Wertebereich der Achse.
* (optional) Key '''"Axis_Date_Range" :''' Zeitbereich der Achse.
* (optional) Key '''"Axis_Scale_Logarithmic" :''' Logarithmische Skalierung LOG10 einschalten TRUE/FALSE.
* (optional) Key '''"Axis_Invert_Profile_Route" :''' Streckenverlauf einer Profil-Achse umkehren TRUE/FALSE.
* (optional) Key '''"Axis_Scale_Multiplicator" :''' Mulitiplikator für die Achsenskalierung.
* (optional) Key '''"Axis_Display_Name" :''' Bezeichnung an der Achse.
* (optional) Key '''"Axis_Display_Unit" :''' physikal. Einheit, in welche die Daten dargestellt, bzw. ggf. konvertiert werden.
:Hinweis: Die Einheit in der die Daten vorliegen und die Ziel-Einheit müssen in der Standard-Konfigurationsdatei '''''phydef.cfg.si.dat''''' bekannt und dürfen sich bezüglich ihrer SI-Basis (Dimension) nur in den Dimensionen Länge (Exponent +3 +2 +1 -1 -2 -3) und Zeit (Exponent +1 -1) unterscheiden.
* (optional) Key '''"Axis_Labels_EquiDist_Value" :''' äquidistante Werte für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_EquiDist_Date" :''' äquidistante Termine für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Values" :''' Liste mit Werten für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Labels_at_Dates" :''' Liste mit Terminen für Beschriftung entlang der Achse.
* (optional) Key '''"Axis_Line_Representation" :''' Name einer Poly_Line_Representation für die Darstellung der Achsenlinie.
* (optional) Key '''"Axis_Text_Representation" :''' Name einer Text_Representation für die Achsenbeschriftung (nur Beeinflussung der Schrift-Farbe).
* (optional) Key '''"Gitternetz_Representation" :''' Name einer Poly_Line_Representation für die Gitternetzlinien oder mit NONE diese Linien abschalten.
* (optional) Key '''"Tickmark_Representation" :''' Formatierung oder auch Abschalten der Achsen-Tickmarks.
:* Parameter '''1''' = Name einer Farbe für die Tickmarks
:* Parameter '''2''' = Breite der Tickmark-Linie
:* Parameter '''3''' = Länge der Tickmarks in Bildkoordinaten; 0.0 schaltet sie ab!
* (optional) Key '''"Axis_Additional_Line_Value" :''' bei bestimmten Wert zusätzliche Linie senkrecht zur Achse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Date" :''' an bestimmten Termin zusätzliche Linie senkrecht zur Zeitachse anzeichnen.
* (optional) Key '''"Axis_Additional_Line_Coord" :''' an bestimmten Positionen zusätzliche Linie senkrecht zur Profilachse anzeichnen.
* (optional) Key '''"Characters_along_Axis" :''' erlaubt die Manipulation der Schriftgröße der Achsenbeschriftung.

===Block "DataRow"===
Ein '''DataRow'''-Block dient der Beschreibung einer Datenreihe, bzw. einer Gruppe
von Datenreihen. 
Aus einer Datenreihen-Beschreibung können aufgrund der Daten-Adressierung
im "DataSet" mehrere Datenreihen hervorgehen.
Alle diese Datenreihen landen im selben "LineChart". 
Blöcke diesen Typs werden für Liniendiagramme benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"DataRow_Name" :''' eindeutiger Name der Datenreihen-Beschreibung.
* Key '''"DataRow_Dataset" :''' Name des darzustellenden Datensatzes. Oder eine zulässige Verknüpfung (OPERATOR-String) von Datensätzen.
* Key '''"DataRow_LineChart" :''' Name eines "LineCharts", d.h. des Liniendiagramms in das die Datenreihe(n) gezeichnet werden sollen.
* (optional) Key '''"DataRow_PLR_Representation" :''' Liniensymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PMR_Representation" :''' Markersymboliserung für diese Datenreihen.
* (optional) Key '''"DataRow_PLR_Palette" :''' Farbpalette und Startfarbe für die Liniensymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_PMR_Palette" :''' Farbpalette und Startfarbe für die Markersymboliserung dieser Datenreihen.
* (optional) Key '''"DataRow_NoValue_Handling" :''' Umgang mit ungültigen Werten in der Datenreihe.
:*'''Luecke''' = stellt Punkte ohne Daten nicht dar
* (optional) Key '''"DataRow_NOBS_Filter" :''' Filterung der Darstellung der Ergebnisse mit Hilfe einer ''ancillary variable'' des Typs ''number of observations'' (Anzahl-Filter):
** Parameter 1: Typ des Filters:
*** '''EQ''' = stelle die Daten nur für eine bestimmte Anzahl von Eingangsdaten dar;
*** '''LE''' = stelle die Daten nur für weniger oder gleich einer bestimmten Anzahl von Eingangsdaten dar;
*** '''GE''' = stelle die Daten nur für mehr oder gleich einer bestimmten Anzahl von Eingangsdaten dar.
** Parameter 2: Wert des Filters:
*** '''0''' = maximale Anzahl der Ereignisse in den Eingangsdaten;
*** '''N''' = eine bestimmte Anzahl von Ereignissen in den Eingangsdaten;
*** '''-M''' = maximale Anzahl der Ereignisse in den Eingangsdaten minus M.

===Block "Legend_Box"===
Eine Legendenbox sammelt Bezeichnung und Symbolisierung von Datenreihen, bzw. Kurven auf
und stellt sie gemeinsam in einem Textfeld dar.
In einem Legendenfeld können Kurvenbeschreibungen aus verschiedenen Diagrammen
untergebracht sein. 
Ein Block diesen Typs wird nur von Liniendiagrammen benötigt. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Legend_Box_Name" :''' eindeutiger Name des Legendenfeldes.
* Key '''"Legend_Box_Plot_Area" :''' Bildbereich für das Legendenfeld.
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Color_Name" :''' Name der Farbe fuer Schrift und Umrandung.

===Block "Textbox"===
Ein Block vom Typ '''Textbox''' bietet die Möglichkeit einen freien Text anzugeben. 
Eine leere Textbox kann als rechteckige Umrandungen fungieren, wobei Farbe, Typ und Breite
der Linie einstellbar sind.
Gibt man der Textbox eine Hintergrundfarbe mit kann man sie als Blende nutzen, mit der sich
Diagrammbereiche abdecken lassen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Textbox.
* Key '''"Plot_Area" :''' Bildbereich für die Textbox.
* (optional) Key '''"Text_Line" :''' eine Zeile des Textfeldes. Angabe mehrere Zeilen möglich. Platzhalter für Systeminformationen:
:*<SYS_DATE> wird durch aktuelles Datum ersetzt.
:*<SYS_TIME> wird durch aktuelle Uhrzeit ersetzt.
:*<SYS_USER> wird durch Anwender-Kennung ersetzt.
:Platzhalter für Textbox, die mit einem Layer verbunden ist:
:*<LAY_DSET> wird durch Kennung des mit dem Layer verknüpften Datasets ersetzt.
:*<LAY_DIM1> wird durch Infotext zu 1. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM2> wird durch Infotext zu 2. Dimension des dargestellten Datensatzes ersetzt.
:*<LAY_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im Layer-Block per KEY ''Layer_Description_Textbox'' realisiert.
* (optional) Key '''"Color_Name" :''' Farben des Textfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Draw_Frame" :''' Umrandung des Textfeldes zeichnen oder nicht.
* (optional) Key '''"Frame_Style" :''' Aussehen der Textfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Fixed_Width" :''' Zeichenweise mit konstanter Breite schreiben oder nicht.
* (optional) Key '''"Horizontal_Char_Space" :''' Horizontaler Zeichen-Abstandsfaktor beim zeichenweisen Schreiben.
* (optional) Key '''"Vertical_Line_Space" :''' Vertikaler Zeilen-Abstandsfaktor.
* (optional) Key '''"Font_Size" :''' Schriftgröße kann ggf. vorgegeben werden.
* (optional) Key '''"Font_Size_Factor" :''' Faktor zum Manipulieren der berechneten Schriftgröße.

===Block "Poly_Marker_Representation"===
Ein Block vom Typ '''Poly_Marker_Representation''' beschreibt die Darstellung einer Sorte von Marker-Symbolen. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Marker Repräsentation.
* Key '''"Poly_Marker_Type" :''' Typ-ID der Poly-Marker.
:*'''1''' = .
:*'''2''' = +
:*'''3''' = *
:*'''4''' = o
:*'''5''' = x
* Key '''"Poly_Marker_Size" :''' Größenfaktor der Poly-Marker.
* Key '''"Poly_Marker_Color_Name" :''' Name der Farbe für die Poly-Marker.
* (optional) Key '''"Poly_Marker_Coli" :''' Farbindex der Poly-Marker.

===Block "Fill_Area_Representation"===
Ein Block vom Typ '''Fill_Area_Representation''' beschreibt eine Art von Flächenfüllung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Fill-Area Repräsentation.
* Key '''"Fill_Area_Interior_Style" :''' Art der Flächen-Füllung.
:*'''0''' = HOLLOW (nur Umrandung zeichnen)
:*'''1''' = SOLID (flächenhaft füllen)
:*'''2''' = PATTERN (Musterfüllung - derzeit nicht unterstützt)
:*'''3''' = HATCH (Schraffur - derzeit nicht unterstützt)
* Key '''"Fill_Area_Color_Name " :''' Name der Farbe für die Flächen-Füllung.
* (optional) Key '''"Fill_Area_Style" :''' Stil-Index der Flächen-Füllung.
* (optional) Key '''"Fill_Area_Coli" :''' Farbindex der Flächen-Füllung.

===Block "Poly_Line_Representation"===
Ein Block vom Typ '''Poly_Line_Representation''' beschreibt eine Form der Linien-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Poly-Line Repräsentation.
* Key '''"Poly_Line_Type" :''' Typ der Poly-Linien.
:*'''1''' = --------- durchgezogene Linie
:*'''2''' = - - - - - gestrichelte Linie
:*'''3''' = ......... punktierte Linie
:*'''4''' = -.-.-.-.- strich-punktierte Linie
* Key '''"Poly_Line_Width" :''' Breitenfaktor der Poly-Linien.
* Key '''"Poly_Line_Color_Name" :''' Name der Farbe für die Linien.
* (optional) Key '''"Poly_Line_Coli" :''' Farbindex der Poly-Linien.

===Block "Text_Representation"===
Ein Block vom Typ '''Text_Representation''' beschreibt eine Art der Text-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Text Repräsentation.
* Key '''"Text_Character_Height" :''' Zeichenhöhe der Texte.
* Key '''"Text_X_Character_Up_Vector" :''' X-Komponente des Character-Up-Vektors.
* Key '''"Text_Y_Character_Up_Vector" :''' Y-Komponente des Character-Up-Vektors.
:Hinweis: Über den Character-Up-Vektor kann die Orientierung der Basislinie der Schrift sowie deren Schrägstellung beeinflusst werden.
* Key '''"Text_Color_Name" :''' Name der Farbe für die Texte.
* (optional) Key '''"Text_Path" :''' Laufrichtung der Schrift.
* (optional) Key '''"Text_Horizontal_Alignment" :''' horizontale Textausrichung der Schrift.
* (optional) Key '''"Text_Vertical_Alignment" :''' vertikale Textausrichtung der Schrift.
* (optional) Key '''"Text_Font" :''' Zeichensatz.
* (optional) Key '''"Text_Precision" :''' Qualität des Zeichensatzes.
* (optional) Key '''"Text_Character_Expansion_Factor" :''' Laufweite eines Zeichens (Standard = 1.0).
* (optional) Key '''"Text_Character_Spacing" :''' zusätzlicher Leerraum zwischen Zeichen (Standard = 0.0).
* (optional) Key '''"Text_Coli" :''' Farbindex für die Texte.

===Block "Vector_Representation"===
Ein Block vom Typ '''Vector_Representation''' beschreibt eine Form der Vektor-Darstellung. 
Steuerdatei kann mehrere Blöcke diesen Typs enthalten.
* Key '''"Name" :''' eindeutiger Name der Vektor Repräsentation.
* Key '''"Vector_Length_Type" :''' Längen-Abhängigkeit des Pfeils vom Vektorbetrag.
:*'''constant''' = Alle Pfeile sind gleich groß
:*'''proportional''' = Größe des Pfeils ist abhängig von Vektorbetrag
* Key '''"Vector_Symbol_Scale_Infos" :''' Informationen zur Skalierung des Vektor-Symbols.
:* Parameter '''1''' = Vektorbetrag, unterhalb dessen keine Symbolisierung mehr erfolgt
:* Parameter '''2''' = Länge des Symbols (in WC, analog Text_Character_Height)
:* (optional) Parameter '''3''' = Vektorbetrag, der mit der in Parameter '''2''' angegebenen Symbollänge visualisiert wird (nur bei Proportionalpfeilen nötig)
* Key '''"Vector_Symbol_Style" :''' Typ des Vektor-Symbols.
:*'''only_a_line''' = nur eine Linie
:*'''simple_arrowL''' = ein einfacher Pfeil nur aus Linienzügen
:*'''simple_arrowF''' = ein einfacher Pfeil mit gefüllter Pfeilspitze
:*'''triangle''' = ein Dreieck
:*'''arrow_deluxe''' = ein Luxus-Pfeil, der auch OUTLINE und HOLLOW ermöglicht
:Hinweis: Weitere Info unter '''''[[NCPLOT: Vektor-Symbole]]'''''.
* Key '''"Vector_Poly_Line_Representation" :''' Name der Poly-Line Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* Key '''"Vector_Fill_Area_Representation" :''' Name der Fill-Area Repräsentation, die ggf. beim Zeichnen des Pfeils zum Einsatz kommt.
* (optional) Key '''"Vector_Anchor_Point" :''' Rotations-, bzw. Ankerpunkt des Vektors.
:*'''start''' = Pfeil dreht um seinen Anfangspunkt
:*'''center''' = Pfeil dreht um seine Mitte (ist Default)
:*'''end''' = Pfeil dreht um seine Spitze
* (optional) Key '''"Vector_Head_Angle" :''' Winkel für die Pfeilspitze in Grad (Default:40.0).
* (optional) Key '''"Vector_Symbol_Proportions" :''' Proportionen des Vektor-Symbols.
:* Parameter '''1''' = Verhältnis Kopflänge zu Gesamtlänge (Default:0.375)
:* Parameter '''2''' = Verhältnis Stielbreite zu Kopfbreite (Default:0.5)

===Anmerkungen:===
# Beim Lesen der Daten wird automatisch auch auf die '''Dictionary-Datei''' '''''ncplot_dico.dat''''' in dem Verzeichnis '''''$PROGHOME/dic/''''' zugegriffen.
# Falls keine entsprechenden Dateien im Arbeitsverzeichnis vorliegen, greift NCPLOT auf folgende Konfigurationsdateien aus dem Verzeichnis '''''$PROGHOME/cfg/''''' zu:
#* '''''colors.cfg.dat''''': Datei mit Definitionen von Farben.
#* '''''palettes.cfg.dat''''': Datei mit Verweisen auf Dateien mit Farbpaletten-Definitionen.
#* '''''bounds.cfg.dat''''': Datei mit Intervalldefinitionen für Legenden. Hinweis: Die Bounds-Datei sollte besser projektspezifisch im Arbeitsverzeichnis angelegt werden.
# Des weiteren werden von dem Programm folgende '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''' benötigt:
#* '''gkssystem.rechnername.dat''': Datei mit GKS-Parametern.
#* '''phydef.cfg.si.dat''': Konfigurationsdatei für Einheiten und deren Bezug zum SI-System.
|nutzerprogramme=[[NCPLOT]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncplot/*/mod_m_ncplot_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

Harmonische Analyse der Strömung

2019-12-16T14:35:58Z

Ak3spohr: Tidal_current_ellipse_definition.gif durch Tidal_current_ellipse_definition.png ersetzt

[[en:Harmonic Analysis of Current Velocity]]
[[Kategorie:Partialtiden]]

=Motivation=

Die Strömung kann für jeden Ort in einem Ästuar in einen durch die Gezeiten bedingten (periodischen) Anteil und den Rest (aperiodischer Rest) zerlegt werden.
Der periodische Anteil wird dabei von den Partialtiden, also den astronomischen Tiden und den Flachwassertiden dominiert.

[[Datei:Tidal_current_ellipse_definition.png|200px|thumb|right|Definition Tide-Ellipse]]
Für jede Partialtide ergibt sich eine Tide-Ellipse, welcher von der Spitze des Strömungsvektors einmal in jeder Periode (der Partialtide) durchlaufen wird
(siehe nebenstehendes Bild). Charakteristische Parameter sind der Wert der großen sowie der kleinen Halbachse der Tide-Ellipse,
deren Neigunggswinkel gegen z. B. Ost, sowie deren Exzentrizität.
Je nach Exzentrizität degeneriert die Ellipse entweder zu einem Kreis (Exzentrizität +1.0 oder -1.0) oder einer Geraden (Exzentrizität 0.0).
Mit diesen Parametern der Partialtiden können die tidebedingten Anteile an der lokalen Strömungsgeschwindigkeit quantifiziert werden.
Der aperiodische Rest ergibt sich überwiegend aus den Einflüssen von Abfluss, Meteorologie sowie lokalen topografischen Besonderheiten.

=Grundlagen=

Grundlegende Informationen zu dem Thema ''Harmonische Analyse'' werden in [[Harmonische Analyse des Wasserstands]] dargelegt.
Die bei der Berechnung der Parameter von Tide-Ellipsen in dem Programm [[NCANALYSE]] eingesetzten Methoden werden in
[[Medium:zhigang_xu_2000_ellipse_parameters_conversion.pdf|zhigang_xu_2000_ellipse_parameters_conversion.pdf]]
ausführlich beschrieben.

Der Ablauf der Berechnung ist wie folgt (die in Klammern angegebenen Bezeichnungen beziehen sich auf die Gleichungsnummern in Zhigang Xu (2000)):
# Berechne Amplitude und Phase für die u-Komponente (x- oder Ost-Komponente) der Strömung (Gl. 1).
# Berechne Amplitude und Phase für die v-Komponente (y- oder Nord-Komponente) der Strömung (Gl 2).
# Ermittle die äquivalenten komplexen Formulierungen für u und v (Gl. 9 und Gl. 10).
# Leite daraus die entsprechenden, ebenfalls komplexen Formulierungen für die (mathematisch) positiv sowie negativ rotierenden kreisförmigen Komponenten ab (Gl. 7 und Gl. 8). Aus deren Überlagerung folgt die Tide-Ellipse.
# Berechne aus den zuletzt genannten (komplexen) Formulierungen jeweils Betrag und Phase der positiv und negativ rotierenden Komponente.
# Damit können große und kleine Halbachse (Gl. 14 und Gl. 19), deren Orientierung (Gl. 15 und Gl. 20) sowie die Exzentrizität (Gl. 21) berechnet werden.
Die vorstehenden Berechnungen müssen für jede Partialtide durchgeführt werden.

=Definition der Kennwerte=

Für die Analyse wird die Least Square Fit Methode (LSQF) verwendet.
In dem Programm [[NCANALYSE]] wird hierfür u. a. auf Methoden des Softwarepaketes LAPACK zurückgegriffen.

Alle Größen werden ausschließlich für dauerhaft überflutete Gebiete berechnet.

Für jede Partialtide werden die nachfolgend aufgezählten Größen ermittelt.

==Residuelle Strömungsgeschwindigkeit==

Residuelle Strömungsgeschwindigkeit (aus Partialtidenanalyse) innerhalb des Analysezeitraums.
Diese Größe beschreibt den nicht durch Partialtiden erklärbaren Anteil an der Strömungsgeschwindigkeit.
Dieser aperiodische Rest hängt einerseits von Abfluss, Meteorologie und lokalen topografischen Besonderheiten ab, ist
zusätzlich aber auch von der Anzahl der in der Analyse benutzten Partialtiden abhängig.


==Amplitude und Phase der Partialtiden==

Die nachfolgenden Größen bilden die Basis zur späteren Berechnung verschiedener Parameter von Tide-Ellipsen.
Zusätzlich werden für alle vier Größen auch Standard-Fehler berechnet, die aber hier nicht mit aufgeführt werden.
Diese Größen sind i.d.R. für eine Visualisierung ungeeignet.

===Amplitude der u-Komponente===

Amplitude der u-Komponente (x- oder Ost-Komponente) einer Partialtide.


===Amplitude der v-Komponente===

Amplitude der v-Komponente (y- oder Nord-Komponente) einer Partialtide.


===Phase der u-Komponente===

Phase (in Grad) der u-Komponente (x- oder Ost-Komponente) einer Partialtide.


===Phase der v-Komponente===

Phase (in Grad) der v-Komponente (y- oder Nord-Komponente) einer Partialtide.


==Parameter von Tide-Ellipsen==

Aus den zuvor aufgeführten vier Größen (Amplituden, Phasen) können alle nachfolgenden Parameter für Tide-Ellipsen, wie eingangs skizziert, berechnet werden.

===Große Halbachse der Tide-Ellipse===

Große Halbachse einer Partialtide. Bezeichnet die maximale Strömungsgeschwindigkeit (der Partialtide) innerhalb einer Periode der Partialtide.


===Kleine Halbachse der Tide-Ellipse===

Kleine Halbachse einer Partialtide. Bezeichnet die minimale Strömungsgeschwindigkeit (der Partialtide) innerhalb einer Periode der Partialtide.


===Richtung der großen Halbachse der Tide-Ellipse===

Bezeichnet die (mathematisch positive) Richtung (-180.0 bis 180.0 Grad) der großen Halbachse einer Partialtide.
Beschreibt die Richtung, in welcher die maximale Strömungsgeschwindigkeit der Partialtide auftritt.


===Richtung der kleinen Halbachse der Tide-Ellipse===

Bezeichnet die (mathematisch positive) Richtung (-180.0 bis 180.0 Grad) der kleinen Halbachse einer Partialtide.
Beschreibt die Richtung, in welcher die minimale Strömungsgeschwindigkeit der Partialtide auftritt.


===Exzentrizität der Tide-Ellipse===

Exzentrizität, also das Verhältnis von kleiner Halbachse zu großer Halbachse einer Partialtide. Sonderfälle:
* 0.0 : geradlinige Strömung, z. B. durch topografische Führung;
* 1.0 : kreisförmige Strömung mit mathematisch positivem Umlaufsinn (entgegen dem Uhrzeiger);
* -1.0 : kreisförmige Strömung mit mathematisch negativem Umlaufsinn (mit dem Uhrzeiger).


----
zurück zu [[Analyse der Berechnungsergebnisse]]
----
[[Strukturübersicht]]

Datei:Tidal current ellipse definition.png

2019-12-16T14:33:42Z

Ak3spohr: Tidal current Ellipse definition

== Beschreibung ==
Tidal current Ellipse definition

Harmonische Analyse der Strömung

2019-12-16T14:05:06Z

Ak3spohr: in Link zu Zihang.pdf Datei durch Medium ersetzt

[[en:Harmonic Analysis of Current Velocity]]
[[Kategorie:Partialtiden]]

=Motivation=

Die Strömung kann für jeden Ort in einem Ästuar in einen durch die Gezeiten bedingten (periodischen) Anteil und den Rest (aperiodischer Rest) zerlegt werden.
Der periodische Anteil wird dabei von den Partialtiden, also den astronomischen Tiden und den Flachwassertiden dominiert.

[[Datei:Tidal_current_ellipse_definition.gif|250px|thumb|right|Definition Tide-Ellipse]]
Für jede Partialtide ergibt sich eine Tide-Ellipse, welcher von der Spitze des Strömungsvektors einmal in jeder Periode (der Partialtide) durchlaufen wird
(siehe nebenstehendes Bild). Charakteristische Parameter sind der Wert der großen sowie der kleinen Halbachse der Tide-Ellipse,
deren Neigunggswinkel gegen z. B. Ost, sowie deren Exzentrizität.
Je nach Exzentrizität degeneriert die Ellipse entweder zu einem Kreis (Exzentrizität +1.0 oder -1.0) oder einer Geraden (Exzentrizität 0.0).
Mit diesen Parametern der Partialtiden können die tidebedingten Anteile an der lokalen Strömungsgeschwindigkeit quantifiziert werden.
Der aperiodische Rest ergibt sich überwiegend aus den Einflüssen von Abfluss, Meteorologie sowie lokalen topografischen Besonderheiten.

=Grundlagen=

Grundlegende Informationen zu dem Thema ''Harmonische Analyse'' werden in [[Harmonische Analyse des Wasserstands]] dargelegt.
Die bei der Berechnung der Parameter von Tide-Ellipsen in dem Programm [[NCANALYSE]] eingesetzten Methoden werden in
[[Medium:zhigang_xu_2000_ellipse_parameters_conversion.pdf|zhigang_xu_2000_ellipse_parameters_conversion.pdf]]
ausführlich beschrieben.

Der Ablauf der Berechnung ist wie folgt (die in Klammern angegebenen Bezeichnungen beziehen sich auf die Gleichungsnummern in Zhigang Xu (2000)):
# Berechne Amplitude und Phase für die u-Komponente (x- oder Ost-Komponente) der Strömung (Gl. 1).
# Berechne Amplitude und Phase für die v-Komponente (y- oder Nord-Komponente) der Strömung (Gl 2).
# Ermittle die äquivalenten komplexen Formulierungen für u und v (Gl. 9 und Gl. 10).
# Leite daraus die entsprechenden, ebenfalls komplexen Formulierungen für die (mathematisch) positiv sowie negativ rotierenden kreisförmigen Komponenten ab (Gl. 7 und Gl. 8). Aus deren Überlagerung folgt die Tide-Ellipse.
# Berechne aus den zuletzt genannten (komplexen) Formulierungen jeweils Betrag und Phase der positiv und negativ rotierenden Komponente.
# Damit können große und kleine Halbachse (Gl. 14 und Gl. 19), deren Orientierung (Gl. 15 und Gl. 20) sowie die Exzentrizität (Gl. 21) berechnet werden.
Die vorstehenden Berechnungen müssen für jede Partialtide durchgeführt werden.

=Definition der Kennwerte=

Für die Analyse wird die Least Square Fit Methode (LSQF) verwendet.
In dem Programm [[NCANALYSE]] wird hierfür u. a. auf Methoden des Softwarepaketes LAPACK zurückgegriffen.

Alle Größen werden ausschließlich für dauerhaft überflutete Gebiete berechnet.

Für jede Partialtide werden die nachfolgend aufgezählten Größen ermittelt.

==Residuelle Strömungsgeschwindigkeit==

Residuelle Strömungsgeschwindigkeit (aus Partialtidenanalyse) innerhalb des Analysezeitraums.
Diese Größe beschreibt den nicht durch Partialtiden erklärbaren Anteil an der Strömungsgeschwindigkeit.
Dieser aperiodische Rest hängt einerseits von Abfluss, Meteorologie und lokalen topografischen Besonderheiten ab, ist
zusätzlich aber auch von der Anzahl der in der Analyse benutzten Partialtiden abhängig.


==Amplitude und Phase der Partialtiden==

Die nachfolgenden Größen bilden die Basis zur späteren Berechnung verschiedener Parameter von Tide-Ellipsen.
Zusätzlich werden für alle vier Größen auch Standard-Fehler berechnet, die aber hier nicht mit aufgeführt werden.
Diese Größen sind i.d.R. für eine Visualisierung ungeeignet.

===Amplitude der u-Komponente===

Amplitude der u-Komponente (x- oder Ost-Komponente) einer Partialtide.


===Amplitude der v-Komponente===

Amplitude der v-Komponente (y- oder Nord-Komponente) einer Partialtide.


===Phase der u-Komponente===

Phase (in Grad) der u-Komponente (x- oder Ost-Komponente) einer Partialtide.


===Phase der v-Komponente===

Phase (in Grad) der v-Komponente (y- oder Nord-Komponente) einer Partialtide.


==Parameter von Tide-Ellipsen==

Aus den zuvor aufgeführten vier Größen (Amplituden, Phasen) können alle nachfolgenden Parameter für Tide-Ellipsen, wie eingangs skizziert, berechnet werden.

===Große Halbachse der Tide-Ellipse===

Große Halbachse einer Partialtide. Bezeichnet die maximale Strömungsgeschwindigkeit (der Partialtide) innerhalb einer Periode der Partialtide.


===Kleine Halbachse der Tide-Ellipse===

Kleine Halbachse einer Partialtide. Bezeichnet die minimale Strömungsgeschwindigkeit (der Partialtide) innerhalb einer Periode der Partialtide.


===Richtung der großen Halbachse der Tide-Ellipse===

Bezeichnet die (mathematisch positive) Richtung (-180.0 bis 180.0 Grad) der großen Halbachse einer Partialtide.
Beschreibt die Richtung, in welcher die maximale Strömungsgeschwindigkeit der Partialtide auftritt.


===Richtung der kleinen Halbachse der Tide-Ellipse===

Bezeichnet die (mathematisch positive) Richtung (-180.0 bis 180.0 Grad) der kleinen Halbachse einer Partialtide.
Beschreibt die Richtung, in welcher die minimale Strömungsgeschwindigkeit der Partialtide auftritt.


===Exzentrizität der Tide-Ellipse===

Exzentrizität, also das Verhältnis von kleiner Halbachse zu großer Halbachse einer Partialtide. Sonderfälle:
* 0.0 : geradlinige Strömung, z. B. durch topografische Führung;
* 1.0 : kreisförmige Strömung mit mathematisch positivem Umlaufsinn (entgegen dem Uhrzeiger);
* -1.0 : kreisförmige Strömung mit mathematisch negativem Umlaufsinn (mit dem Uhrzeiger).


----
zurück zu [[Analyse der Berechnungsergebnisse]]
----
[[Strukturübersicht]]