BAWiki - Benutzerbeiträge [de]

NCDVAR

2026-05-11T13:22:36Z

Ak3spohr: neue version April 2026: Modify_Classification

{{Programmkennblatt
|name_en=NCDVAR
|name=NCDVAR
|version=April 2026
|version_beschr=Mai 2026
|stichworte=Postprozessor 
Selektives Löschen oder Kopieren von Variablen in einer [[CF-NETCDF.NC | netcdf.nc]] Datei 
Löschen/Kopieren von Koordiniatenvariablen eines bestimmten Typs (X-Y oder LON-LAT) 
Löschen/Kopieren von zu einem Gitter (''Mesh'') gehörenden Variablen 
Löschen/Kopieren einzelner Variablen 
Löschen/Kopieren von Terminen synoptischer, in Zeitrichtung äquidistanter Datensätze 
Löschen/Kopieren ausgewählter Klassen einer Label-Dimension 
Bilden von Summen-Klassen für Label-Dimension 
Automatisches Setzen der WRITE Chunk-Größe 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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=
The program enables the selective deletion / copying of variables in a [[CF-NETCDF.NC | netcdf.nc]] input file into an equivalent output file.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCDVAR.DAT|ncdvar.dat]]);
# '''Input-Daten''', auszudünnender Datensatz (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''Output-Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncdvar.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncdvar.trc)

|methode=
Das Programm untergliedert sich im Wesentlichen in folgende Abschnitte:
# Lesen, Prüfen und Druckerausgabe der Steuerdaten des Anwenders;
# Metadaten der Input-Daten lesen;
# Metadaten in programminterne Datenobjekte transferieren;
# Klassifikation aller Variablen der Input-Datei;
# Abgleich der vom Anwender vorgegebenen Eingangsdaten mit den zur in der Input-Datei zur Verfügung stehenden Daten;
# Markieren aller primären, vom Anwender prinzipiell auswählbaren Variablen mit '''COPY''' oder '''DELETE''';
# Ableiten der Transfermethode (COPY, DELETE) für die von den Primärvariablen benutzen Variablen (Koordinatenvariable, Hilfsvariable, etc.);
# Kopieren der zu transferierenden Variablen aus der Input- in die Output-Datei.

|preprozessor=[[DATACONVERT]], [[BOE2NC]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCRCATMAT]], [[NetCDF Operators]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[NCAUTO]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCPLOT]], [[NCPOLO]], [[NC2TABLE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|programmiersprache=Fortran95
|zus_software= keine
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncdvar/'''
}}

NCDVAR.DAT

2026-05-11T13:17:58Z

Ak3spohr: neue Version April 2026: Modify_Classification

{{Dateikennblatt
|name_en=NCDVAR.DAT
|dateityp=ncdvar.dat
|version=April 2026
|version_beschr=Mai 2026
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000.
*# (optional) '''Create_Missing_Variables''': Erzeugen zusätzlicher Variablen
*#* 0 = keine zusätzlichen Variablen erzeugen (Default)
*#* 1 = zusätzliche Variablen erzeugen (in Kombination mit DFlow FM)
*# (optional) '''NC_Deflate_Level''': Kompression der Ergebnisdaten
*#* 0 = keine Kompression
*#* 1 ... 8 = Kompression (Default = 3)
*#* 9 = maximale Kompression
*# (optional) '''END_After_Define''': Abbruch nach Erzeugen der Metadaten der Output-Datei
*#* .false. = Programm läuft bis zum Ende durch (Default)
*#* .true. = Programm endet nach Definition der Ergebnisdatei (Metadaten)
*# (optional) '''Delete_Coordinate_Variables''': Löschen von Koordinatenvariablen bestimmten Typs
*#* X-Y = alle x- und y-Koordinatenvariablen (projizierte Koordinaten) werden nicht transferiert
*#* LON-LAT = alle lon- und lat-Koordinaten (geografische Koordinaten) werden nicht transferiert
*#* Wir dieser Key nicht angegeben, so werden alle Koordinatenvariablen transferiert
* Block '''Input_File''': Input-Datei
*# '''Data_File''' Name und Typ der Input-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei muss vorhanden sein
* Block '''Output_File''': Output-Datei
*# '''Data_File''' Name und Typ der Output-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei darf nicht vorhanden sein
* (optional) Block '''Mesh_Variables_Action''': Aktionen auf allen Variablen eines Gitters (''Mesh'')
*# '''Action''': Name der ''Mesh''-Variable und Aktion ('''COPY''', '''DELETE'''), die auf den Variablen dieses Gitters ausgeführt werden soll.
:::- Nicht alle [[CF-NETCDF.NC|netcdf.nc]]-Dateien verfügen über ''Mesh''-Variablen;
:::- Wird für ''Mesh'' '''ALL''' angegeben, so werden alle Variablen auf die entsprechende Aktion gesetzt;
:::- Zeile darf mehrfach angegeben werden.
* (optional) Block '''Single_Variable_Action''': Aktionen für individuelle Variablen
*# '''Action''': Name der ''Variable'' und Aktion ('''COPY''', '''DELETE'''), die für diese Variable durchgeführt werden soll.
:::- Zeile darf mehrfach angegeben werden;
:::- Übersteuert ggf. die globale ''Action'' in Block '''Mesh_Variables_Action''';
:::- Der Anwender darf nur von ihm ''beeinflussbare'' Variablen aufzählen. Diese werden auch als geophysikalische Variablen bezeichnet. Koordinatenvariablen, Gewichtsvariablen, etc. dürfen vom Anwender ''nicht'' angegeben werden.
* (optional) Block '''Time_Coordinate_Thinning''': Ausdünnen von äquidsitanten Zeit-Koordinaten
*# '''Time_KV_Name''': Name der Zeit-Koordinatenvariable
*# '''Start_Time''': Anfangs-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
*# '''End_Time''': Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
*# '''Time_Step''': Zeitschritt im Format dddddd-hh:mm:ss.nnnnnnnnn
:::- Funktioniert nur für zeitlich äquidistante Eingangsdaten;
:::- Anfangs- und Ende-Zeitpunkt müssen in den Eingangsdaten vorhanden sein;
:::- Zeitschritt muss ein ganzzahliges Vielfaches der Eingangsdaten sein. Das Lesen mit Stride /= 1 ist allerdings in der NetCDF-Library ineffizient umgesetzt und führt deshalb zu langen Programmlaufzeiten.
* (optional) Block '''Modify_Classification''': Umstrukturierung von Variablen entlang Label-Dimension
*# '''Dimension''': Name der Dimension, entlang der die betroffenen Variablen neu strukturiert werden sollen.
*# '''MOD_Class''': Zuordnung alter Klassen zu neuer Klasse
:::- Zu der Dimension muss eine Label-Variable existieren;
:::- Das Bilden von Summen-Klassen ist NUR für bestimmte Variablen erlaubt.

===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncdvar_dico.dat'''''.
# Anwendungsmöglichkeiten:
#* Fall 1: Löschen von Koordinatenvariablen eines bestimmten Typs;
#* Fall 2: Löschen/Kopieren von auf einem bestimmten Gitter vorliegenden Variablen;
#* Fall 3: Löschen/Kopieren ausgewählter Variablen;
#* Fall 4: Löschen/Kopieren ausgewählter Termine in Zeitrichtung äquidsitanten Daten.
#* Fall 5: Löschen/Kopieren ausgewählter Klassen einer Label-Dimension.
#* Fall 6: Bilden von Summen-Klassen für Label-Dimension.

|nutzerprogramme=[[NCDVAR]]
|programmiersprache=Fortran95
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncdvar/*/mod_m_ncdvar_steer.f90
|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]
|beispieldatei=$PROGHOME/examples/ncdvar/ncdvar.dat
}}

TS2NC

2026-03-26T13:22:57Z

Ak3spohr: Arbeitsgruppe PRE in maintenance ergaenzt

{{Programmkennblatt
|name_en=TS2NC
|name=TS2NC
|version=September 2023
|version_beschr=September 2023
|stichworte=Preprozessor 
[[BOEWRT.DAT]] 
[[CF-NETCDF.NC|cf-netcdf.nc]]

|kurzbeschreibung=
[[TS2NC]] (siehe auch [[TS2NC.DAT]]) wird angewendet um eine beliebige Menge von Messdaten vom Typ [[BOEWRT.DAT]] (Stand: 28.08.2023) in eine zusammengefasste oder in einzelne [[CF-NETCDF.NC|cf-netcdf.nc]] zu überführen. Dieses Programm ist der direkte Nachfolger des Programms [[BOE2NC]] und bietet erweiterte Funktionalität im Data-Science Bereich, bessere Performanz und mehr Flexibilität. 
Dem Anwender unterliegt weiterhin die fachliche Prüfung der eingehenden Messdaten für [[TS2NC]]. Es besteht jedoch die Möglichkeit die Daten über ein gleitendes Mittel zu glätten, eine [https://www.mathworks.com/help/matlab/ref/isoutlier.html#bvlllts-method Vielzahl von Ausreißerfiltern] anzuwenden, Interpolation und Extrapolation vorzunehmen, zeitlich zu aggregieren oder den Wertebereich zu setzen.

|Anmerkungen=
# Die Erstellung von dreidimensionalen Datensätzen ist derzeit noch nicht implementiert

|eingabedateien=
# req: Steuerdatei [[TS2NC.DAT]]

|ausgabedateien=
# Datei mit Informationen zum Programmablauf (Dateityp *.sdr)
# Datei mit Warnungen und Fehlern (Dateityp *.err)
# Ausgabeverzeichnis ./nc
## opt. Ordner mit den internen MATLAB-Structure Daten zur Fehleranalyse bzw. Weiterverwendung ./mat/
## opt. Ordner mit einer graphischen Darstellung der Daten (png, fig) ./fig/

|methode=
Das Programm wurde mit MATLAB erstellt und mit PROGHOME Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:

# Lesen der Steuerdatei des Anwenders
# Ergänzen aller nicht-vorbelegten optionalen Argumente
# Import der Eingangsdaten, Bearbeitung und Reorganisation in [https://www.mathworks.com/help/matlab/timetables.html?searchHighlight=timetable&s_tid=srchtitle_support_results_2_timetable Timetables]. Alle Interpolation und Extrapolationen finden hier statt.
## opt. Wiederherstellen der Datenlücken
## opt. Ausreißerfilterung
## opt. Glättung
## opt. Prüfung des Wertebereichs
# Synchronisieren der [https://www.mathworks.com/help/matlab/timetables.html?searchHighlight=timetable&s_tid=srchtitle_support_results_2_timetable Timetables] für alle physikalischen Größen. Falls für eine Station eine physikalische Größe nicht vorhanden ist werden Fill Values gesetzt.
## opt. graphischer Export
## opt. Ausspeichern der reorganisierten Daten als MATLAB Structure
# Nutzen der BAW-Klasse "NCWriter" zum Schreiben der Daten
## opt. Schreiben der Daten je Station
## opt. Schreiben der Daten als eine Datei für alle Stationen
# Programmabschluss

|preprozessor= [[ZEITRIO]]
|postprozessor=[[NCDELTA]], [[NCANALYSE]], [[NCDVAR]], [[NCMERGE]], [[NCPOLO]], [[NCPLOT]], [[NCVIEW2D]], [[NetCDF Operators]]
|programmiersprache=MATLAB r2021b
|zus_software= n/a
|kontakt_original=R. Hagen
|kontakt_pflege=G. Seiß, [mailto:pre.proghome@baw.de Arbeitsgruppe PRE]
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ts2nc/'''
}}

NCPOLO

2026-03-26T13:21:14Z

Ak3spohr: update maintenance

{{Programmkennblatt
|name_en=NCPOLO
|name=NCPOLO
|version=September 2021
|version_beschr=September 2022
|stichworte=Postprozessor 
Differenzen für synoptische Daten 
Locations 
Zeitreihen 
Scatterplots 
Hodograph 
Modellskill 
Statistik 

|kurzbeschreibung=
[[NCPOLO]] (siehe auch [[NCPOLO.DAT]]) hat seinen Anwendungsschwerpunkt in der Modellvalidierung. Durch das Zusammenfassen validierungstypischer Darstellungen, Skillscores und diverser Exportmöglichkeiten in einem Programm wird ein Messung-Modell-Vergleich erstellt. Um den Vergleich von Mess- und Modelldaten anzustellen, müssen alle punktuell vorliegenden Messdaten (als [[CF-NETCDF.NC|cf-netcdf.nc]]) mit [[NCDELTA]] zeitlich und örtlich korreliert werden.

Anmerkungen:
* Zum Preprocessing von [[BOEWRT.DAT]] Messdaten wird empfohlen [[BOE2NC]] zu verwenden.
* Die [[BOEWRT.DAT]] Header müssen alle notwendigen Informationen enthalten (Zeitzone, Koordinatensystem, Koordinaten, ...).
* Die Messdaten sollten geprüft sein. Eine Prüfung des Wertebereichs wird nicht vorgenommen.
* Die Messdaten sollten ein-eindeutig sein, mehrere Messungen je Station sind zwar möglich, jedoch wird nur der erste gültige Index programmintern berücksichtigt.
* Die Modelldaten können als 2D und 3D [[NCDELTA]] Ergebnis vorgegeben werden.
* [[NCDELTA]] '''muss''' mit der Option with_original_data = .true. durchgeführt werden
* Da es möglich ist mehrere Ausgabeformate für diverese Zeiträume (.png, .fig, .eps, .pdf) anzufordern, kann sich sehr schnell eine extrem große Menge an Bildern (>1.000) ergeben.

Ausgaben von [[NCPOLO]]:
* Zeitreihen (komplett & Detailzeiträume)
* Scatterplots (nach Dichte eingefärbt oder einfarbig)
* Hodographen der Strömung (nach Dichte eingefärbt oder einfarbig)
* Boxplot der Fehlerverteilung
* Grafische Statistikverteilung (frei wählbare Parameter)
* Übersicht statistischer Größen (alle Pegel)

<gallery>
S.19.004.sea_surface_height.ts.Bremerhaven.zeitraum.2.png|Beispielhafter Detailplot Wasserstand
S.19.004.sea water salinity.scat.Nordenham.png|Beispielhafter Scatterplot Salzgehalt
Ncpolo_ex1.undefined.hodograph.So07JD0.png|Beispielhafter Hodograph Strömung
boxall.wasserstand.png|Beispielhafte Boxplot-Fehlerverteilung Wasserstand
Fehler.Bar.png|Beispielhafte Statistikverteilung als Balkendiagramm
</gallery>

|eingabedateien=
* '''allgemeine Eingabedaten''' (Dateityp [[NCPOLO.DAT]]);

|ausgabedateien=
* Datei mit '''Informationen zum Programmablauf''' (Dateityp ncpolo.sdr)
* Datei mit '''Fehlern und Warnungen''' (Dateityp ncpolo.err)
* (optional) Zeitreihen (Dateityp PNG, FIG, EPS, FIG)
* (optional) Scatterplot (Dateityp PNG, FIG, EPS, FIG)
* (optional) Hodograph (Dateityp PNG, FIG, EPS, FIG)
* (optional) Boxplotverteilung (Dateityp PNG, FIG, EPS, FIG)
* (optional) Statistikverteilung (Dateityp PNG, FIG, EPS, FIG)
* (optional) Statistikübersicht (Dateityp CSV, MAT, XLSX)

|methode=
Das Programm wurde mit [[MATLAB]] erstellt und mit ProgHome-Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:
# Lesen der Steuerdatei des Anwenders (Dictionary Check)
# Plausibilitätschecks
# Vorbelegen aller optionalen Parameter
# Einpflegen der nutzerdefinierten Parameter
# Datenimport
# Statistikberechnung
# Ausgabe
## Zeitreihenausgabe
## Scatterplotausgabe
## Hodographausgabe
## Fehlerverteilungsausgabe
## Boxplotausgabe
## Statistikausgabe
# Programmabschluss

|preprozessor=[[DATACONVERT]], [[ZEITRIO]], [[BOE2NC]], [[NCCHUNKIE]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNTRIM2007]], [[UNTRIM2]], [[UNK]]
|postprozessor=[[MATLAB]], [[EXCEL]]
|programmiersprache=MATLAB r2019b
|zus_software= keine
|kontakt_original=R. Hagen
|kontakt_pflege=D. Reddy, [mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncpolo/'''
}}

NCVIEW2D

2026-03-26T13:14:48Z

Ak3spohr: update maintenance

{{Programmkennblatt
|name_en=NCVIEW2D
|name=NCVIEW2D
|version=September 2021
|version_beschr=September 2022
|stichworte=Postprozessor 
Zeitreihen 
[[NCVIEW2D.DAT]] 
[[CF-NETCDF.NC|cf-netcdf.nc]]

|kurzbeschreibung=
[[NCVIEW2D]] (siehe auch [[NCVIEW2D.DAT]]) wird angewendet um Daten, die als [[CF-NETCDF.NC|cf-netcdf.nc]] Datei vorliegen, als 1d als Zeitreihe (time_series), als 1d Stationsserie (station_series), als 1d Tiefenprofil (depth_profile) oder als 2d Zeit-Tiefen Diagramm (time_depth_series) darzustellen. Es existieren nachfolgende Elemente, die einen Plot ausmachen:

# Figure Fenster (Zeichenfläche)
# Plotfenster (Tiles)
# x-Achse (Index oder Zeit)
# y-Achsen
# Daten (1D/2D)

Hierbei kann ein '''Figure Fenster''' mehrere '''Plotfenster''' mit jeweils zwei '''y-Achsen''' aufweisen. Es können beliebig viele '''Plotfenster''' erstellt werden. Als Beispiel können im Figure Fenster ein Plotfenster 1, der y-Achse 1 die Mess- und Modelldaten von Wasserstand und dem Plotfenster 1, der y-Achse 2 die Mess und Modelldaten von Strömung vorgegeben werden. Das Ergebnis wäre eine Darstellung mit dem Wasserstand auf der linken und der Strömung auf der rechten y-Achse. Plotfenster werden generell übereinander angeordnet. Falls die Ausgabe der UUID erwünscht wird wird ein zusätzliches Plotfenster unter dem untersten Plot generiert in dem Metainformationen als Textfelder geschrieben werden angezeigt. Alle [[DMQS]] Metadaten werden zudem als Feld in dem Figure Export gespeichert und können so langfristig vorgehalten werden.

<gallery>
Time series.example 1.de.png|time_series
Station_series.example_13.de.png|station_series
Time_depth_series.ex_14.de.png|time_depth_series
</gallery>

|Anmerkungen=
# Die Namen der Variablen aus NetCDF-Variablen können mit ncdump -h ausgelesen werden
# Messdaten können mit [[DATACONVERT]] oder [[BOE2NC]] in NetCDF gewandelt werden
# Nur das letzte Eintrag einer jeweiligen Achse je Plotfenster wird beim Beschriften und bei den Limits der Achsen berücksichtigt.
# This project took advantage of NetCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ Link]).

|eingabedateien=
# req: Steuerdatei [[NCVIEW2D.DAT]]

|ausgabedateien=
# Figure Datei (mit DMQS-Metadaten, dem Styling und den eingegangenen Daten)
# opt: Grafikausgabe (jpg, tif, svg, eps, pdf, png)
# opt: Datenausgabe ([https://de.mathworks.com/help/matlab/timetables.html MATLAB Timetable], Spreadsheet .xlsx, [[BOEWRT.DAT]])
# Datei mit Informationen zum Programmablauf (Dateityp *.sdr)
# Datei mit Warnungen und Fehlern (Dateityp *.err)

|methode=
Das Programm wurde mit MATLAB erstellt und mit PROGHOME Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:

# Einlesen und checken der Steuerdatei
# Plausibilitätstests der Eingabedaten
# Vorbelegen optionaler Attribute, die in [[NCVIEW2D.DAT]] nicht angegeben wurden
# Datenimport mit der BAW_NCIO Schnittstelle
# opt: Datenoperatoren (nur time_series)
# opt: Datensmoothing (nur time_series)
# Erstellen der Figure Umgebung
# Erstellen der Tiles
# Erstellen der optionalen Hilfslinien
# Erstellen der Legende
# Erstellen der UUID Legende
# Erstellen von Figure Titel
# Box und Hilfsgitternetz einarbeiten
# Erstellen der optionalen Textboxen
# DMQS Informationen abfragen und in der Figure abspeichern
# opt: Datenexport durchführen (nur time_series)
# *.fig exportieren
# opt: Weitere Formate exportieren ([https://de.mathworks.com/matlabcentral/fileexchange/23629-export_fig export_fig.m])
# Schließen aller Kanäle, Programmabschluss

|preprozessor=[[UNTRIM]], [[UNTRIM2]], [[UNK]], [[TS2NC]], [[BOE2NC]], [[DATACONVERT]], [[NCDELTA]], [[NCANALYSE]], [[NCCUTOUT]], [[NCANALYSE]], [https://www.deltares.nl/en/software/delft3d-flexible-mesh-suite/ Delft3D-Flexible Mesh]
|postprozessor=[[MATLAB]], EXCEL, TEXTBEARBEITUNG
|programmiersprache=MATLAB r2020b
|zus_software= keine
|kontakt_original=R. Hagen
|kontakt_pflege=D. Reddy, U. Schiller, [mailto:pos.proghome@baw.de Arbeitsgruppe POS]

|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncview2d/'''
}}

NCVIEW2D

2026-03-26T13:12:23Z

Ak3spohr: update maintenance

{{Programmkennblatt
|name_en=NCVIEW2D
|name=NCVIEW2D
|version=September 2021
|version_beschr=September 2022
|stichworte=Postprozessor 
Zeitreihen 
[[NCVIEW2D.DAT]] 
[[CF-NETCDF.NC|cf-netcdf.nc]]

|kurzbeschreibung=
[[NCVIEW2D]] (siehe auch [[NCVIEW2D.DAT]]) wird angewendet um Daten, die als [[CF-NETCDF.NC|cf-netcdf.nc]] Datei vorliegen, als 1d als Zeitreihe (time_series), als 1d Stationsserie (station_series), als 1d Tiefenprofil (depth_profile) oder als 2d Zeit-Tiefen Diagramm (time_depth_series) darzustellen. Es existieren nachfolgende Elemente, die einen Plot ausmachen:

# Figure Fenster (Zeichenfläche)
# Plotfenster (Tiles)
# x-Achse (Index oder Zeit)
# y-Achsen
# Daten (1D/2D)

Hierbei kann ein '''Figure Fenster''' mehrere '''Plotfenster''' mit jeweils zwei '''y-Achsen''' aufweisen. Es können beliebig viele '''Plotfenster''' erstellt werden. Als Beispiel können im Figure Fenster ein Plotfenster 1, der y-Achse 1 die Mess- und Modelldaten von Wasserstand und dem Plotfenster 1, der y-Achse 2 die Mess und Modelldaten von Strömung vorgegeben werden. Das Ergebnis wäre eine Darstellung mit dem Wasserstand auf der linken und der Strömung auf der rechten y-Achse. Plotfenster werden generell übereinander angeordnet. Falls die Ausgabe der UUID erwünscht wird wird ein zusätzliches Plotfenster unter dem untersten Plot generiert in dem Metainformationen als Textfelder geschrieben werden angezeigt. Alle [[DMQS]] Metadaten werden zudem als Feld in dem Figure Export gespeichert und können so langfristig vorgehalten werden.

<gallery>
Time series.example 1.de.png|time_series
Station_series.example_13.de.png|station_series
Time_depth_series.ex_14.de.png|time_depth_series
</gallery>

|Anmerkungen=
# Die Namen der Variablen aus NetCDF-Variablen können mit ncdump -h ausgelesen werden
# Messdaten können mit [[DATACONVERT]] oder [[BOE2NC]] in NetCDF gewandelt werden
# Nur das letzte Eintrag einer jeweiligen Achse je Plotfenster wird beim Beschriften und bei den Limits der Achsen berücksichtigt.
# This project took advantage of NetCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ Link]).

|eingabedateien=
# req: Steuerdatei [[NCVIEW2D.DAT]]

|ausgabedateien=
# Figure Datei (mit DMQS-Metadaten, dem Styling und den eingegangenen Daten)
# opt: Grafikausgabe (jpg, tif, svg, eps, pdf, png)
# opt: Datenausgabe ([https://de.mathworks.com/help/matlab/timetables.html MATLAB Timetable], Spreadsheet .xlsx, [[BOEWRT.DAT]])
# Datei mit Informationen zum Programmablauf (Dateityp *.sdr)
# Datei mit Warnungen und Fehlern (Dateityp *.err)

|methode=
Das Programm wurde mit MATLAB erstellt und mit PROGHOME Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:

# Einlesen und checken der Steuerdatei
# Plausibilitätstests der Eingabedaten
# Vorbelegen optionaler Attribute, die in [[NCVIEW2D.DAT]] nicht angegeben wurden
# Datenimport mit der BAW_NCIO Schnittstelle
# opt: Datenoperatoren (nur time_series)
# opt: Datensmoothing (nur time_series)
# Erstellen der Figure Umgebung
# Erstellen der Tiles
# Erstellen der optionalen Hilfslinien
# Erstellen der Legende
# Erstellen der UUID Legende
# Erstellen von Figure Titel
# Box und Hilfsgitternetz einarbeiten
# Erstellen der optionalen Textboxen
# DMQS Informationen abfragen und in der Figure abspeichern
# opt: Datenexport durchführen (nur time_series)
# *.fig exportieren
# opt: Weitere Formate exportieren ([https://de.mathworks.com/matlabcentral/fileexchange/23629-export_fig export_fig.m])
# Schließen aller Kanäle, Programmabschluss

|preprozessor=[[UNTRIM]], [[UNTRIM2]], [[UNK]], [[TS2NC]], [[BOE2NC]], [[DATACONVERT]], [[NCDELTA]], [[NCANALYSE]], [[NCCUTOUT]], [[NCANALYSE]], [https://www.deltares.nl/en/software/delft3d-flexible-mesh-suite/ Delft3D-Flexible Mesh]
|postprozessor=[[MATLAB]], EXCEL, TEXTBEARBEITUNG
|programmiersprache=MATLAB r2020b
|zus_software= keine
|kontakt_original=R. Hagen
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS] mit D. Reddy und U. Schiller

|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncview2d/'''
}}

NCPOLO

2026-03-26T12:57:08Z

Ak3spohr: update maintenance

{{Programmkennblatt
|name_en=NCPOLO
|name=NCPOLO
|version=September 2021
|version_beschr=September 2022
|stichworte=Postprozessor 
Differenzen für synoptische Daten 
Locations 
Zeitreihen 
Scatterplots 
Hodograph 
Modellskill 
Statistik 

|kurzbeschreibung=
[[NCPOLO]] (siehe auch [[NCPOLO.DAT]]) hat seinen Anwendungsschwerpunkt in der Modellvalidierung. Durch das Zusammenfassen validierungstypischer Darstellungen, Skillscores und diverser Exportmöglichkeiten in einem Programm wird ein Messung-Modell-Vergleich erstellt. Um den Vergleich von Mess- und Modelldaten anzustellen, müssen alle punktuell vorliegenden Messdaten (als [[CF-NETCDF.NC|cf-netcdf.nc]]) mit [[NCDELTA]] zeitlich und örtlich korreliert werden.

Anmerkungen:
* Zum Preprocessing von [[BOEWRT.DAT]] Messdaten wird empfohlen [[BOE2NC]] zu verwenden.
* Die [[BOEWRT.DAT]] Header müssen alle notwendigen Informationen enthalten (Zeitzone, Koordinatensystem, Koordinaten, ...).
* Die Messdaten sollten geprüft sein. Eine Prüfung des Wertebereichs wird nicht vorgenommen.
* Die Messdaten sollten ein-eindeutig sein, mehrere Messungen je Station sind zwar möglich, jedoch wird nur der erste gültige Index programmintern berücksichtigt.
* Die Modelldaten können als 2D und 3D [[NCDELTA]] Ergebnis vorgegeben werden.
* [[NCDELTA]] '''muss''' mit der Option with_original_data = .true. durchgeführt werden
* Da es möglich ist mehrere Ausgabeformate für diverese Zeiträume (.png, .fig, .eps, .pdf) anzufordern, kann sich sehr schnell eine extrem große Menge an Bildern (>1.000) ergeben.

Ausgaben von [[NCPOLO]]:
* Zeitreihen (komplett & Detailzeiträume)
* Scatterplots (nach Dichte eingefärbt oder einfarbig)
* Hodographen der Strömung (nach Dichte eingefärbt oder einfarbig)
* Boxplot der Fehlerverteilung
* Grafische Statistikverteilung (frei wählbare Parameter)
* Übersicht statistischer Größen (alle Pegel)

<gallery>
S.19.004.sea_surface_height.ts.Bremerhaven.zeitraum.2.png|Beispielhafter Detailplot Wasserstand
S.19.004.sea water salinity.scat.Nordenham.png|Beispielhafter Scatterplot Salzgehalt
Ncpolo_ex1.undefined.hodograph.So07JD0.png|Beispielhafter Hodograph Strömung
boxall.wasserstand.png|Beispielhafte Boxplot-Fehlerverteilung Wasserstand
Fehler.Bar.png|Beispielhafte Statistikverteilung als Balkendiagramm
</gallery>

|eingabedateien=
* '''allgemeine Eingabedaten''' (Dateityp [[NCPOLO.DAT]]);

|ausgabedateien=
* Datei mit '''Informationen zum Programmablauf''' (Dateityp ncpolo.sdr)
* Datei mit '''Fehlern und Warnungen''' (Dateityp ncpolo.err)
* (optional) Zeitreihen (Dateityp PNG, FIG, EPS, FIG)
* (optional) Scatterplot (Dateityp PNG, FIG, EPS, FIG)
* (optional) Hodograph (Dateityp PNG, FIG, EPS, FIG)
* (optional) Boxplotverteilung (Dateityp PNG, FIG, EPS, FIG)
* (optional) Statistikverteilung (Dateityp PNG, FIG, EPS, FIG)
* (optional) Statistikübersicht (Dateityp CSV, MAT, XLSX)

|methode=
Das Programm wurde mit [[MATLAB]] erstellt und mit ProgHome-Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:
# Lesen der Steuerdatei des Anwenders (Dictionary Check)
# Plausibilitätschecks
# Vorbelegen aller optionalen Parameter
# Einpflegen der nutzerdefinierten Parameter
# Datenimport
# Statistikberechnung
# Ausgabe
## Zeitreihenausgabe
## Scatterplotausgabe
## Hodographausgabe
## Fehlerverteilungsausgabe
## Boxplotausgabe
## Statistikausgabe
# Programmabschluss

|preprozessor=[[DATACONVERT]], [[ZEITRIO]], [[BOE2NC]], [[NCCHUNKIE]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNTRIM2007]], [[UNTRIM2]], [[UNK]]
|postprozessor=[[MATLAB]], [[EXCEL]]
|programmiersprache=MATLAB r2019b
|zus_software= keine
|kontakt_original=R. Hagen
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS] und D. Reddy
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncpolo/'''
}}

TS2NC

2026-03-26T12:46:43Z

Ak3spohr: Update Programmpflege

{{Programmkennblatt
|name_en=TS2NC
|name=TS2NC
|version=September 2023
|version_beschr=September 2023
|stichworte=Preprozessor 
[[BOEWRT.DAT]] 
[[CF-NETCDF.NC|cf-netcdf.nc]]

|kurzbeschreibung=
[[TS2NC]] (siehe auch [[TS2NC.DAT]]) wird angewendet um eine beliebige Menge von Messdaten vom Typ [[BOEWRT.DAT]] (Stand: 28.08.2023) in eine zusammengefasste oder in einzelne [[CF-NETCDF.NC|cf-netcdf.nc]] zu überführen. Dieses Programm ist der direkte Nachfolger des Programms [[BOE2NC]] und bietet erweiterte Funktionalität im Data-Science Bereich, bessere Performanz und mehr Flexibilität. 
Dem Anwender unterliegt weiterhin die fachliche Prüfung der eingehenden Messdaten für [[TS2NC]]. Es besteht jedoch die Möglichkeit die Daten über ein gleitendes Mittel zu glätten, eine [https://www.mathworks.com/help/matlab/ref/isoutlier.html#bvlllts-method Vielzahl von Ausreißerfiltern] anzuwenden, Interpolation und Extrapolation vorzunehmen, zeitlich zu aggregieren oder den Wertebereich zu setzen.

|Anmerkungen=
# Die Erstellung von dreidimensionalen Datensätzen ist derzeit noch nicht implementiert

|eingabedateien=
# req: Steuerdatei [[TS2NC.DAT]]

|ausgabedateien=
# Datei mit Informationen zum Programmablauf (Dateityp *.sdr)
# Datei mit Warnungen und Fehlern (Dateityp *.err)
# Ausgabeverzeichnis ./nc
## opt. Ordner mit den internen MATLAB-Structure Daten zur Fehleranalyse bzw. Weiterverwendung ./mat/
## opt. Ordner mit einer graphischen Darstellung der Daten (png, fig) ./fig/

|methode=
Das Programm wurde mit MATLAB erstellt und mit PROGHOME Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:

# Lesen der Steuerdatei des Anwenders
# Ergänzen aller nicht-vorbelegten optionalen Argumente
# Import der Eingangsdaten, Bearbeitung und Reorganisation in [https://www.mathworks.com/help/matlab/timetables.html?searchHighlight=timetable&s_tid=srchtitle_support_results_2_timetable Timetables]. Alle Interpolation und Extrapolationen finden hier statt.
## opt. Wiederherstellen der Datenlücken
## opt. Ausreißerfilterung
## opt. Glättung
## opt. Prüfung des Wertebereichs
# Synchronisieren der [https://www.mathworks.com/help/matlab/timetables.html?searchHighlight=timetable&s_tid=srchtitle_support_results_2_timetable Timetables] für alle physikalischen Größen. Falls für eine Station eine physikalische Größe nicht vorhanden ist werden Fill Values gesetzt.
## opt. graphischer Export
## opt. Ausspeichern der reorganisierten Daten als MATLAB Structure
# Nutzen der BAW-Klasse "NCWriter" zum Schreiben der Daten
## opt. Schreiben der Daten je Station
## opt. Schreiben der Daten als eine Datei für alle Stationen
# Programmabschluss

|preprozessor= [[ZEITRIO]]
|postprozessor=[[NCDELTA]], [[NCANALYSE]], [[NCDVAR]], [[NCMERGE]], [[NCPOLO]], [[NCPLOT]], [[NCVIEW2D]], [[NetCDF Operators]]
|programmiersprache=MATLAB r2021b
|zus_software= n/a
|kontakt_original=R. Hagen
|kontakt_pflege=G. Seiß
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ts2nc/'''
}}

NCCHUNKIE

2025-12-03T17:03:31Z

Ak3spohr: Nov statt Dez

{{Programmkennblatt
|name_en=NCCHUNKIE
|name=NCCHUNKIE
|version=November 2025
|version_beschr=September 2022
|stichworte=Datenkonversion 
Postprocessor 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatische Berechnung der Chunk-Größen der Ergebnisvariablen für orthogonalen Datenzugriff 
Parallelisierung (''collective'' IO) mit [http://de.wikipedia.org/wiki/Message_Passing_Interface MPI] 

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 NCCHUNKIE dient dem Chunken von [[CF-NETCDF.NC|cf-netcdf.nc]] Dateien:
# Die Größe der Chunks wird automatisch berechnet, wobei alle Dimensionen gechunkt werden (Kompromiss für orthogonalen Datenzugriff);
# Die erzeugten Chunk-Größen liegen dabei zwischen der ''Disc Block Size'' und der ''Chunk Buffer Size'';
# Die Daten der Ergebnisdatei werden Online komprimiert (niedrige Kompressionsstufe, Level 1);
# Es wird eine Datei im netCDF-4-Format erzeugt (serielle Version NetCDF4 ''Classic Model Format'');
# Die Parameter ''Cache Size'' und ''Cache Nelems'' der netCDF-4 API werden automatisch ermittelt.

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.

|eingabedateien=
# Es wird keine Eingabesteuerdatei benötigt (Parameter in Kommandozeile oder interaktive Eingabe);
# '''UGRID CF NetCDF Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''UGRID CF NetCDF Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# Drucker-Ausgabe (Dateityp NCCHUNKIE.sdr) mit Informationen zum Programmablauf, Zeitaufwand für READ und WRITE, sowie erzielte Transferraten (MB/s);
# Trace-Ausgabe (Dateityp NCCHUNKIE.trc)

|methode=
Es wurde auf die in [https://support.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf https://support.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf] beschriebenen Konzepte zurückgegriffen.

|preprozessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCANALYSE]], [[NCAGGREGATE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NetCDF Operators]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[NCANALYSE]], [[NCAGGREGATE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NC2TABLE]], [[NetCDF Operators]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
**2020-11-02: [https://izw-campus.baw.de/goto.php?target=cat_1832&client_id=iliasclient ''Chunking und NCCHUNKIE''];
** 2019-08-02: [https://izw-campus.baw.de/goto.php?target=cat_1831&client_id=iliasclient ''Anmerkungen zur Chunked I/O mit NetCDF-4 / HDF5''].
* Musterdateien
** Es sind keine Musterdateien vorhanden.
}}

NCCHUNKIE

2025-12-03T13:19:23Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NCCHUNKIE
|name=NCCHUNKIE
|version=Dezember 2025
|version_beschr=September 2022
|stichworte=Datenkonversion 
Postprocessor 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatische Berechnung der Chunk-Größen der Ergebnisvariablen für orthogonalen Datenzugriff 
Parallelisierung (''collective'' IO) mit [http://de.wikipedia.org/wiki/Message_Passing_Interface MPI] 

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 NCCHUNKIE dient dem Chunken von [[CF-NETCDF.NC|cf-netcdf.nc]] Dateien:
# Die Größe der Chunks wird automatisch berechnet, wobei alle Dimensionen gechunkt werden (Kompromiss für orthogonalen Datenzugriff);
# Die erzeugten Chunk-Größen liegen dabei zwischen der ''Disc Block Size'' und der ''Chunk Buffer Size'';
# Die Daten der Ergebnisdatei werden Online komprimiert (niedrige Kompressionsstufe, Level 1);
# Es wird eine Datei im netCDF-4-Format erzeugt (serielle Version NetCDF4 ''Classic Model Format'');
# Die Parameter ''Cache Size'' und ''Cache Nelems'' der netCDF-4 API werden automatisch ermittelt.

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.

|eingabedateien=
# Es wird keine Eingabesteuerdatei benötigt (Parameter in Kommandozeile oder interaktive Eingabe);
# '''UGRID CF NetCDF Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''UGRID CF NetCDF Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# Drucker-Ausgabe (Dateityp NCCHUNKIE.sdr) mit Informationen zum Programmablauf, Zeitaufwand für READ und WRITE, sowie erzielte Transferraten (MB/s);
# Trace-Ausgabe (Dateityp NCCHUNKIE.trc)

|methode=
Es wurde auf die in [https://support.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf https://support.hdfgroup.org/pubs/papers/2008-06_netcdf4_perf_report.pdf] beschriebenen Konzepte zurückgegriffen.

|preprozessor=[[DATACONVERT]], [[GRIDCONVERT]], [[NCANALYSE]], [[NCAGGREGATE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NetCDF Operators]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[NCANALYSE]], [[NCAGGREGATE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NC2TABLE]], [[NetCDF Operators]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
**2020-11-02: [https://izw-campus.baw.de/goto.php?target=cat_1832&client_id=iliasclient ''Chunking und NCCHUNKIE''];
** 2019-08-02: [https://izw-campus.baw.de/goto.php?target=cat_1831&client_id=iliasclient ''Anmerkungen zur Chunked I/O mit NetCDF-4 / HDF5''].
* Musterdateien
** Es sind keine Musterdateien vorhanden.
}}

NCPLOT

2025-09-17T15:34:18Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=September 2025
|version_beschr=September 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]], [[TS2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=G. Lang, S. Spohr
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

NCPLOT.DAT

2025-09-17T15:33:27Z

Ak3spohr: update version

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=September 2025
|version_beschr=Januar 2025
|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)
* (optional) Key '''"Heaven_Hell_Colors" :''' Farbnamen für Himmel und Boden.
* (optional) Key '''"Heaven_Hell_Contour_Style" :''' Farbe und Strichstärke der Grenzlinien zum Wasserkörper.

===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 Ende-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis Ende-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 und ggf Hintergrundfarbe.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird und ggf Hintergrundfarbe.
: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_Draw_Heaven_Hell" :''' Himmel und Bodenflächen bei Vertikalschnitt oder Tiefenzeitreihe visualisieren.
* (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 und ggf Hintergrundfarbe.
* 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.
* (optional) Key '''"Axis_Font_Size" :''' Schriftgröße für 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
:*'''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_Color_Name" :''' Farben des Legendenfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Frame_Style" :''' Aussehen der Legendenfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Legend_Box_Font_Size" :''' Schriftgröße für Legendenfeld.
* (optional) Key '''"MaxCharNumber_LegendEntry" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.
* (optional) Key '''"Legend_Box_Orientation" :''' Anordnung der Legendeneinträge.
* (optional) Key '''"Legend_Box_HIDE_List" :''' Legenden-Einträge dieser Liste werden NICHT gezeigt.
* (optional) Key '''"Legend_Box_SHOW_List" :''' NUR die Legenden-Einträge dieser Liste werden gezeigt.

===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.
:Platzhalter für Textbox, die mit einem DataRow-Block verbunden ist:
:*<ROW_T_DROW>, <ROW_F_DROW> wird durch Kennung des DataRow-Blocks ersetzt.
:*<ROW_T_DSET>, <ROW_F_DSET> wird durch Kennung des mit dem DataRow-Block verknüpften Datasets ersetzt.
:*<ROW_T_DIM1>, <ROW_F_DIM1> wird durch Infotext zu 1. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM2>, <ROW_F_DIM2> wird durch Infotext zu 2. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM?>, <ROW_F_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im DataRow-Block per KEY ''DataRow_Linked_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.
* (optional) Key '''"MaxCharNumber_TextLine" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.

===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)
:*'''eñd''' = 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]]
|dateiform=FORMATTED
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCAGGREGATE.DAT

2025-06-23T15:25:03Z

Ak3spohr: update version

{{Dateikennblatt
|name_en=NCAGGREGATE.DAT
|dateityp=ncaggregate.dat
|version=Juni 2025
|version_beschr=Dezember 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCAGGREGATE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Input_Data_File''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Output_Data_File''': [[NetCDF|CF NetCDF]] Datei mit aggregierten Ergebnisdaten
*# '''Aggregation_File''': Definition der Kontroll-Volumina in Datei des Typs [[IPDS.DAT|ipds.dat]]
*# '''Aggregation_EPSG''': EPSG-Code (siehe [http://www.epsg-registry.org/ http://www.epsg-registry.org/]) der Koordinaten des ''Aggregation_File''
*# (optional) '''NC_Deflate_Level''': ''deflate level'' (0,1,2,...,9) für die Online-Kompression der Daten beim Schreiben. 0 bedeutet keine Kompression, 9 maximale Kompression
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' der [[NetCDF|CF NetCDF]] Methode [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typische Werte für diese Anwendung sind:
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF-Datei mit 64Bit, kein HDF - keine Online-Kompression);
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF-Datei ohne Nutzung der erweiterten HDF-Möglichkeiten - mit Online-Kompression).
*# (optional) '''Max_Time_Steps_Per_Record''': maximale Anzahl der Zeitschritte, die beim Schreiben eines Ergebnisdatensatzes mit einem WRITE ausgegeben werden sollen.
*# (optional) '''Create_Missing_Variables''': zusätzliche (virtuelle) Variable erzeugen
*#: 0 = nicht erzeugen (Default);
*#: 1 = erzeugen (für DFlow FM UGRID CF NetCDF).
*# (optional) '''With_Median''': Median (>=2 Werte) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_05_95''': Perzentile Q05, Q95 (>= 11 Werte) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_01_99''': Perzentile Q01, Q99 (>= 51 Werte) berechnen (.true.) oder nicht berechnen (.false.).
* (optional) Block '''Exclude_Variable_From_NCAGGREGATE''': Liste der auszuschließenden Variablen.
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen werden alle vom Programm ermittelten Variablen ausgewertet.
* (optional) Block '''Include_Only_Variable_for_NCAGGREGATE''': Liste der exklusiv zu bearbeitenden Variablen.
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen keine weiteren vom Programm ermittelten Variablen ausgewertet.
* (optional) Block '''Probability_Distribution_Group''': Klassifikation und Liste der Variablen, für welche Häufigkeitsverteilungen erzeugt werden sollen. Block kann mehrfach angegeben werden.
*# '''Bounds_Name''': Name einer Klassifikation in Datei [[BOUNDS.CFG.DAT|bounds.cfg.dat]].
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Alle Variablen eines Block müssen über dieselbe physikalische Einheit verfügen. Variable darf nicht via '''Exclude_Variable_From_NCAGGREGATE''' oder '''Include_Only_Variable_for_NCAGGREGATE''' ausgeschlossen sein.
===Anmerkungen===
# Benutzte '''Dictionary-Datei''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncaggregate_dico.dat'''''.
# Wird die Ergebnisdatei ohne Online-Kompression erzeugt, so sollte sie nachträglich mit [https://www.unidata.ucar.edu/software/netcdf/docs/netcdf/nccopy.html NCCOPY] manuell komprimiert werden. Beispiel:
nccopy -k 3 -d 5 <infile> <outfile>
|nutzerprogramme=[[NCAGGREGATE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncaggregate/*/mod_m_ncaggregate_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/ncaggregate/ncaggregate.dat
}}

NCAGGREGATE

2025-06-23T15:24:22Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NCAGGREGATE
|name=NCAGGREGATE
|version=Juni 2025
|version_beschr=September 2022
|stichworte=Analyse 
Postprocessor 
synoptische Berechnungsergebnisse 
[[Analyse_der_Berechnungsergebnisse#Tidekennwerte|Tidekennwerte]] 
[[Analyse_der_Berechnungsergebnisse#Tideunabh.C3.A4ngige_Kennwerte|Tideunabhängige Kennwerte]] 
Differenzen synoptischer Berechnungsergebnisse 
Differenzen von Tidekennwerten 
Differenzen von tideunabhängigen Kennwerten 
[[NetCDF|CF NetCDF]] Format für 2D-Daten 
aggregierte Daten für Kontroll-Volumina und Austausch-Flächen 
Verfahren für unstrukturierte orthogonale Gitternetze 
Unterstützung von Simulationsergebnissen mit SubGrid 
Parallelisierung mit [http://openmp.org/wp/ OpenMP] 
Unterstützung von DMQS-Metadaten und -Variablen 
[[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(Teil-) Automatisierte Qualitätssicherung (Wertebereich)]] 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatische Berechnung der Chunk-Größen der Ergebnisvariablen für orthogonalen Datenzugriff 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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 NCAGGREGATE eignet sich für verschiedene Fragestellungen, die im Folgenden aufgezählt sind. Für die verschiedenen Anwendungsfälle werden jeweils die nützlichen Programme und die Reihenfolger ihrer Anwendung aufgeführt:
* Aggregation synoptischer Transport-Daten für Kontroll-Volumina mit dem Ziel eine präzisen Bilanzierung von Transporten (Wasser, Salz, etc.): Hinweis: Um eine für INSPECT_CONTROL_VOLUMES geeignete Eingangsdatei zu erhalten, muss die Simulation mindestens mit Salz oder Temperatur durchgeführt werden. Auch wenn man nur an der Hydrodynamik interessiert ist, muss NCAGGREGATE auch die Salz- oder Temperaturgrößen aggregieren. Die Größe des aggregierten synoptischen Wasservolumens wird sonst nicht berechnet. Diese Größe ist aber bei den in INSPECT_CONTROL_VOLUMES durchgeführten Berechnungen erforderlich.
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# NCAGGREGATE,
*# [[INSPECT_CONTROL_VOLUMES]] (Ergebnisse prüfen),
*# [[NCANALYSE]], und
*# [[DISPLAY_CONTROL_VOLUMES]].
* Aggregation synoptischer Daten (Wasserspiegelauslenkung, Strömungsgeschwindigkeit, Salzgehalt, etc.) mit dem Ziel einer Reduktion der Komplexität der Ergebnisse:
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# NCAGGREGATE, und
*# [[NCPLOT]].
* Aggregation von Kennwerten zur Reduktion der Komplexität:
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# [[NCANALYSE]],
*# [[NCPLOT]] (Kennwerte prüfen),
*# NCAGGREGATE, und
*# [[NCPLOT]].
* Aggregation der Differenz von Kennwerten oder synoptischen Daten zur Reduktion der Komplexität:
*# [[UNTRIM2007]] oder [[UNTRIM2]] (testweise auch für DFlow FM),
*# [[NCANALYSE]] (für Kennwerte),
*# [[NCPLOT]] (Kennwerte prüfen),
*# [[NCDELTA]],
*# [[NCPLOT]] (Differenzen prüfen),
*# NCAGGREGATE, und
*# [[NCPLOT]].
Bei der Aggregation klassischer Daten werden automatisch sogenannte ''Land Binary Masks'' (LBM) ergänzt. LBMs beschreiben die Land-Wasser-Verteilung zum Zeitpunkt der Aggregation auf dem originalen Gitter. LBMs ermöglichen visualisierenden Anwendungen wir [[NCPLOT]] eine optimale Darstellung aggregierter Größen mit sinnvoller Land-Wasser-Verteilung innerhalb jedes Kontrollvolumens.

Optional kann der Anwender gezielt verschiedene Perzentile (0.01, 0.05, 0.50, 0.95 und 0.99) oder Häufigkeitsverteilungen unter Verwendung frei wählbarer Klassen zusätzlich zu den ''üblichen'' aggregierten Daten erzeugen lassen. Man beachte hierzu die Hinweise bei Datei [[NCAGGREGATE.DAT|ncaggregate.dat]].

[[Datei:ncaggregate_patch.png|thumb|'''Bild ''Kontrollvolumina und Exchanges'''.]]

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCAGGREGATE.DAT|ncaggregate.dat]]);
# Datei mit '''Klassifikationen''' von Häufigkeitsverteilungen ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# '''synoptische Datensätze''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# '''Kontroll-Volumina''' (Dateityp [[IPDS.DAT|ipds.dat]]):
# für eine [[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(teil-) automatisierte Qualitätssicherung]] (Dateityp [[BOUNDS.CFG.DAT|bounds_verify.dat]]).

|ausgabedateien=
# '''Aggregierte Daten''' Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]); zur Struktur des Aggregations-Gitters und dessen Zusammenhang mit dem Berechnungsgitter siehe unter ''[[NetCDF Aggregation f%C3%BCr unstrukturierte Gitter]]''.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncaggregate.sdr);
# (optional) Datei mit '''Testausgaben''' (Dateityp ncaggregate.trc).
|methode=
Geeignete physikalische Daten werden für Kontroll-Volumina sowie Austauschflächen (''Exchanges'') aggregiert.

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=[[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNTRIM2007]], [[UNTRIM2]], [[INSEL2IPDS]]
|postprozessor=[[DAVIT]], [[INSPECT_CONTROL_VOLUMES]], [[NCANALYSE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NCPLOT]], [[NC2TABLE]], [[PLOTPROFILZEIT]],[[PLOTTS]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Vorträge:
** 2014-03-12: [http://ewisa.baw.de/files/09206_tv12_2014_03_12_aggregation_g_lang.pdf ''Aggregation von Daten''].
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
**2020-12-07: [https://izw-campus.baw.de/goto.php?target=cat_1830&client_id=iliasclient ''Aggregation und NCAGGREGATE''].
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncaggregate/'''
}}

NCANALYSE.DAT

2025-04-11T15:24:14Z

Ak3spohr: Hinweis: opt. PAR Variantenverzeichnis Konfigurationsdatei

{{Dateikennblatt
|name_en=NCANALYSE.DAT
|dateityp=ncanalyse.dat
|version=März 2025
|version_beschr=März 2025
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCANALYSE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Analysezyklus gelesen, gespeichert und verarbeitet werden können.
*# '''Min_Water_Depth''': minimale Wasserbedeckung bis zu der Analysen durchgeführt werden.
*# (optional) '''Create_Missing_Variables''': zusätzliche (virtuelle) Variable erzeugen
*#: 0 = nicht erzeugen (Default);
*#: 1 = erzeugen (derzeit nur "magnitude_of_sea_water_velocity" für DFlow FM UGRID CF NetCDF).
*# (optional) '''NC_Deflate_Level''': Niveau (0 bis 9) der Online-Kompression beim Schreiben der Ergebnisdatei
*#: 0 = keine Kompression (Default);
*#: 5 = gute Kompression (Empfehlung);
*#: 9 = höchste Stufe der Kompression.
*# (optional) '''FRQ_use_j_v_correction''': Korrektur der Nodaltide bei der Berechnung der Partialtiden
*#: .true. = Einfluss der Nodaltide korrigieren (Default)
*#: .false. = Einfluss der Nodaltide ''nicht'' korrigieren
*# (optional) '''END_after_hrp''': Beende den Programmlauf unmittelbar im Anschluss an die Analyse für die Referenzpositionen, vor dem Beginn der (eigentlichen) flächenhaften Analyse
*#: .true. = Programmlauf vorzeitig beenden
*#: .false. = Programmlauf vollständig durchführen (Default)
*# (optional) '''CU_Zero_Slack''': Grenzwert für Strömungsgeschwindigkeit in [m s-1] unterhalb der ein Richtungswechsel der Strömung (Kenterung) nicht ausgewertet wird. Typischer Weise werden Werte von 1 cm s-1 verwendet (diese sind in den Konfigurationsdateien für die verschiedenen Analysen voreingestellt). Als Kenterung wird eine Situation erkannt, falls die Geschwindigkeit größer als der Grenzwert ist und ein Richtungswechsel stattgefunden hat.
*# (optional) '''Compute_FE_Ratio''': Berechne Flut(strom):Ebbe(strom) Kenngrößen, falls solche mit <OPT:COMPUTE_FE_RATIO> in der Konfigurationsdatei markiert sind
*#: .true. = F:E-Kenngrößen berechnen
*#: .false. = F:E-Kenngrößen nicht berechnen (Default)
*# (optional) '''CFG_Level''': Einige Konfigurationsdateien enthalten Anweisungen der Art <OPT:CFG_Level_''number''> zur flexiblen Verwendung derselben Konfigurationsdatei für verschiedene Fragestellungen.
*#: 0 = aktiviere Zeilen mit <OPT:CFG_Level_0> (Default)
*#: 1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
*# (optional) '''Location_XY_EPSG''': EPSG-Code der in den Blöcken '''Location''' angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block '''Input_Files''') verwendet.
*# (optional) '''Gap_Fill''': Steuerparameter für das Auffüllen von Datenlücken an Referenzpositionen durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
*#: 0 = Datenlücken werden nicht aufgefüllt (Default)
*#: 1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
* Block '''Data_Analysis_Period''': Analysezeitraum
*# '''Start_Time''': Beginn des Analysezeitraums.
*# '''End_Time''': Ende des Analysezeitraums.
* Block '''Input_Files''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Data_File''': Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]). Optional kann als dritter Parameter auch noch angegeben werden, ob die Datei mit MPI COLLECTIVE I/O oder MPI INDEPENDENT I/O gelesen werden soll (relevant nur für die MPI-Version des Programms).
* Block '''Location''': Referenzpositionen (je Position ein Block).
*# '''Name''': Name der Referenzposition.
*# '''Type''': Typ der Referenzposition:
*#* 0 = Referenzposition Tide (muss einmal angegeben werden);
*#* 1 = Referenzposition Phase (muss einmal angegeben werden);
*#* 2 = Hilfsposition (kann angegeben werden).
*# '''X''': x-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Y''': y-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LON''': geografische Länge der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LAT''': geografische Breite der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Z''': z-Koordinate der Position (nach Unten positiv).
*# '''Rank''': ''Rang'' der Position (nicht für ''Referenzposition Phase'').
*# '''Previous_Rank''': Verweis auf den ''Rang'' der vorangehenden Position (nicht für ''Referenzposition Tide'' und ''Referenzposition Phase'').
* Block '''Input_Variables''': Name(n) der zu analysierenden Variablen.
*# '''Name''': Name der zu analysierenden Variable (ist ein gültiger [[NetCDF|CF NetCDF]] Variablenname der Datei mit den Eingangsdaten).
* Block '''Data_Analysis''': Art der Analyse sowie [[NetCDF|CF NetCDF]] Datei für Analyseergebnisse
*# '''Type''': Typ der durchzuführenden Analyse (und optional Variantenverzeichnis Konfigurationsdatei):
*#* '''TDKW''' = [[Tidekennwerte des Wasserstandes]];
*#* '''TDKV''' = [[Tidekennwerte der Strömung]];
*#* '''TDXF''' = [[Tidekennwerte des Wassertransports]];
*#* '''TDKS''', '''TDWS'''= [[Tidekennwerte des Salzgehalts]];
*#* '''TDXS''' = [[Tidekennwerte des Salztransports]];
*#* '''TDKT''' = [[Tidekennwerte der Temperatur]];
*#* '''TDXT''' = [[Tidekennwerte des Wärmetransports]];
*#* '''TDKC''' = [[Tidekennwerte des Schwebstoffgehalts]];
*#* '''TDXC''' = [[Tidekennwerte des Schwebstofftransports]];
*#* '''TDKP''' = [[Tidekennwerte des Tracergehalts]];
*#* '''TDXP''' = [[Tidekennwerte des Tracertransports]];
*#* '''TDKB''' = [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*#* '''TDKG''' = [[Tidekennwerte des Geschiebetransports]];
*#* '''TDKA''' = [[Tidekennwerte der Anomalie der Potentiellen Energie]];
*#* '''FRQW''' = [[Harmonische Analyse des Wasserstands|Harmonische Analyse des Wasserstands (Partialtiden)]];
*#* '''FRQV''' = [[Harmonische Analyse der Strömung|Harmonische Analyse der Strömung (Partialtiden)]];
*#* '''LZKW''' = [[Tideunabhängige Kennwerte des Wasserstands]];
*#* '''LZKV''' = [[Tideunabhängige Kennwerte der Strömung]];
*#* '''LZKS''' = [[Tideunabhängige Kennwerte des Salzgehalts]];
*#* '''LZKT''' = [[Tideunabhängige Kennwerte der Temperatur]];
*#* '''LZKC''' = [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
*#* '''LZKP''' = [[Tideunabhängige Kennwerte des Tracergehalts]];
*#* '''LZKO''' = [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
*#* '''LZKM''' = [[Tideunabhängige Kennwerte der Morphodynamik]];
*#* '''LZKG''' = [[Tideunabhängige Kennwerte des Geschiebetransports]];
*#* '''LZKB''' = [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*#* '''LZKA''' = [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
*#* '''LZXF''' = [[Tideunabhängige Kennwerte des Wassertransports]];
*#* '''LZXS''' = [[Tideunabhängige Kennwerte des Salztransports]];
*#* '''LZXP''' = [[Tideunabhängige Kennwerte des Tracertransports]];
*#* '''LZXC''' = [[Tideunabhängige Kennwerte des Schwebstofftransports]];
*#* '''LZXG''' = [[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle);
*#* '''LZXE''' = [[Tideunabhängige Kennwerte des Tide-Energietransports]];
*#* '''LZMW''' = [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
*#* '''LZSS''' = [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
*# '''Result_File''': Name und Typ (NETCDF) der Datei für die Analyseergebnisse (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).
* '''Optionale Blöcke''' für verschiedene Analysen
** Optional für '''TDKW''':
*** Block '''TDKW_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKV''':
*** Block '''TDKV_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKS''' oder '''TDWS'''
*** Block '''TDKS_Quantiles''' oder '''TDWS_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKT''':
*** Block '''TDKT_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKC''':
*** Block '''TDKC_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKP''':
*** Block '''TDKP_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKG''':
*** Block '''TDKG_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKB''':
*** Block '''TDKB_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKA''':
*** Block '''TDKA_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''FRQW''' und '''FRQV''':
*** Block '''Tidal_Constituents''': Liste der zu berechnenden Partialtiden.
***# '''Value''': Code der Partialtide, z. B. Mm, Mf, K_1, O_1, S_2, M_2, M_4, M_6, M_8.
* '''Optional erforderliche Blöcke''' für verschiedene Analysen
*: Um die ''Bounds'', also die jeweiligen Intervallgrenzen für die Häufigkeitsverteilung optimal angeben zu können, sollte vorab der Wertebereich der physikalischen Größe ermittelt werden, z. B. mit dem Programm [[NCAUTO]].
** Erforderlich für '''LZKW''':
*** Block '''Water_Level_Bounds''': Definition der Wasserstandsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Water_Level_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKV''':
*** Block '''Current_Velocity_Bounds''': Definition der Strömungsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Current_Velocity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKS''':
*** Block '''Salinity_Bounds''': Definition der Salzgehaltsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Salinity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKT''':
*** Block '''Temperature_Bounds''': Definition der Temperaturklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Temperature_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKC''':
*** Block '''Suspended_Sediment_Bounds''': Definition der Klassen für den Schwebstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Suspended_Sediment_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKP''':
*** Block '''Tracer_Bounds''': Definition der Klassen für den Tracergehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Tracer_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKO''':
*** Block '''Oxygen_Bounds''': Definition der Klassen für den Sauerstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Oxygen_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKM''':
*** Block '''Bathymetry_Bounds''': Definition der Sohltiefenklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bathymetry_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKG''':
*** Block '''Bedload_Bounds''': Definition der Geschiebetransport-Klassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedload_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKB''':
*** Block '''Bedfriction_Bounds''': Definition der Klassen für die eff. Bodenschubspannung.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedfriction_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKA''':
*** Block '''PE_Anomaly_Bounds''': Definition der Klassen für die PEA.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''PE_Anomaly_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZMW''':
*** Block '''Wind_Bounds''': Definition der Klassen für die Windgeschwindigkeit.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Wind_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZSS''':
*** Block '''Sig_Wave_Bounds''': Definition der Klassen für die signifikante Wellenhöhe.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Sig_Wave_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncanalyse_dico.dat''''' und
#* '''''ncanalyse_config_dico.dat'''''.
# Benutzte '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''':
#* '''TDKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wasserstandes]];
#* '''TDKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Strömung]];
#* '''TDXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wassertransports]];
#* '''TDKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salzgehalts]];
#* '''TDXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salztransports]];
#* '''TDKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Temperatur]];
#* '''TDXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wärmetransports]];
#* '''TDKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstoffgehalts]];
#* '''TDXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstofftransports]];
#* '''TDKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracergehalts]];
#* '''TDXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracertransports]];
#* '''TDKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
#* '''TDKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Geschiebetransports]];
#* '''TDKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Anomalie der Potentiellen Energie]];
#* '''FRQW_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse des Wasserstands|Partialtiden des Wasserstands]];
#* '''FRQV_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse der Strömung|Partialtiden der Strömung]];
#* '''LZKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wasserstands]];
#* '''LZKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Strömung]];
#* '''LZKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salzgehalts]];
#* '''LZKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Temperatur]];
#* '''LZKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
#* '''LZKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracergehalts]];
#* '''LZKO_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
#* '''LZKM_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Morphodynamik]];
#* '''LZKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Geschiebetransports]];
#* '''LZKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
#* '''LZKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
#* '''LZXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wassertransports]];
#* '''LZXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salztransports]];
#* '''LZXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wärmetransports]];
#* '''LZXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracertransports]];
#* '''LZXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstofftransports]];
#* '''LZXG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sedimenttransports]];
#* '''LZXE_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tide-Energietransports]];
#* '''LZMW_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
#* '''LZSS_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
|nutzerprogramme=[[NCANALYSE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncanalyse/*/mod_m_ncanalyse_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/ncanalyse/ncanalyse.dat
}}

NCANALYSE.DAT

2025-04-11T15:13:54Z

Ak3spohr:

{{Dateikennblatt
|name_en=NCANALYSE.DAT
|dateityp=ncanalyse.dat
|version=März 2025
|version_beschr=Oktober 2021
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCANALYSE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Analysezyklus gelesen, gespeichert und verarbeitet werden können.
*# '''Min_Water_Depth''': minimale Wasserbedeckung bis zu der Analysen durchgeführt werden.
*# (optional) '''Create_Missing_Variables''': zusätzliche (virtuelle) Variable erzeugen
*#: 0 = nicht erzeugen (Default);
*#: 1 = erzeugen (derzeit nur "magnitude_of_sea_water_velocity" für DFlow FM UGRID CF NetCDF).
*# (optional) '''NC_Deflate_Level''': Niveau (0 bis 9) der Online-Kompression beim Schreiben der Ergebnisdatei
*#: 0 = keine Kompression (Default);
*#: 5 = gute Kompression (Empfehlung);
*#: 9 = höchste Stufe der Kompression.
*# (optional) '''FRQ_use_j_v_correction''': Korrektur der Nodaltide bei der Berechnung der Partialtiden
*#: .true. = Einfluss der Nodaltide korrigieren (Default)
*#: .false. = Einfluss der Nodaltide ''nicht'' korrigieren
*# (optional) '''END_after_hrp''': Beende den Programmlauf unmittelbar im Anschluss an die Analyse für die Referenzpositionen, vor dem Beginn der (eigentlichen) flächenhaften Analyse
*#: .true. = Programmlauf vorzeitig beenden
*#: .false. = Programmlauf vollständig durchführen (Default)
*# (optional) '''CU_Zero_Slack''': Grenzwert für Strömungsgeschwindigkeit in [m s-1] unterhalb der ein Richtungswechsel der Strömung (Kenterung) nicht ausgewertet wird. Typischer Weise werden Werte von 1 cm s-1 verwendet (diese sind in den Konfigurationsdateien für die verschiedenen Analysen voreingestellt). Als Kenterung wird eine Situation erkannt, falls die Geschwindigkeit größer als der Grenzwert ist und ein Richtungswechsel stattgefunden hat.
*# (optional) '''Compute_FE_Ratio''': Berechne Flut(strom):Ebbe(strom) Kenngrößen, falls solche mit <OPT:COMPUTE_FE_RATIO> in der Konfigurationsdatei markiert sind
*#: .true. = F:E-Kenngrößen berechnen
*#: .false. = F:E-Kenngrößen nicht berechnen (Default)
*# (optional) '''CFG_Level''': Einige Konfigurationsdateien enthalten Anweisungen der Art <OPT:CFG_Level_''number''> zur flexiblen Verwendung derselben Konfigurationsdatei für verschiedene Fragestellungen.
*#: 0 = aktiviere Zeilen mit <OPT:CFG_Level_0> (Default)
*#: 1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
*# (optional) '''Location_XY_EPSG''': EPSG-Code der in den Blöcken '''Location''' angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block '''Input_Files''') verwendet.
*# (optional) '''Gap_Fill''': Steuerparameter für das Auffüllen von Datenlücken an Referenzpositionen durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
*#: 0 = Datenlücken werden nicht aufgefüllt (Default)
*#: 1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
* Block '''Data_Analysis_Period''': Analysezeitraum
*# '''Start_Time''': Beginn des Analysezeitraums.
*# '''End_Time''': Ende des Analysezeitraums.
* Block '''Input_Files''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Data_File''': Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]). Optional kann als dritter Parameter auch noch angegeben werden, ob die Datei mit MPI COLLECTIVE I/O oder MPI INDEPENDENT I/O gelesen werden soll (relevant nur für die MPI-Version des Programms).
* Block '''Location''': Referenzpositionen (je Position ein Block).
*# '''Name''': Name der Referenzposition.
*# '''Type''': Typ der Referenzposition:
*#* 0 = Referenzposition Tide (muss einmal angegeben werden);
*#* 1 = Referenzposition Phase (muss einmal angegeben werden);
*#* 2 = Hilfsposition (kann angegeben werden).
*# '''X''': x-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Y''': y-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LON''': geografische Länge der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LAT''': geografische Breite der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Z''': z-Koordinate der Position (nach Unten positiv).
*# '''Rank''': ''Rang'' der Position (nicht für ''Referenzposition Phase'').
*# '''Previous_Rank''': Verweis auf den ''Rang'' der vorangehenden Position (nicht für ''Referenzposition Tide'' und ''Referenzposition Phase'').
* Block '''Input_Variables''': Name(n) der zu analysierenden Variablen.
*# '''Name''': Name der zu analysierenden Variable (ist ein gültiger [[NetCDF|CF NetCDF]] Variablenname der Datei mit den Eingangsdaten).
* Block '''Data_Analysis''': Art der Analyse sowie [[NetCDF|CF NetCDF]] Datei für Analyseergebnisse
*# '''Type''': Typ der durchzuführenden Analyse:
*#* '''TDKW''' = [[Tidekennwerte des Wasserstandes]];
*#* '''TDKV''' = [[Tidekennwerte der Strömung]];
*#* '''TDXF''' = [[Tidekennwerte des Wassertransports]];
*#* '''TDKS''', '''TDWS'''= [[Tidekennwerte des Salzgehalts]];
*#* '''TDXS''' = [[Tidekennwerte des Salztransports]];
*#* '''TDKT''' = [[Tidekennwerte der Temperatur]];
*#* '''TDXT''' = [[Tidekennwerte des Wärmetransports]];
*#* '''TDKC''' = [[Tidekennwerte des Schwebstoffgehalts]];
*#* '''TDXC''' = [[Tidekennwerte des Schwebstofftransports]];
*#* '''TDKP''' = [[Tidekennwerte des Tracergehalts]];
*#* '''TDXP''' = [[Tidekennwerte des Tracertransports]];
*#* '''TDKB''' = [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*#* '''TDKG''' = [[Tidekennwerte des Geschiebetransports]];
*#* '''TDKA''' = [[Tidekennwerte der Anomalie der Potentiellen Energie]];
*#* '''FRQW''' = [[Harmonische Analyse des Wasserstands|Harmonische Analyse des Wasserstands (Partialtiden)]];
*#* '''FRQV''' = [[Harmonische Analyse der Strömung|Harmonische Analyse der Strömung (Partialtiden)]];
*#* '''LZKW''' = [[Tideunabhängige Kennwerte des Wasserstands]];
*#* '''LZKV''' = [[Tideunabhängige Kennwerte der Strömung]];
*#* '''LZKS''' = [[Tideunabhängige Kennwerte des Salzgehalts]];
*#* '''LZKT''' = [[Tideunabhängige Kennwerte der Temperatur]];
*#* '''LZKC''' = [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
*#* '''LZKP''' = [[Tideunabhängige Kennwerte des Tracergehalts]];
*#* '''LZKO''' = [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
*#* '''LZKM''' = [[Tideunabhängige Kennwerte der Morphodynamik]];
*#* '''LZKG''' = [[Tideunabhängige Kennwerte des Geschiebetransports]];
*#* '''LZKB''' = [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*#* '''LZKA''' = [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
*#* '''LZXF''' = [[Tideunabhängige Kennwerte des Wassertransports]];
*#* '''LZXS''' = [[Tideunabhängige Kennwerte des Salztransports]];
*#* '''LZXP''' = [[Tideunabhängige Kennwerte des Tracertransports]];
*#* '''LZXC''' = [[Tideunabhängige Kennwerte des Schwebstofftransports]];
*#* '''LZXG''' = [[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle);
*#* '''LZXE''' = [[Tideunabhängige Kennwerte des Tide-Energietransports]];
*#* '''LZMW''' = [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
*#* '''LZSS''' = [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
*# '''Result_File''': Name und Typ (NETCDF) der Datei für die Analyseergebnisse (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).
* '''Optionale Blöcke''' für verschiedene Analysen
** Optional für '''TDKW''':
*** Block '''TDKW_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKV''':
*** Block '''TDKV_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKS''' oder '''TDWS'''
*** Block '''TDKS_Quantiles''' oder '''TDWS_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKT''':
*** Block '''TDKT_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKC''':
*** Block '''TDKC_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKP''':
*** Block '''TDKP_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKG''':
*** Block '''TDKG_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKB''':
*** Block '''TDKB_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKA''':
*** Block '''TDKA_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''FRQW''' und '''FRQV''':
*** Block '''Tidal_Constituents''': Liste der zu berechnenden Partialtiden.
***# '''Value''': Code der Partialtide, z. B. Mm, Mf, K_1, O_1, S_2, M_2, M_4, M_6, M_8.
* '''Optional erforderliche Blöcke''' für verschiedene Analysen
*: Um die ''Bounds'', also die jeweiligen Intervallgrenzen für die Häufigkeitsverteilung optimal angeben zu können, sollte vorab der Wertebereich der physikalischen Größe ermittelt werden, z. B. mit dem Programm [[NCAUTO]].
** Erforderlich für '''LZKW''':
*** Block '''Water_Level_Bounds''': Definition der Wasserstandsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Water_Level_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKV''':
*** Block '''Current_Velocity_Bounds''': Definition der Strömungsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Current_Velocity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKS''':
*** Block '''Salinity_Bounds''': Definition der Salzgehaltsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Salinity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKT''':
*** Block '''Temperature_Bounds''': Definition der Temperaturklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Temperature_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKC''':
*** Block '''Suspended_Sediment_Bounds''': Definition der Klassen für den Schwebstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Suspended_Sediment_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKP''':
*** Block '''Tracer_Bounds''': Definition der Klassen für den Tracergehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Tracer_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKO''':
*** Block '''Oxygen_Bounds''': Definition der Klassen für den Sauerstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Oxygen_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKM''':
*** Block '''Bathymetry_Bounds''': Definition der Sohltiefenklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bathymetry_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKG''':
*** Block '''Bedload_Bounds''': Definition der Geschiebetransport-Klassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedload_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKB''':
*** Block '''Bedfriction_Bounds''': Definition der Klassen für die eff. Bodenschubspannung.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedfriction_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKA''':
*** Block '''PE_Anomaly_Bounds''': Definition der Klassen für die PEA.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''PE_Anomaly_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZMW''':
*** Block '''Wind_Bounds''': Definition der Klassen für die Windgeschwindigkeit.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Wind_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZSS''':
*** Block '''Sig_Wave_Bounds''': Definition der Klassen für die signifikante Wellenhöhe.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Sig_Wave_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncanalyse_dico.dat''''' und
#* '''''ncanalyse_config_dico.dat'''''.
# Benutzte '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''':
#* '''TDKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wasserstandes]];
#* '''TDKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Strömung]];
#* '''TDXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wassertransports]];
#* '''TDKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salzgehalts]];
#* '''TDXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salztransports]];
#* '''TDKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Temperatur]];
#* '''TDXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wärmetransports]];
#* '''TDKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstoffgehalts]];
#* '''TDXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstofftransports]];
#* '''TDKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracergehalts]];
#* '''TDXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracertransports]];
#* '''TDKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
#* '''TDKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Geschiebetransports]];
#* '''TDKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Anomalie der Potentiellen Energie]];
#* '''FRQW_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse des Wasserstands|Partialtiden des Wasserstands]];
#* '''FRQV_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse der Strömung|Partialtiden der Strömung]];
#* '''LZKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wasserstands]];
#* '''LZKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Strömung]];
#* '''LZKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salzgehalts]];
#* '''LZKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Temperatur]];
#* '''LZKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
#* '''LZKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracergehalts]];
#* '''LZKO_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
#* '''LZKM_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Morphodynamik]];
#* '''LZKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Geschiebetransports]];
#* '''LZKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
#* '''LZKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
#* '''LZXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wassertransports]];
#* '''LZXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salztransports]];
#* '''LZXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wärmetransports]];
#* '''LZXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracertransports]];
#* '''LZXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstofftransports]];
#* '''LZXG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sedimenttransports]];
#* '''LZXE_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tide-Energietransports]];
#* '''LZMW_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
#* '''LZSS_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
|nutzerprogramme=[[NCANALYSE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncanalyse/*/mod_m_ncanalyse_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/ncanalyse/ncanalyse.dat
}}

NCANALYSE

2025-04-11T14:46:54Z

Ak3spohr:

{{Programmkennblatt
|name_en=NCANALYSE
|name=NCANALYSE
|version=März 2025
|version_beschr=September 2022
|stichworte=Analyse 
Postprocessor 
synoptische Berechnungsergebnisse 
Zeitserien gemessener Daten (optional mit weiter qualifizierenden [http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html#flags Flag Variablen]) 
tiefengemittelte (2D) und tiefenstrukturierte Daten (3D) mit z-Schichten 
[[Tidekennwerte des Wasserstandes]] 
[[Tidekennwerte der Strömung]], [[Tidekennwerte des Wassertransports]] 
[[Tidekennwerte des Salzgehalts]], [[Tidekennwerte des Salztransports]] 
[[Tidekennwerte der Temperatur]], [[Tidekennwerte des Wärmetransports]] 
[[Tidekennwerte des Schwebstoffgehalts]], [[Tidekennwerte des Schwebstofftransports]] 
[[Tidekennwerte des Tracergehalts]], [[Tidekennwerte des Tracertransports]] 
[[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]] 
[[Tidekennwerte des Geschiebetransports]] 
[[Tidekennwerte der Anomalie der Potentiellen Energie]] 
[[Harmonische Analyse des Wasserstands]] 
[[Harmonische Analyse der Strömung]] 
[[Tideunabhängige Kennwerte des Wasserstands]] 
[[Tideunabhängige Kennwerte der Strömung]] 
[[Tideunabhängige Kennwerte des Salzgehalts]] 
[[Tideunabhängige Kennwerte der Temperatur]] 
[[Tideunabhängige Kennwerte des Schwebstoffgehalts]] 
[[Tideunabhängige Kennwerte des Tracergehalts]] 
[[Tideunabhängige Kennwerte des Sauerstoffgehalts]] 
[[Tideunabhängige Kennwerte der Morphodynamik]] 
[[Tideunabhängige Kennwerte des Geschiebetransports]] 
[[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]] 
[[Tideunabhängige Kennwerte des Wassertransports]] 
[[Tideunabhängige Kennwerte des Salztransports]] 
[[Tideunabhängige Kennwerte des Wärmetransports]] 
[[Tideunabhängige Kennwerte des Tracertransports]] 
[[Tideunabhängige Kennwerte des Schwebstofftransports]] 
[[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle) 
[[Tideunabhängige Kennwerte des Tide-Energietransports]] 
[[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]] 
[[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]] 
[[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]] 
[[NetCDF|CF NetCDF]] Format für 2D-/3D-Daten 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Verfahren für Daten an Einzelpositionen (''Discrete Sampling Geometry'' featureType = '''timeSeriesProfile''') 
Verfahren für Daten auf Profilen (''Discrete Sampling Geometry'' featureType = '''trajectoryProfile''') 
Parallelisierung mit [http://openmp.org/wp/ OpenMP] und [http://de.wikipedia.org/wiki/Message_Passing_Interface MPI] 
[[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(Teil-) Automatisierte Qualitätssicherung (Wertebereich)]] 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatisches Setzen der WRITE Chunk-Größe 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Optionales Schließen von Datenlücken an Referenz-Positionen durch Interpolation 

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 NCANALYSE dient zur Analyse von in CF NetCDF Dateien gespeicherten synoptischen Daten.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCANALYSE.DAT|ncanalyse.dat]]);
# '''synoptische Datensätze''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# für eine [[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(teil-) automatisierte Qualitätssicherung]] (Dateityp [[BOUNDS.CFG.DAT|bounds_verify.dat]]).

|ausgabedateien=
# '''Analyseergebnisse''' Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncanalyse.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)
|methode=
Folgende Analysen stehen zur Verfügung:
* Tidekennwerte:
*# [[Tidekennwerte des Wasserstandes]];
*# [[Tidekennwerte der Strömung]];
*# [[Tidekennwerte des Salzgehalts]];
*# [[Tidekennwerte der Temperatur]];
*# [[Tidekennwerte des Schwebstoffgehalts]];
*# [[Tidekennwerte des Tracergehalts]];
*# [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*# [[Tidekennwerte des Geschiebetransports]];
*# [[Tidekennwerte der Anomalie der Potentiellen Energie]].
* Tide-Transport-Kennwerte (basierend auf ''exakten'' Integralen):
*# [[Tidekennwerte des Wassertransports]];
*# [[Tidekennwerte des Salztransports]];
*# [[Tidekennwerte des Wärmetransports]];
*# [[Tidekennwerte des Schwebstofftransports]];
*# [[Tidekennwerte des Tracertransports]].
* Harmonische Analyse:
*# [[Harmonische Analyse des Wasserstands]];
*# [[Harmonische Analyse der Strömung]].
* Tideunabhängige Kennwerte:
*# [[Tideunabhängige Kennwerte des Wasserstands]];
*# [[Tideunabhängige Kennwerte der Strömung]];
*# [[Tideunabhängige Kennwerte des Salzgehalts]];
*# [[Tideunabhängige Kennwerte der Temperatur]];
*# [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
*# [[Tideunabhängige Kennwerte des Tracergehalts]];
*# [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
*# [[Tideunabhängige Kennwerte der Morphodynamik]];
*# [[Tideunabhängige Kennwerte des Geschiebetransports]];
*# [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*# [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]].
* Tideunabhängige Transport-Kennwerte (basierend auf ''exakten'' Integralen):
*# [[Tideunabhängige Kennwerte des Wassertransports]];
*# [[Tideunabhängige Kennwerte des Salztransports]];
*# [[Tideunabhängige Kennwerte des Wärmetransports]];
*# [[Tideunabhängige Kennwerte des Tracertransports]];
*# [[Tideunabhängige Kennwerte des Schwebstofftransports]];
*# [[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle).
* Tide-Energietransport:
*# [[Tideunabhängige Kennwerte des Tide-Energietransports]].
* Kennwerte meteorologischer Größen:
*# [[Kennwerte meteorologischer Größen|Windgeschwindigkeit]]. 
* Kennwerte des Seegangs:
*# [[Kennwerte des Seegangs|signifikante Wellenhöhe]]. 

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]], [[BOE2NC]], [[TS2NC]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDVAR]], [[NCMERGE]], [[NetCDF Operators]], [[QUICKPLOT]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[DISPLAY_CONTROL_VOLUMES]], [[GEOTIFFRASTERTOOL]], [[NCAGGREGATE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCPLOT]], [[NC2TABLE]], [[NETCDFRASTERTOOL]], [[PLOTPROFILZEIT]],[[PLOTTS]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Vorträge
** 2021-06-16: [http://doi.org/10.13140/RG.2.2.20390.45120 ''Tidal Asymmetry - Classical Parameters vs Skewness''] (DOI: [http://doi.org/10.13140/RG.2.2.20390.45120 http://doi.org/10.13140/RG.2.2.20390.45120]);
** 2015-05-29: [http://ewisa.baw.de/files/12556_tv12_2015_05_29_tide_energie_transport_g_lang.pdf ''Tidewelle und Energietransport''] (DOI: [http://dx.doi.org/10.13140/RG.2.2.31352.14089 http://dx.doi.org/10.13140/RG.2.2.31352.14089]).
** 2014-12-03: [http://ewisa.baw.de/files/11284_tv12_2014_12_03_ncanalyse_lzks_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Salzgehalts''];
** 2014-12-03: [http://ewisa.baw.de/files/11285_tv12_2014_12_03_ncanalyse_tdks_g_lang.pdf ''NCANALYSE - Tidekennwerte des Salzgehalts''];
** 2014-10-08: [http://ewisa.baw.de/files/10587_tv12_2014_10_08_ncanalyse_lzkv_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte der Strömung''];
** 2014-09-10: [http://ewisa.baw.de/files/10588_tv12_2014_09_10_allgemein_g_lang.pdf ''NCANALYSE - Tidekennwerte der Strömung''];
** 2013-08-07: [http://ewisa.baw.de/files/08510_speech_2013-08-07.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Wasserstands''];
** 2013-05-15: [http://ewisa.baw.de/files/08500_speech_2013-05-15.pdf ''NCANALYSE - Daten aus CF netCDF Dateien analysieren''].
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
** 2022-04-25: [https://izw-campus.baw.de/goto.php?target=cat_4105&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse LZKW (tideunabhängige Kennwerte des Wasserstands)''];
** 2022-03-21: [https://izw-campus.baw.de/goto.php?target=cat_3829&client_id=iliasclient ''Energietransport einer Tidewelle''];
** 2021-11-29: [https://izw-campus.baw.de/goto.php?target=cat_3490&client_id=iliasclient ''NCANALYSE - Grundlagen - Wechselwirkung zwischen Salzgehalt und Schwebstoffgehalt''];
** 2021-10-18: [https://izw-campus.baw.de/goto.php?target=cat_3301&client_id=iliasclient ''NCANALYSE - Grundlagen verschiedener Kennwerte (Einfluss des Salzgehalts auf verschiedene Kenngrößen)''];
** 2021-09-13: [https://izw-campus.baw.de/goto.php?target=cat_3102&client_id=iliasclient ''NCANALYSE - Grundlagen TDKA (Tidekennwerte der Anomalie der Potentiellen Energie)''];
** 2021-08-09: [https://izw-campus.baw.de/goto.php?target=cat_1830&client_id=iliasclient ''NCANALYSE - Grundlagen TDKS (Tidekennwerte des Salzgehalts)''];
** 2021-06-07: [https://izw-campus.baw.de/goto.php?target=cat_2554&client_id=iliasclient ''NCANALYSE Update zu Skewness - aus Partialtiden des Wasserstands und der Strömung''];
** 2021-04-19: [https://izw-campus.baw.de/goto.php?target=cat_2329&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQV (Harmonische Analyse der Strömung)''];
** 2021-03-08: [https://izw-campus.baw.de/goto.php?target=cat_2224&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQW (Harmonische Analyse des Wasserstands)''];
** 2021-02-08: [https://izw-campus.baw.de/goto.php?target=cat_1940&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKV (Tidekennwerte der Strömungsgeschwindigkeit)''];
** 2021-01-11: [https://izw-campus.baw.de/goto.php?target=cat_1853&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKW (Tidekennwerte des Wasserstands)''];
* Musterdatei
** Musterdateien finden sich in '''$PROGHOME/examples/ncanalyse/'''
}}

NCPLOT.DAT

2025-01-03T10:59:29Z

Ak3spohr: Anpassung an neues FKB-Template

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Dezember 2024
|version_beschr=Januar 2025
|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)
* (optional) Key '''"Heaven_Hell_Colors" :''' Farbnamen für Himmel und Boden.
* (optional) Key '''"Heaven_Hell_Contour_Style" :''' Farbe und Strichstärke der Grenzlinien zum Wasserkörper.

===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 Ende-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis Ende-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 und ggf Hintergrundfarbe.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird und ggf Hintergrundfarbe.
: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_Draw_Heaven_Hell" :''' Himmel und Bodenflächen bei Vertikalschnitt oder Tiefenzeitreihe visualisieren.
* (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 und ggf Hintergrundfarbe.
* 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.
* (optional) Key '''"Axis_Font_Size" :''' Schriftgröße für 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
:*'''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_Color_Name" :''' Farben des Legendenfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Frame_Style" :''' Aussehen der Legendenfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Legend_Box_Font_Size" :''' Schriftgröße für Legendenfeld.
* (optional) Key '''"MaxCharNumber_LegendEntry" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.
* (optional) Key '''"Legend_Box_Orientation" :''' Anordnung der Legendeneinträge.
* (optional) Key '''"Legend_Box_HIDE_List" :''' Legenden-Einträge dieser Liste werden NICHT gezeigt.
* (optional) Key '''"Legend_Box_SHOW_List" :''' NUR die Legenden-Einträge dieser Liste werden gezeigt.

===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.
:Platzhalter für Textbox, die mit einem DataRow-Block verbunden ist:
:*<ROW_T_DROW>, <ROW_F_DROW> wird durch Kennung des DataRow-Blocks ersetzt.
:*<ROW_T_DSET>, <ROW_F_DSET> wird durch Kennung des mit dem DataRow-Block verknüpften Datasets ersetzt.
:*<ROW_T_DIM1>, <ROW_F_DIM1> wird durch Infotext zu 1. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM2>, <ROW_F_DIM2> wird durch Infotext zu 2. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM?>, <ROW_F_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im DataRow-Block per KEY ''DataRow_Linked_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.
* (optional) Key '''"MaxCharNumber_TextLine" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.

===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)
:*'''eñd''' = 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]]
|dateiform=FORMATTED
|beispieldatei=$PROGHOME/examples/ncplot/ncplot.dat
}}

NCPLOT

2025-01-02T16:11:43Z

Ak3spohr: Version angepasst

{{Programmkennblatt
|name_en=NCPLOT
|name=NCPLOT
|version=Dezember 2024
|version_beschr=September 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]], [[TS2NC]], [[DATACONVERT]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor= ---
|programmiersprache=Fortran95
|zus_software= GKS (GTS-Gral)
|kontakt_original=G. Lang, S. Spohr
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
}}

NCPLOT.DAT

2025-01-02T16:09:24Z

Ak3spohr: Neues mit Version ncplot_2024_12_20

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=Dezember 2024
|version_beschr=Dezember 2024
|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)
* (optional) Key '''"Heaven_Hell_Colors" :''' Farbnamen für Himmel und Boden.
* (optional) Key '''"Heaven_Hell_Contour_Style" :''' Farbe und Strichstärke der Grenzlinien zum Wasserkörper.

===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 Ende-Index.
* (optional) Key '''"DimSelect_StartEnd_Date" :''' Zeitpunkte von Start- bis Ende-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 und ggf Hintergrundfarbe.
:Hinweis: Erforderlich für Diagrammdefinition Kartenansicht (Layer_Type ''XY_data'').
* (optional) Key '''"Layer_Area" :''' Bildfläche, die von den Diagrammachsen aufgespannt wird und ggf Hintergrundfarbe.
: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_Draw_Heaven_Hell" :''' Himmel und Bodenflächen bei Vertikalschnitt oder Tiefenzeitreihe visualisieren.
* (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 und ggf Hintergrundfarbe.
* 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.
* (optional) Key '''"Axis_Font_Size" :''' Schriftgröße für 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
:*'''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_Color_Name" :''' Farben des Legendenfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Frame_Style" :''' Aussehen der Legendenfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Legend_Box_Font_Size" :''' Schriftgröße für Legendenfeld.
* (optional) Key '''"MaxCharNumber_LegendEntry" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.
* (optional) Key '''"Legend_Box_Orientation" :''' Anordnung der Legendeneinträge.
* (optional) Key '''"Legend_Box_HIDE_List" :''' Legenden-Einträge dieser Liste werden NICHT gezeigt.
* (optional) Key '''"Legend_Box_SHOW_List" :''' NUR die Legenden-Einträge dieser Liste werden gezeigt.

===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.
:Platzhalter für Textbox, die mit einem DataRow-Block verbunden ist:
:*<ROW_T_DROW>, <ROW_F_DROW> wird durch Kennung des DataRow-Blocks ersetzt.
:*<ROW_T_DSET>, <ROW_F_DSET> wird durch Kennung des mit dem DataRow-Block verknüpften Datasets ersetzt.
:*<ROW_T_DIM1>, <ROW_F_DIM1> wird durch Infotext zu 1. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM2>, <ROW_F_DIM2> wird durch Infotext zu 2. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM?>, <ROW_F_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im DataRow-Block per KEY ''DataRow_Linked_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.
* (optional) Key '''"MaxCharNumber_TextLine" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.

===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)
:*'''eñd''' = 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
}}

Tideunabhängige Kennwerte der Strömung

2024-09-13T12:07:05Z

Ak3spohr:

[[en:Characteristic Numbers of Current Velocity (independent of tides)]]
[[Kategorie:Tideunabhängige Kennwerte]]

==Motivation==
Die Berechnung und graphische Darstellung der tideunabhängigen Kennwerte der Strömung kann dazu beitragen, einige Aspekte des Systemverhaltens natürlicher [[Gewässer]] näher zu beleuchten. Im Gegensatz zu den [[Tidekennwerte der Strömung|Tidekennwerten der Strömung]] dient die Ermittlung der tideunabhängigen Strömungskennwerte in erster Linie der Analyse des (System-) Verhaltens von
* nicht durch Gezeiten dominierten Gewässern, wie beispielsweise den Küstengewässern und Flußmündungen entlang der Ostseeküste, oder
* zur Ermittlung von Strömungskennwerten für beliebig lange oder kurze Analysezeiträume, oder
* für diejenigen Abschnitte von Tidegewässern, in denen es nicht oder nur sehr kurzzeitig zu einer Umkehr der Strömung kommt, so dass eine entsprechende Berechnung der [[Tidekennwerte der Strömung]] entweder nicht möglich oder nicht sinnvoll ist.
Im einzelnen sind verschiedene nützliche Anwendungen der Analyseergebnisse denkbar, zum Beispiel:
* Aus den Zeiten bzw. Häufigkeiten für die Dauer hoher oder niedriger Strömungsgeschwindigkeit können Rückschlüsse auf die Dauer von Ereignissen mit extremen Strömungsverhältnissen gezogen werden. Diese Werte lassen sich z.B. zur Beurteilung der damit verbundenen Belastungen für [[Fauna]] und [[Flora]] des Gewässers heranziehen.

'''Tideunabhängige Kennwerte der Strömung werden von den Programmen [[LZKVF]] und [[NCANALYSE]] berechnet.'''

==Definition der Kennwerte==

===Maximale Strömungsgeschwindigkeit (Vmax)===
Höchster Wert der (lokalen) Strömungsgeschwindigkeit innerhalb des Analysezeitraums. 
[[Beispielgrafik: Maximale Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[LZKVF]] und [[NCANALYSE]].

===Maximale gültige Strömungsgeschwindigkeit (xVmax)===
Höchster Wert der (lokalen) Strömungsgeschwindigkeit innerhalb einer beliebigen Zeitspanne, in der beliebig viele ungültige Werte (Trockenfallen sowie andere Gründe für ungültige Daten) enthalten sein dürfen, so dass nicht sicher gestellt ist, dass der maximale Datenwert der Vmax entspricht. 

Analyseprogramm: [[NCANALYSE]].

===Residuelle Strömungsgeschwindigkeit (Vres)===
Residuelle Strömungsgeschwindigkeit (aus vektorieller Addition) innerhalb des Analysezeitraums. 
Das Residuum wird dabei auf Basis der Dauer der tatsächlichen Überflutung berechnet. 
[[Beispielgrafik: Residuelle Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[NCANALYSE]].

===Mittlere Strömungsgeschwindigkeit (Betrag) (VmitB)===
Mittlere Strömungsgeschwindigkeit (dem Betrag nach) innerhalb des Analysezeitraums. 
Der Wert wird dabei auf Basis der Dauer der tatsächlichen Überflutung berechnet. 
[[Beispielgrafik: Mittlere Strömungsgeschwindigkeit (Betrag)]]. 
Analyseprogramm: [[LZKVF]] und [[NCANALYSE]].

===Standardabweichung der Strömungsgeschwindigkeit (StdAbw)===
Standardabweichung der Strömungsgeschwindigkeit innerhalb des Analysezeitraums. 
Wird nur für dauerhaft überflutete Gebiete berechnet. 
[[Beispielgrafik: Standardabweichung der Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[NCANALYSE]].

===Varianz der Strömungsgeschwindigkeit (Var)===
Varianz der Strömungsgeschwindigkeit innerhalb des Analysezeitraums. 
Wird nur für dauerhaft überflutete Gebiete berechnet. 
[[Beispielgrafik: Varianz der Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[NCANALYSE]].

===Dauer hoher Strömungsgeschwindigkeit (VhDau)===
Zeitraum, in dem der Betrag der Strömungsgeschwindigkeit oberhalb eines bestimmten Grenzwerts liegt. 
[[Beispielgrafiken: Dauer hoher Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[LZKVF]] und [[NCANALYSE]].

===Dauer niedriger Strömungsgeschwindigkeit (VnDau)===
Zeitraum, in dem der Betrag der Strömungsgeschwindigkeit unterhalb eines bestimmten Grenzwerts liegt. 
[[Beispielgrafiken: Dauer niedriger Strömungsgeschwindigkeit]]. 
Analyseprogramm: [[LZKVF]] und [[NCANALYSE]].

===Häufigkeitsverteilung der Strömung (RelFreq)===
Relative Häufigkeit der Strömungsgeschwindigkeit für bestimmte Geschwindigkeitsintervalle. 
[[Beispielgrafiken: Relative Häufigkeitsverteilung der Strömung]]. 
Analyseprogramm: [[LZKVF]] und [[NCANALYSE]].

===Kumulative Häufigkeitsverteilung der Strömung (CumFreq)===
Kumulative Häufigkeit der Strömungsgeschwindigkeit für bestimmte Geschwindigkeitsintervalle. 
[[Beispielgrafiken: Kumulative Häufigkeitsverteilung der Strömung]]. 
Analyseprogramm: [[NCANALYSE]].

===Häufigkeit der Überschreitung von Strömungsgrenzwerten (ExcFreq)===
Häufigkeit der Überschreitung von Strömungsgrenzwerten innerhalb des Analysezeitraums. 
[[Beispielgrafiken: Häufigkeit der Überschreitung von Strömungsgrenzwerten]]. 
Analyseprogramm: [[NCANALYSE]].

===Häufigkeit der Unterschreitung von Strömungsgrenzwerten (UndFreq)===
Häufigkeit der Unterschreitung von Strömungsgrenzwerten innerhalb des Analysezeitraums. 
[[Beispielgrafiken: Häufigkeit der Unterschreitung von Strömungsgrenzwerten]]. 
Analyseprogramm: [[NCANALYSE]].

===Quantile der Strömungsgeschwindigkeit===
Wert der Strömungsgeschwindigkeit einer Zeitreihe, der von einem bestimmten prozentualen Anteil der
vorliegenden Strömungswerte nicht überschritten wird. 
Wird nur für dauerhaft überflutete Gebiete berechnet. 
* a) [[Beispielgrafik: Median der Strömungsgeschwindigkeit Q_0.50]]
* b) [[Beispielgrafiken: Quantile der Strömungsgeschwindigkeit Q_0.01, Q_0.05, Q_0.95, Q_0.99]]
Analyseprogramm: [[NCANALYSE]].

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

NC2TABLE.DAT

2024-05-21T14:09:53Z

Ak3spohr: update version

{{Dateikennblatt
|name_en=NC2TABLE.DAT
|dateityp=nc2table.dat
|version=Mai 2024
|version_beschr=Oktober 2017
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NC2TABLE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''ASCII_Output_Format''': Format der Ergebnisdatei(en)
*## ''csv'' : [[NC2TABLE.CSV|nc2table.csv]], Ergebnisse im [https://de.wikipedia.org/wiki/CSV_(Dateiformat) CSV-Format]
*# '''Max_Read_Storage''': Maximale Anzahl der vom Programm in einem READ-Zyklus gespeicherten Datenwerte.
*# (optional) '''Create_Missing_Variables''': Automatische Erzeugung fehlender Variablen, z. B. für D-Flow FM Ergebnisse.
*## ''0'' : Es wird nicht versucht, zusätzliche Variablen zu erzeugen (Default);
*## ''1'' : Es wird versucht, zusätzliche Variablen aus den vorhandenen Variablen abzuleiten.
*# (optional) '''Fortran_Format''': Fortran-Format, z. B. '''F10.3'''.
*## Falls dieser ''Key'' angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert '''G15.8''' benutzt.
*## Es dürfen nur in nc2table_dico.dat mit FixValue zugelassene Formate verwendet werden.
*# (optional) '''Min_Water_Depth''': Minimale Wasserbedeckung in [m], bis zu der Daten als gültig betrachtet werden.
*## Falls dieser ''Key'' angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert 0.0 benutzt.
*## Funktioniert nur, falls den Variablen die Hilfsvariable ''Gesamtwassertiefe'' zugeordnet ist.
*# (optional) '''NOBS_Filter''': Bezeichnung des ''Filtertyps'' und des ''Filterwerts''.
*## ''Filtertypen'':
*### ''EQ'' : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten genau einem bestimmten Wert entspricht.
*### ''LE'' : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten kleiner oder gleich einem bestimmten Wert ist.
*### ''GE'' : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten größer oder gleich einem bestimmten Wert ist.
*## ''Filterwert'':
*### ''N'' : 0 := maximale Anzahl; N := Anzahl N; -M := maximale Anzahl minus M.
*## Falls dieser ''Key'' angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert ''kein Filter'' benutzt.
*## Funktioniert nur, falls einer Variablen eine Hilfsvariable ''Anzahl der Ereignisse'' zugeordnet ist.
*# (optional) '''Undefined_String'''
*## Falls dieser ''Key'' angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert''--undefined-'' benutzt.
*# (optional) '''Date_Time_Format''': String zur Beschreibung des Ausgabeformats für Datum und Uhrzeit.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert ISO8601 (siehe [https://de.wikipedia.org/wiki/ISO_8601 ISO 8601]) benutzt.
*## Falls dieser ''Key'' angegeben wird, so darf er sich aus folgenden Komponenten zusammensetzen:
*##: ''YYYY'' : Jahr
*##: ''MM'' : Monat
*##: ''DD'' : Tag
*##: ''hh'' : Stunde
*##: ''mm'' : Minute
*##: ''ss'' : Sekunde
*##: ''n'' : Sekundenbruchteile, von "n" (1/10 Sek) bis''nnnnnnn'' (1/100000000 Sek)
*##: ZZZZ : Zeitzone (als Text)
*##: zzzz : Zeitzone als ganze Zahl (INTEGER)
*##: Des weiteren die Zeichen ".", ":", "-" oder " ".
*##: Beispiele: YYYY-MM-DD hh:mm:ss ; YYYY-MM-DD hh:mm:ss.nnn ZZZZ.
*# (optional) '''TIME_DIFF_Format''': String zur Beschreibung des Ausgabeformats für Zeitdifferenzen.
*## Falls dieser ''Key'' nicht angegeben wird, so wird der programmintern eingestellte Wert ISO8601 (siehe [https://de.wikipedia.org/wiki/ISO_8601 ISO 8601]) benutzt.
*## Falls dieser ''Key'' angegeben wird, so darf er sich aus folgenden Komponenten zusammensetzen:
*##: ''V'' : Vorzeichen
*##: ''D'' : Tage, von ''D'' bis ''DDDDDD''
*##: ''hh'' : Stunde
*##: ''mm'' : Minute
*##: ''ss'' : Sekunde
*##: ''n'' : Sekundenbruchteile, von "n" (1/10 Sek) bis ''nnnnnnn'' (1/100000000 Sek)
*##: Des weiteren die Zeichen ".", ":", "-" oder " ".
*##: Beispiel: Vhh:mm:ss.
*# (optional) '''Hor_Coord_Format''': Ausgabeformat für (geografische) Koordinaten:
*## Format '''XY''': Ausgabe der lokalen Koordinaten als reelle Zahl.
*## Format '''GEO_LON_LAT''': Ausgabe der geografischen Koordinaten als reelle Zahl (in Grad).
*## Format '''GEO_DEGREE''': Ausgabe der geografischen Koordinaten in Grad, Minute, Sekunde (und Sekundenbruchteilen) sowie Angabe von '''N''', '''S''', '''E''' oder '''W''' (Default).
*# (optional) '''Table_Datetime_Zone''': Zeitzone bei Ausgabe von Datums- und Zeitangaben in Tabellen.
*## '''UTC''' oder '''GMT''': [https://de.wikipedia.org/wiki/Koordinierte_Weltzeit ''Universal Time Coordinated''] (Default);
*## '''CET''' oder '''MEZ''': [https://www.timeanddate.de/zeitzonen/weltweit/mez ''Central European Time''];
*## '''CEST''' oder '''MESZ''': [https://www.timeanddate.de/zeitzonen/weltweit/mesz ''Central European Summer Time''].
* Block '''Input_Variable_Info''' (IVI): Informationen zu Variablen (kann mehrfach angegeben werden)
*# '''Name''': Kurzbezeichnung
*## Frei wählbare Bezeichnung, mit dem die Variable später ''angesprochen'' werden kann.
*## Werden mehrere IVI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
*## Bei Extraktionen mit mehreren IVIs je Tabelle wird dieser Wert zur Bezeichnung der Spalte/Zeile verwendet.
*# '''File''': Dateiname und Dateityp
*## Name der Datei mit den zu extrahierenden Daten, Typ [[CF-NETCDF.NC|cf-netcdf.nc]].
*## Typ der Datei ''NETCDF''.
*# '''Variable''': Name der in der Datei abgelegten Variable. Muss in '''File''' enthalten sein.
*# (optional) '''Fortran_Format''': Fortran-Format.
*## Übersteuert den programminternen Default-Wert oder den in Block '''Program_Parameters''' angegebenen Wert. Siehe Block '''Program_Parameters'''.
*## Für Zeitangaben darf hier auch ''TI'' angegeben werden. Dann erfolgt die Ausgabe im '''Date_Time_Format'''.
*## Für Zeitdifferenzen darf hier auch ''DT'' angegeben werden. Dann erfolgt die Ausgabe im '''TIME_DIFF_FORMAT'''.
*# (optional) '''Display_Unit''': Einheit, in welcher die Variable in die Tabelle extrahiert werden soll.
*## Muss in $PROGHOME/cfg/phydef.cfg.si.dat bekannt sein.
*## Derzeit wird ''nur'' eine Umrechnung unter Beibehaltung der SI-Basis unterstützt, z. B. von ''m'' nach ''cm''.
*## Fehlt dieser ''Key'', so wird die Variable in ihrer originalen Einheit extrahiert.
*# '''Min_Water_Depth''': Minimale Wasserbedeckung in [m], bis zu der Daten als gültig betrachtet werden.
*## Übersteuert den programminternen Default-Wert oder den in Block '''Program_Parameters''' angegebenen Wert. Siehe Block '''Program_Parameters'''.
*# (optional) '''NOBS_Filter''': Bezeichnung des ''Filtertyps'' und des ''Filterwerts''.
*## Übersteuert den programminternen Default-Wert oder den in Block '''Program_Parameters''' angegebenen Wert. Siehe Block '''Program_Parameters'''.
* Block '''Coordinate_Space_Info''' (CSI): Angaben zu Dimensionen (kann mehrfach angegeben werden)
*# '''Name''': Kurzbezeichnung
*## Frei wählbare Bezeichnung, mit der die Dimension später ''angesprochen'' werden kann.
*## Werden mehrere CSI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
*# '''Dim_Name''': Name der Dimension
*## Muss eine gültige Dimension aus den in den in IVI-Blöcken referenzierten Dateien sein.
*## Für alle in IVI-Bloecken benutzten Variablen sollten möglichst alle Dimensionen in CSI-Blöcken spezifiziert werden.
*## Nicht näher spezifizierte, aber in Gebrauch befindliche Dimensionen, werden mit vollem Wertebereich berücksichtigt. Dies kann zu einer sehr großen Zahl extrahierter Tabellen führen.
*# '''Dim_Space''': Wertebereich (vier verschiedene Optionen)
*## '':'' : alle Werte (in dieser Koordinaten-Richtung).
*## ''<startindex>:<endindex>:<schrittweite>'' : äquidistante Auswahl.
*## ''indices=<index1>,<index2>,<index3>,...,<indexN>'' : Liste (ganze Zahlen).
*## ''names=<name1>,<name2>,<name3>,...,<nameN>'' : Liste von Namen. Müssen in einer entsprechenden Label-Koordinatenvariable enthalten sein.
*## ''xy=(<x1>,<y1>),(<x2>,<y2>),(<x3>,<y3>),...,(<xN>,<yN>)'': Liste von Koordinatenpaaren (lokale Koordinaten). Die Dimension muss in einer Koordinatenvariablen enthalten sein. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Koordinatenpaare angegeben werden.
*## ''geo=(<lon1>,<lat1>),(<lon2>,<lat2>),(<lon3>,<lat3>),...,(<lonN>,<latN>)'': Liste von Koordinatenpaaren (geografische Koordinaten). Die Dimension muss in einer Koordinatenvariablen enthalten sein. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Koordinatenpaare angegeben werden.
*## ''file=<[[CF-NETCDF.NC|cf-netcdf.nc]]>,NETCDF,<x_or_lon>,<y_or_lat>'': Dateiname, Typ der Datei (derzeit nur NETCDF) sowie Namen der Variablen für die x-Koordinate oder geografische Länge und y-Koordinate oder geografische Breite. Geeignete Dateien können z. B. mit Programm [[GRIDCONVERT]] erzeugt werden. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Angaben gemacht werden.
*# '''Dim_EPSG''': (optional) EPSG-Code (siehe [https://www.epsg-registry.org/ EPSG Geodetic Parameter Registry]) lokaler Koordinaten in Dim_Space. Falls nicht angegeben wird angenommen, dass die in Dim_Space angegebenen lokalen Koordinaten in demselben Koordinatensystem vorliegen wie in der Datendatei.
* Block '''Table_Design_Info''' (TDI): Grundsätzlicher Aufbau der Tabelle (kann mehrfach angegeben werden).
*# ''Name'': Kurzbezeichnung.
*## Frei wählbare Bezeichnung, mit dem das Table-Design später ''angesprochen'' werden kann.
*## Werden mehrere TDI-Blöcke angegeben, so muss der Name eineindeutig sein.
*# '''First_Column_IVI''': Gültiger ''Name'' aus Block '''Input_Variable_Info'''.
*## Wird zur ''Gestaltung'' der ersten ''Spalte'' einer Tabelle ausgewertet. Hinweis: Die erste Spalte enthält typischer Weise Informationen zu den Koordinaten in dieser Richtung.
*# '''First_Row_IVI''': Gültiger ''Name'' aus Block '''Input_Variable_Info'''.
*## Wird zur ''Gestaltung'' der ersten ''Zeile'' einer Tabelle ausgewertet. Hinweis: Die erste Zeile enthält typischer Weise Informationen zu den Koordinaten in dieser Richtung.
*# (optional) '''Row_CSI''': Gültiger ''Name'' aus Block '''Coordinate_Space_Info'''
*## Bezeichnet die Koordinate (Dimension) für die ''Zeilen'' der Tabelle.
*# (optional) '''Column_CSI''': Gültiger ''Name'' aus Block '''Coordinate_Space_Info'''
*## Bezeichnet die Koordinate (Dimension) für die ''Spalten'' der Tabelle.
*## Die ''Column_CSI'' darf nicht mehr als 34 Werte (= Spalten) aufweisen.
*# (optional) '''Other_CSI''': Gültiger ''Name'' aus Block '''Coordinate_Space_Info'''
*## Es können mehrere CSI angegeben werden.
*## Damit wird der Wertebereich der anderen Koordinaten (Dimensionen) festgelegt.
*## Die Anzahl der erzeugten Tabellen entspricht typischer Weise dem Produkt der in den ''Other_CSI'' enthaltenen Schritte.
*# '''Hinweise''' zu ''Row_CSI'' und ''Column_CSI''
*## Falls in dem Block '''Table_Contents_Info''' eine Tabelle nur aus ''einer'' IVI aufgebaut wird, müssen beide Dimensionen, also ''Column_CSI'' '''und''' ''Row_CSI'' spezifiziert werden.
*## Falls in dem Block '''Table_Contents_Info''' eine Tabelle aus ''mehreren'' IVI aufgebaut wird, darf nur eine der Dimensionen, also ''Column_CSI'' '''oder''' ''Row_CSI'' spezifiziert werden.
*## Große Dimensionen, z. B. Anzahl der Termine in einer Zeitserie, können nur als ''Row_CSI'' verarbeitet werden, da die Anzahl der Spalten begrenzt ist.
* Block '''Table_Contents_Info''' (TCI): Aufbau und Inhalt einer (Serie von) Tabelle(n) (kann mehrfach angegeben werden).
*# '''Name''': Kurzbezeichnung.
*## Frei wählbare Bezeichnung, mit welchem der ''Table-Contents'' verbunden wird.
*## Die für diese Tabelle(n) erzeugte(n) Datei(en) lauten auf
*##: ''<tci:name>_<nnnnnn>.csv'' (Daten)
*##: ''<tci_name>_<nnnnnn>.txt'' (Metadaten)
*## Werden mehrere TCI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
*## Namensgleiche Dateien dürfen nicht in dem Verzeichnis vorhanden sein! Vorher unbedingt verschieben oder löschen!
*# '''TDI''': Gültiger "Name" aus Block '''Table_Design_Info'''
*## Wird zur ''Gestaltung'' der Tabelle ausgewertet.
*# '''IVI''': Gültiger ''Name'' aus Block '''Input_Variable_Info'''.
*## Beschreibt die für die Tabelle benutzten Daten.
*## Kann mehrfach angegeben werden. In diesem Fall dürfen bei ''TDI'' nur ''Row_CSI'' '''oder''' ''Column_CSI'' angegeben werden.

===Anmerkungen===
# Benutzte '''Dictionary-Datei''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''nc2table_dico.dat'''''.
|nutzerprogramme=[[NC2TABLE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/nc2table/*/mod_m_nc2table_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang]
|beispieldatei=$PROGHOME/examples/nc2table/nc2table.dat
}}

NC2TABLE

2024-05-21T14:09:10Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NC2TABLE
|name=NC2TABLE
|version=Mai 2024
|version_beschr=September 2022
|stichworte=
Datenkonversion 
Postprocessor 
[[NetCDF|CF NetCDF]] Format 
[https://de.wikipedia.org/wiki/CSV_(Dateiformat) CSV Format] (''comma separated values'') 
Tabelle 
Unterstützung von DMQS-Metadaten und -Variablen 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 

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 NC2TABLE ermöglicht die selektive Extraktion von Daten aus Dateien des [[NetCDF|CF NetCDF]]-Formats in das [https://de.wikipedia.org/wiki/CSV_(Dateiformat) CSV-Format].
Die extrahierten Daten liegen in Tabellenform vor und können in Programme wie MS EXCEL importiert werden.

===Allgemeine Anmerkungen===

In (netCDF-) Dateien abgelegte geophysikalische Variablen '''f_i''' weisen eine unterschiedliche Anzahl von Koordinaten auf. Vom CF-Standard minimal gefordert sind Datum und Uhrzeit sowie die Lage, ausgedrückt in geografischen Koordinaten Länge und Breite oder entsprechenden lokalen Koordinaten.

Allgemeine Form einer Variablen (Funktion):

f = f_i(t,x[,z][,l][,c])

Darin bezeichnet '''t''' die Zeit, '''x''' den (horizontalen) Ort, '''z''' die Höhe oder Tiefe, '''l''' steht für einen ''Label'' (z. B. Fraktion) und '''c''' für eine Klasse (z. B. einer Häufigkeitsverteilung).

Nachfolgend wird für Variable der Ausdruck Funktion synonym verwendet.

===Aufbau von Tabellen===

Tabellen sind aus Zeilen und Spalten aufgebaut. Tabellen eignen sich z. B. für folgende Darstellungen:
# '''Tabelle Typ 1''' (Funktionsverlauf): Die Änderung der Funktion '''f_i''' in Abhängigkeit von zwei Koordinaten wird dargestellt. Die Werte (optionaler) zusätzlicher Koordinaten bleiben eingefroren. Beispiel: Wasserstand an verschiedenen Orten '''x_m''' zu verschiedenen Zeiten '''t_n'''.
#:Gängige Kombinationen von Achsen sind:
#:* Zeitserien (Zs): '''f(t,x)''' Zs für mehrere Orte, '''f(t,z)''' Zs für mehrere Schichten, '''f(t,l)''' Zs für mehrere Fraktionen und '''f(t,c)''' Zs für mehrere Klassen oder Frequenzen.
#:* Variation über den Ort: '''f(x,z)''' Variation über die Wassertiefe, '''f(x,l)''' Variation über die Fraktionen und '''f(x,c)''' Variation über Klassen oder Frequenzen.
#:* Variation über die Tiefe: '''f(z,l)''' Variation über die Fraktionen und '''f(z,c)''' Variation über Klassen oder Frequenzen.
#:* Sonstige: '''f(l,c)''' Häufigkeitsverteilung verschiedener Fraktionen.
# '''Tabelle Typ 2''' (Funktionsvergleich): Die Änderung mehrerer Funktionen '''f_i,''' mit '''i=1,n_i''' in Abhängigkeit einer Koordinate werden dargestellt. Die anderen Koordinaten bleiben dabei eingefroren. Beispiel: Zeitreihen des Wasserstands, der Strömungsgeschwindigkeit und des Salzgehalts an einem Ort.

Das Programm NC2TABLE unterstützt die Erzeugung der beiden vorgenannten Tabellenarten. Insofern Datums- und Zeitangaben ausgegeben werden, kann die Zeitzone für die Ausgabe über [[NC2TABLE.DAT|nc2table.dat]] beeinflusst werden.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NC2TABLE.DAT|nc2table.dat]]);
# '''geophysikalische Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''ASCII-Tabellen''' (Dateityp [[NC2TABLE.CSV|nc2table.csv]]) im [https://de.wikipedia.org/wiki/CSV_(Dateiformat) CSV-Dateiformat];
# '''Metadaten''' (Dateityp nc2table.txt) als Text-Datei;
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp nc2table.sdr);
# (optional) Datei mit '''Testausgaben''' (Dateityp nc2table.trc).
|methode=
Die binären Daten werden gemäß den Wünschen des Anwenders extrahiert.

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]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=Tabellenkalkulationsprogramm, Texteditor
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=Musterdateien finden sich in '''$PROGHOME/examples/nc2table/'''
}}

NCMERGE.DAT

2024-03-12T13:02:02Z

Ak3spohr: update version date

{{Dateikennblatt
|name_en=NCMERGE.DAT
|dateityp=ncmerge.dat
|version=März 2024
|version_beschr=Januar 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCMERGE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000.
*# (optional) '''Create_Missing_Variables''': Erzeugen zusätzlicher Variablen
*#* 0 = keine zusätzlichen Variablen erzeugen (Default)
*#* 1 = zusätzliche Variablen erzeugen (in Kombination mit DFlow FM)
*# (optional) '''NC_Deflate_Level''': Kompression der Ergebnisdaten
*#* 0 = keine Kompression
*#* 1 ... 8 = Kompression (Default = 3)
*#* 9 = maximale Kompression
*# (optional) '''END_After_Define''': Abbruch nach Erzeugen der Metadaten der Output-Datei
*#* .false. = Programm läuft bis zum Ende durch (Default)
*#* .true. = Programm endet nach Definition der Ergebnisdatei (Metadaten)
* (optional) Block '''Hash_Identity_Checks''': Steuerung des Vergleichs von [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werten
*# '''Check_MD5'''
*#* Name der MD5-Hash Variablen für die ein Abgleich durchgeführt werden soll;
*#* Descriptor der zu vergleichenden Datei;
*#* Anforderung an die Übereinstimmung
*#** '''STRICT''' (exakte Übereinstimmung)
*#** '''WARNING''' (Warnung bei Nicht-Übereinstimmung)
:::''Hinweis:'' Die MD5-Hash Variable muss für einen Vergleich in allen Input-NetCDF-Dateien vorhanden sein.
* Block '''Input_Files''': Input-NetCDF-Dateien
*# '''Data_File''' Name und Typ der Input-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Es müssen wenigstens zwei Dateien angegeben werden
:::- Dateien müssen vorhanden sein
:::''Hinweis:'' Hinter dem Dateityp dürfen verschiedene Key-Value Paare zur Beschränkung des zu transferierenden Zeitraums angegebe werden:
:::- '''TA'''=DD.MM.YYYY-hh:mm:ss Anfangszeit
:::- '''TE'''=DD.MM.YYYY-hh:mm:ss Endezeit
:::- '''TZ'''=UTC MEZ MESZ ... Zeitzone
:::- '''DT'''=dddddd-hh:mm:ss Ausgabe-Zeitschritt
* Block '''Output_File''': Output-Datei
*# '''Data_File''' Name und Typ der Output-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei darf nicht vorhanden sein

===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncmerge_dico.dat'''''.

|nutzerprogramme=[[NCMERGE]]
|programmiersprache=Fortran95
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncmerge/*/mod_m_ncmerge_steer.f90
|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]
|beispieldatei=$PROGHOME/examples/ncmerge/ncmerge.dat
}}

NCMERGE

2024-03-12T13:01:27Z

Ak3spohr: update version date

{{Programmkennblatt
|name_en=NCMERGE
|name=NCMERGE
|version=März 2024
|version_beschr=September 2022
|stichworte=Postprozessor 
Zusammenfügen des Inhalts mehrerer [[CF-NETCDF.NC | netcdf.nc]] Dateien 
Änderung des Zeitschritts äquidistanter Datensätze 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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 ermöglicht das Zusammenfügen der Inhalte mehrerer [[CF-NETCDF.NC | netcdf.nc]] Dateien in einer [[CF-NETCDF.NC | netcdf.nc]] Datei.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCMERGE.DAT|ncmerge.dat]]);
# '''Input-Daten''', mehrere Dateien (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''Output-Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncmerge.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncmerge.trc)

|methode=
Das Programm untergliedert sich im Wesentlichen in folgende Abschnitte:
# Lesen, Prüfen und Druckerausgabe der Steuerdaten des Anwenders;
# Metadaten der Input-Daten lesen;
# Metadaten in programminterne Datenobjekte transferieren;
# Klassifikation aller Variablen der Input-Dateien;
# Transfer-Operation der primären Input-Variablen ermitteln;
# Transfer-Operationen aller anderen Input-Variablen ermitteln;
# Gemeinsame Zeit-Koordinaten-Variablen der Output-Variablen erzeugen;
# (optional) Abgleich von MD5 Hash-Werten zwischen den verschiedenen Input-Dateien;
# Kopieren der zu transferierenden Variablen aus den Input-Dateien in die Output-Datei.

|preprozessor=[[DATACONVERT]], [[BOE2NC]], [[NCAGGREGATE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCRCATMAT]], [[NetCDF Operators]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[NCAUTO]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCPLOT]], [[NCPOLO]], [[NC2TABLE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|programmiersprache=Fortran95
|zus_software= keine
|kontakt_original=G. Lang, S. Spohr
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
** 2022-02-14: [https://izw-campus.baw.de/goto.php?target=cat_3742&client_id=iliasclient ''NCMERGE - Anwendung, Struktur, Code-Beispiele''].
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncmerge/'''
}}

NCDVAR.DAT

2023-05-17T10:10:45Z

Ak3spohr: update version

{{Dateikennblatt
|name_en=NCDVAR.DAT
|dateityp=ncdvar.dat
|version=Mai 2023
|version_beschr=August 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000.
*# (optional) '''Create_Missing_Variables''': Erzeugen zusätzlicher Variablen
*#* 0 = keine zusätzlichen Variablen erzeugen (Default)
*#* 1 = zusätzliche Variablen erzeugen (in Kombination mit DFlow FM)
*# (optional) '''NC_Deflate_Level''': Kompression der Ergebnisdaten
*#* 0 = keine Kompression
*#* 1 ... 8 = Kompression (Default = 3)
*#* 9 = maximale Kompression
*# (optional) '''END_After_Define''': Abbruch nach Erzeugen der Metadaten der Output-Datei
*#* .false. = Programm läuft bis zum Ende durch (Default)
*#* .true. = Programm endet nach Definition der Ergebnisdatei (Metadaten)
*# (optional) '''Delete_Coordinate_Variables''': Löschen von Koordinatenvariablen bestimmten Typs
*#* X-Y = alle x- und y-Koordinatenvariablen (projizierte Koordinaten) werden nicht transferiert
*#* LON-LAT = alle lon- und lat-Koordinaten (geografische Koordinaten) werden nicht transferiert
*#* Wir dieser Key nicht angegeben, so werden alle Koordinatenvariablen transferiert
* Block '''Input_File''': Input-Datei
*# '''Data_File''' Name und Typ der Input-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei muss vorhanden sein
* Block '''Output_File''': Output-Datei
*# '''Data_File''' Name und Typ der Output-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei darf nicht vorhanden sein
* (optional) Block '''Mesh_Variables_Action''': Aktionen auf allen Variablen eines Gitters (''Mesh'')
*# '''Action''': Name der ''Mesh''-Variable und Aktion ('''COPY''', '''DELETE'''), die auf den Variablen dieses Gitters ausgeführt werden soll.
:::- Nicht alle [[CF-NETCDF.NC|netcdf.nc]]-Dateien verfügen über ''Mesh''-Variablen;
:::- Wird für ''Mesh'' '''ALL''' angegeben, so werden alle Variablen auf die entsprechende Aktion gesetzt;
:::- Zeile darf mehrfach angegeben werden.
* (optional) Block '''Single_Variable_Action''': Aktionen für individuelle Variablen
*# '''Action''': Name der ''Variable'' und Aktion ('''COPY''', '''DELETE'''), die für diese Variable durchgeführt werden soll.
:::- Zeile darf mehrfach angegeben werden;
:::- Übersteuert ggf. die globale ''Action'' in Block '''Mesh_Variables_Action''';
:::- Der Anwender darf nur von ihm ''beeinflussbare'' Variablen aufzählen. Diese werden auch als geophysikalische Variablen bezeichnet. Koordinatenvariablen, Gewichtsvariablen, etc. dürfen vom Anwender ''nicht'' angegeben werden.
* (optional) Block '''Time_Coordinate_Thinning''': Ausdünnen von äquidsitanten Zeit-Koordinaten
*# '''Time_KV_Name''': Name der Zeit-Koordinatenvariable
*# '''Start_Time''': Anfangs-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
*# '''End_Time''': Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
*# '''Time_Step''': Zeitschritt im Format dddddd-hh:mm:ss.nnnnnnnnn
:::- Funktioniert nur für zeitlich äquidistante Eingangsdaten;
:::- Anfangs- und Ende-Zeitpunkt müssen in den Eingangsdaten vorhanden sein;
:::- Zeitschritt muss ein ganzzahliges Vielfaches der Eingangsdaten sein. Das Lesen mit Stride /= 1 ist allerdings in der NetCDF-Library ineffizient umgesetzt und führt deshalb zu langen Programmlaufzeiten.

===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncdvar_dico.dat'''''.
# Anwendungsmöglichkeiten:
#* Fall 1: Löschen von Koordinatenvariablen eines bestimmten Typs;
#* Fall 2: Löschen/Kopieren von auf einem bestimmten Gitter vorliegenden Variablen;
#* Fall 3: Löschen/Kopieren ausgewählter Variablen;
#* Fall 4: Löschen/Kopieren ausgewählter Termine in Zeitrichtung äquidsitanten Daten.

|nutzerprogramme=[[NCDVAR]]
|programmiersprache=Fortran95
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncdvar/*/mod_m_ncdvar_steer.f90
|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]
|beispieldatei=$PROGHOME/examples/ncdvar/ncdvar.dat
}}

NCDVAR

2023-05-17T10:08:30Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NCDVAR
|name=NCDVAR
|version=Mai 2023
|version_beschr=September 2022
|stichworte=Postprozessor 
Selektives Löschen oder Kopieren von Variablen in einer [[CF-NETCDF.NC | netcdf.nc]] Datei 
Löschen/Kopieren von Koordiniatenvariablen eines bestimmten Typs (X-Y oder LON-LAT) 
Löschen/Kopieren von zu einem Gitter (''Mesh'') gehörenden Variablen 
Löschen/Kopieren einzelner Variablen 
Löschen/Kopieren von Terminen synoptischer, in Zeitrichtung äquidistanter Datensätze 
Automatisches Setzen der WRITE Chunk-Größe 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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=
The program enables the selective deletion / copying of variables in a [[CF-NETCDF.NC | netcdf.nc]] input file into an equivalent output file.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCDVAR.DAT|ncdvar.dat]]);
# '''Input-Daten''', auszudünnender Datensatz (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).

|ausgabedateien=
# '''Output-Daten''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncdvar.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncdvar.trc)

|methode=
Das Programm untergliedert sich im Wesentlichen in folgende Abschnitte:
# Lesen, Prüfen und Druckerausgabe der Steuerdaten des Anwenders;
# Metadaten der Input-Daten lesen;
# Metadaten in programminterne Datenobjekte transferieren;
# Klassifikation aller Variablen der Input-Datei;
# Abgleich der vom Anwender vorgegebenen Eingangsdaten mit den zur in der Input-Datei zur Verfügung stehenden Daten;
# Markieren aller primären, vom Anwender prinzipiell auswählbaren Variablen mit '''COPY''' oder '''DELETE''';
# Ableiten der Transfermethode (COPY, DELETE) für die von den Primärvariablen benutzen Variablen (Koordinatenvariable, Hilfsvariable, etc.);
# Kopieren der zu transferierenden Variablen aus der Input- in die Output-Datei.

|preprozessor=[[DATACONVERT]], [[BOE2NC]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCRCATMAT]], [[NetCDF Operators]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[NCAUTO]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCPLOT]], [[NCPOLO]], [[NC2TABLE]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|programmiersprache=Fortran95
|zus_software= keine
|kontakt_original=G. Lang, S. Spohr
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncdvar/'''
}}

NCAGGREGATE.DAT

2023-05-11T08:58:28Z

Ak3spohr: update version

{{Dateikennblatt
|name_en=NCAGGREGATE.DAT
|dateityp=ncaggregate.dat
|version=May 2023
|version_beschr=Dezember 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCAGGREGATE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Input_Data_File''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Output_Data_File''': [[NetCDF|CF NetCDF]] Datei mit aggregierten Ergebnisdaten
*# '''Aggregation_File''': Definition der Kontroll-Volumina in Datei des Typs [[IPDS.DAT|ipds.dat]]
*# '''Aggregation_EPSG''': EPSG-Code (siehe [http://www.epsg-registry.org/ http://www.epsg-registry.org/]) der Koordinaten des ''Aggregation_File''
*# (optional) '''NC_Deflate_Level''': ''deflate level'' (0,1,2,...,9) für die Online-Kompression der Daten beim Schreiben. 0 bedeutet keine Kompression, 9 maximale Kompression
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' der [[NetCDF|CF NetCDF]] Methode [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typische Werte für diese Anwendung sind:
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF-Datei mit 64Bit, kein HDF - keine Online-Kompression);
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF-Datei ohne Nutzung der erweiterten HDF-Möglichkeiten - mit Online-Kompression).
*# (optional) '''Max_Time_Steps_Per_Record''': maximale Anzahl der Zeitschritte, die beim Schreiben eines Ergebnisdatensatzes mit einem WRITE ausgegeben werden sollen.
*# (optional) '''Create_Missing_Variables''': zusätzliche (virtuelle) Variable erzeugen
*#: 0 = nicht erzeugen (Default);
*#: 1 = erzeugen (für DFlow FM UGRID CF NetCDF).
*# (optional) '''With_Median''': Median (>=2 Werte) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_05_95''': Perzentile Q05, Q95 (>= 11 Werte) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_01_99''': Perzentile Q01, Q99 (>= 51 Werte) berechnen (.true.) oder nicht berechnen (.false.).
* (optional) Block '''Exclude_Variable_From_NCAGGREGATE''': Liste der auszuschließenden Variablen.
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen werden alle vom Programm ermittelten Variablen ausgewertet.
* (optional) Block '''Include_Only_Variable_for_NCAGGREGATE''': Liste der exklusiv zu bearbeitenden Variablen.
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen keine weiteren vom Programm ermittelten Variablen ausgewertet.
* (optional) Block '''Probability_Distribution_Group''': Klassifikation und Liste der Variablen, für welche Häufigkeitsverteilungen erzeugt werden sollen. Block kann mehrfach angegeben werden.
*# '''Bounds_Name''': Name einer Klassifikation in Datei [[BOUNDS.CFG.DAT|bounds.cfg.dat]].
*# '''Variable''': Name einer Variablen aus dem ''Input_Data_File''. Key kann mehrfach angegeben werden. Alle Variablen eines Block müssen über dieselbe physikalische Einheit verfügen. Variable darf nicht via '''Exclude_Variable_From_NCAGGREGATE''' oder '''Include_Only_Variable_for_NCAGGREGATE''' ausgeschlossen sein.
===Anmerkungen===
# Benutzte '''Dictionary-Datei''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncaggregate_dico.dat'''''.
# Wird die Ergebnisdatei ohne Online-Kompression erzeugt, so sollte sie nachträglich mit [https://www.unidata.ucar.edu/software/netcdf/docs/netcdf/nccopy.html NCCOPY] manuell komprimiert werden. Beispiel:
nccopy -k 3 -d 5 <infile> <outfile>
|nutzerprogramme=[[NCAGGREGATE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncaggregate/*/mod_m_ncaggregate_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/ncaggregate/ncaggregate.dat
}}

NCAGGREGATE

2023-05-11T08:55:30Z

Ak3spohr: update version

{{Programmkennblatt
|name_en=NCAGGREGATE
|name=NCAGGREGATE
|version=Mai 2023
|version_beschr=September 2022
|stichworte=Analyse 
Postprocessor 
synoptische Berechnungsergebnisse 
[[Analyse_der_Berechnungsergebnisse#Tidekennwerte|Tidekennwerte]] 
[[Analyse_der_Berechnungsergebnisse#Tideunabh.C3.A4ngige_Kennwerte|Tideunabhängige Kennwerte]] 
Differenzen synoptischer Berechnungsergebnisse 
Differenzen von Tidekennwerten 
Differenzen von tideunabhängigen Kennwerten 
[[NetCDF|CF NetCDF]] Format für 2D-Daten 
aggregierte Daten für Kontroll-Volumina und Austausch-Flächen 
Verfahren für unstrukturierte orthogonale Gitternetze 
Unterstützung von Simulationsergebnissen mit SubGrid 
Parallelisierung mit [http://openmp.org/wp/ OpenMP] 
Unterstützung von DMQS-Metadaten und -Variablen 
[[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(Teil-) Automatisierte Qualitätssicherung (Wertebereich)]] 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatische Berechnung der Chunk-Größen der Ergebnisvariablen für orthogonalen Datenzugriff 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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 NCAGGREGATE eignet sich für verschiedene Fragestellungen, die im Folgenden aufgezählt sind. Für die verschiedenen Anwendungsfälle werden jeweils die nützlichen Programme und die Reihenfolger ihrer Anwendung aufgeführt:
* Aggregation synoptischer Transport-Daten für Kontroll-Volumina mit dem Ziel eine präzisen Bilanzierung von Transporten (Wasser, Salz, etc.): Hinweis: Um eine für INSPECT_CONTROL_VOLUMES geeignete Eingangsdatei zu erhalten, muss die Simulation mindestens mit Salz oder Temperatur durchgeführt werden. Auch wenn man nur an der Hydrodynamik interessiert ist, muss NCAGGREGATE auch die Salz- oder Temperaturgrößen aggregieren. Die Größe des aggregierten synoptischen Wasservolumens wird sonst nicht berechnet. Diese Größe ist aber bei den in INSPECT_CONTROL_VOLUMES durchgeführten Berechnungen erforderlich.
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# NCAGGREGATE,
*# [[INSPECT_CONTROL_VOLUMES]] (Ergebnisse prüfen),
*# [[NCANALYSE]], und
*# [[DISPLAY_CONTROL_VOLUMES]].
* Aggregation synoptischer Daten (Wasserspiegelauslenkung, Strömungsgeschwindigkeit, Salzgehalt, etc.) mit dem Ziel einer Reduktion der Komplexität der Ergebnisse:
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# NCAGGREGATE, und
*# [[NCPLOT]].
* Aggregation von Kennwerten zur Reduktion der Komplexität:
*# [[UNTRIM2007]] oder [[UNTRIM2]],
*# [[NCANALYSE]],
*# [[NCPLOT]] (Kennwerte prüfen),
*# NCAGGREGATE, und
*# [[NCPLOT]].
* Aggregation der Differenz von Kennwerten oder synoptischen Daten zur Reduktion der Komplexität:
*# [[UNTRIM2007]] oder [[UNTRIM2]] (testweise auch für DFlow FM),
*# [[NCANALYSE]] (für Kennwerte),
*# [[NCPLOT]] (Kennwerte prüfen),
*# [[NCDELTA]],
*# [[NCPLOT]] (Differenzen prüfen),
*# NCAGGREGATE, und
*# [[NCPLOT]].
Bei der Aggregation klassischer Daten werden automatisch sogenannte ''Land Binary Masks'' (LBM) ergänzt. LBMs beschreiben die Land-Wasser-Verteilung zum Zeitpunkt der Aggregation auf dem originalen Gitter. LBMs ermöglichen visualisierenden Anwendungen wir [[NCPLOT]] eine optimale Darstellung aggregierter Größen mit sinnvoller Land-Wasser-Verteilung innerhalb jedes Kontrollvolumens.

Optional kann der Anwender gezielt verschiedene Perzentile (0.01, 0.05, 0.50, 0.95 und 0.99) oder Häufigkeitsverteilungen unter Verwendung frei wählbarer Klassen zusätzlich zu den ''üblichen'' aggregierten Daten erzeugen lassen. Man beachte hierzu die Hinweise bei Datei [[NCAGGREGATE.DAT|ncaggregate.dat]].

[[Datei:ncaggregate_patch.png|thumb|'''Bild ''Kontrollvolumina und Exchanges'''.]]

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCAGGREGATE.DAT|ncaggregate.dat]]);
# Datei mit '''Klassifikationen''' von Häufigkeitsverteilungen ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
# '''synoptische Datensätze''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# '''Kontroll-Volumina''' (Dateityp [[IPDS.DAT|ipds.dat]]):
# für eine [[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(teil-) automatisierte Qualitätssicherung]] (Dateityp [[BOUNDS.CFG.DAT|bounds_verify.dat]]).

|ausgabedateien=
# '''Aggregierte Daten''' Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]); zur Struktur des Aggregations-Gitters und dessen Zusammenhang mit dem Berechnungsgitter siehe unter ''[[NetCDF Aggregation f%C3%BCr unstrukturierte Gitter]]''.
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncaggregate.sdr);
# (optional) Datei mit '''Testausgaben''' (Dateityp ncaggregate.trc).
|methode=
Geeignete physikalische Daten werden für Kontroll-Volumina sowie Austauschflächen (''Exchanges'') aggregiert.

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=[[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[UNTRIM2007]], [[UNTRIM2]], [[INSEL2IPDS]]
|postprozessor=[[DAVIT]], [[INSPECT_CONTROL_VOLUMES]], [[NCANALYSE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NCPLOT]], [[NC2TABLE]], [[PLOTPROFILZEIT]],[[PLOTTS]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Vorträge:
** 2014-03-12: [http://ewisa.baw.de/files/09206_tv12_2014_03_12_aggregation_g_lang.pdf ''Aggregation von Daten''].
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
**2020-12-07: [https://izw-campus.baw.de/goto.php?target=cat_1830&client_id=iliasclient ''Aggregation und NCAGGREGATE''].
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncaggregate/'''
}}

NCDELTA

2023-04-12T10:59:05Z

Ak3spohr: update Version

{{Programmkennblatt
|name_en=NCDELTA
|name=NCDELTA
|version=April 2023
|version_beschr=September 2022
|stichworte=Postprozessor 
Differenzen für synoptische Daten (optionale Beschränkung des Zeitraums) 
Differenzen für Kennwerte 
Differenzen für extensive Größen 
Eingangsdaten für Taylor-Diagramm 
Skill nach Murphy (1988) Gleichung 4 
Skill nach Taylor (2001) Gleichungen 4 und 5 
Skill nach Willmott (1981) Index of agreement (d) 
Median, Perzentile (Q01, Q05, Q95, Q99) 
Parallelisierung mit [http://openmp.org/wp/ OpenMP] 
[[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(Teil-) Automatisierte Qualitätssicherung (Wertebereich)]] 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatisches Setzen der WRITE Chunk-Größe 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
optionale Verwendung der ''Message Passing Interface'' (MPI, [https://www.mpi-forum.org/ MPI Forum])

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 berechnet Differenzen für vergleichbare Variablen (primäre Variablenpaare) sowie gegebenenfalls weitere, daraus abgeleitete statistische Daten, und außerdem Eingangsdaten für Taylor-Diagramme (Details siehe [[Differenzen der Berechnungsergebnisse]]). Das Zusammenführen der primären Variablenpaare erfolgt dabei weitestgehend automatisch, kann aber von dem Anwender in Grenzen manuell übersteuert werden (siehe [[NCDELTA.DAT|ncdelta.dat]]). Die primären Differenzen berechnen sich gemäß ''Vergleichsdaten'' '''minus''' ''Referenzdaten''.

Anforderungen an synoptische Daten mit jeweils konstantem Zeitschritt:
# Die Datensätze können eine unterschiedliche ''Anzahl'' von Terminen enthalten, allerdings müssen die zu vergleichenden Zeiträume gleich lang sein. Es können also verschiedene, aber gleich lange Zeiträume miteinander verglichen werden;
# Bei Datensätzen mit konstantem Zeitschritt dürfen sich die Zeitschritte um ein ganzzahliges Vielfaches voneinander unterscheiden.

Anforderungen an zu vergleichende (zeitabhängige) Daten mit variablem Zeitschritt:
# Die Datensätze müssen dieselbe ''Anzahl'' von Terminen enthalten, wobei die Zeiträume selbst verschieden sein dürfen.

Anmerkungen zur räumlichen Lage zu vergleichender Datensätze:
# Datensätze müssen nicht an denselben Positionen vorliegen;
# Die Datensätze müssen sich räumlich zu einem gewissen Grad überlappen;
# Die Koordinaten der Datensätze dürfen in verschiedenen Koordinatensystemen vorliegen, z. B. Gauß-Krüger und UTM;
# Die Daten einer Position werden mit den Daten der jeweils am nächsten liegenden Position verglichen, insofern der Abstand zwischen den Positionen einen maximal zulässigen Abstand (siehe [[NCDELTA.DAT|ncdelta.dat]]) nicht überschreitet.

Anmerkungen zum Vergleich extensiver Größen:
# Bei extensiven Größen wird als Gewicht die relevante Größe der Berechnungszelle berücksichtigt (Fläche, Länge).

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCDELTA.DAT|ncdelta.dat]]);
# '''Referenzdaten''', z. B. Ist-Zustand (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# '''Vergleichsdaten''', z. B. Variante (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# für eine [[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(teil-) automatisierte Qualitätssicherung]] (Dateityp [[BOUNDS.CFG.DAT|bounds_verify.dat]]).

|ausgabedateien=
# '''Ergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncdelta.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncdelta.trc)
|methode=
Das Programm untergliedert sich im Wesentlichen in folgende Abschnitte:
# Lesen, Prüfen und Druckerausgabe der Steuerdaten des Anwenders;
# Metadaten der ''Referenzdaten'' lesen;
# Metadaten der ''Vergleichsdaten'' lesen;
# Metadaten der Referenz- und Vergleichsdaten in programminterne Datenobjekte transferieren;
# Metadaten vergleichen und auf grundlegende Inkonsistenzen (insbesondere Referenzpositionen) überprüfen;
# Klassifizierung der Referenz- und Vergleichsdaten durchführen;
# Primäre Variablenpaare finden: eine Vergleichsvariable hat genau eine Referenzvariable als Partner; aus den zu einem primären Variablenpaar gehörenden Variablen werden später die primären Ergebnisdaten erzeugt;
# Bestimmen der aus den Referenz- und Vergleichsdaten in die Ergebnisdatei zu kopierenden Variablen;
# Ermitteln der für die räumliche Interpolation der Referenzdaten auf die Positionen der Vergleichsdaten erforderlichen Matrizen;
# Erzeugen der Metadaten für die Ergebnisdatei; diese setzen sich i. W. aus den Metadaten der zu kopierenden Variablen, der primären Berechnungsergebnisse, neu zu erzeugenden Koordinatenvariablen (Zeit, Vertikale), sowie zu kopierender oder neu zu erzeugender Gewichts- und weiterer Hilfsvariablen zusammen;
# Kopieren der aus den Eingangsdateien in die Ergebnisdatei zu kopierenden Daten;
# Berechnen aller primären Ergebnisvariablen, (neuer) Zeit- und Vertikalkoordinaten, sowie Gewichte und Hilfsvariablen. Bei primären Ergebnisvariablen werden optional vorhandene Hilfsvariablen mit Modifikator ''status_flag'' im ''standard_name'' berücksichtigt, insofern die Bedeutung ''good'' durch ein Bit (Flag) repräsentiert wird.
# Für die Definition der verschiedenen Skills wird auf nachfolgende Literatur verwiesen:
#* Murphy, Allan H. (1988) "Skill Scores Based on the Mean Square Error and Their Relationship to the Correlation Coefficient". Monthly Weather Review, Dec. 1988, Seiten 2417 - 2424.
#* Taylor, Karl E. (2001) "Summarizing multiple aspects of model performance in a single diagram". Journal of Geophysical Research, Vol 106, No. D7, April 16, 2001, Seiten 7183 - 7192.
#* Willmott, Cort J. (1981) "On the validation of models". Physical Geography, Seiten 184–194.

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. 

Ein Leitfaden zur Erfassung der DMQS-Metadaten steht [[Leitfaden_Metadaten_Küstengewässer|hier]].

|preprozessor=[[DATACONVERT]], [[BOE2NC]], [[NCAGGREGATE]], [[NCANALYSE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCRCATMAT]], [[NetCDF Operators]], [[UNK]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[GEOTIFFRASTERTOOL]], [[NCAUTO]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCPLOT]], [[NCPOLO]], [[NCVIEW2D]], [[NC2TABLE]], [[NETCDFRASTERTOOL]], [[TAYLORTARGETDIAGRAM]]
|programmiersprache=Fortran95
|zus_software= keine
|kontakt_original=G. Lang, S. Spohr
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Vorträge:
** 2015-07-15: [http://ewisa.baw.de/files/12835_tv12_2015_07_15_ncdelta_g_lang.pdf ''NCDELTA - Differenzen neu berechnet''].
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
** 2022-05-30: [https://izw-campus.baw.de/goto.php?target=cat_4308&client_id=iliasclient ''NCDELTA - Berechnung von Differenzen''].
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/ncdelta/'''
}}

NCDELTA.DAT

2023-04-12T10:58:18Z

Ak3spohr: update Version

{{Dateikennblatt
|name_en=NCDELTA.DAT
|dateityp=ncdelta.dat
|version=April 2023
|version_beschr=Oktober 2022
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDELTA]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': Anzahl der Daten in Byte, die für jede Eingangsvariable in einem Analysezyklus (maximal) gelesen, gespeichert und verarbeitet werden sollen. Dieser Wert bezeichnet in etwa den maximalen Memory-Bedarf pro Variable für [[NCDELTA]].
*# '''Max_Distance''': maximaler Abstand in [m] bis zu dem Punkte mit unterschiedlicher Lage verglichen werden.
*# (optional) '''Print_Modus_Classify''': Modus der informativen Druckerausgabe im Programmteil ''Klassifikation'':
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*## '''1''' = Variablen-Klassifizierung der Eingangsdateien in die SDR-Datei schreiben.
*# (optional) '''Print_Modus_Pairs''': Modus der informativen Druckerausgabe im Programmteil ''Primäre Partnervariable'':
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*## '''1''' = nur Testergebnisse der gefundenen Variablen-Paare werden in die SDR-Datei geschrieben;
*## '''2''' = auch Testergebnisse verworfener Kandidaten werden in die SDR-Datei geschrieben.
*# (optional) '''Print_Modus_Define''': Modus der informativen Druckerausgabe im Programmteil ''Definition Berechnungsergebnisse'':
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*## '''1''' = Informationen zu den Metadaten der Ergebnisdaten in die SDR-Datei schreiben.
*# (optional) '''Print_Modus_Compute''': Modus der informativen Druckerausgabe im Programmteil ''Berechnung der Ergebnisse'':
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*## '''1''' = Informationen zu den Ergebnisdaten in die SDR-Datei schreiben.
*# (optional) '''NC_Deflate_Level''': ''deflate level'' (0,1,2,...,9) für die Online-Kompression der Daten beim Schreiben. 0 bedeutet keine Kompression, 9 maximale Kompression
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' der [[NetCDF|CF NetCDF]] Methode [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typische Werte für diese Anwendung sind:
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF-Datei mit 64Bit, kein HDF - keine Online-Kompression);
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF-Datei ohne Nutzung der erweiterten HDF-Möglichkeiten - mit Online-Kompression).
* Block '''Data_Files''': Dateien
*# '''Reference_File''': Datei (NETCDF) mit '''Referenz'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''Variant_File''': Datei (NETCDF) mit '''Varianten'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''Result_File''': Datei (NETCDF) für '''Ergebnis'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# (optional) '''Reference_Period''': Start- und Enddatum der Vergleichsperiode für die Referenz-Daten (nur für synoptische Daten);
*# (optional) '''Variant_Period''': Start- und Enddatum der Vergleichsperiode für die Varianten-Daten (nur für synoptische Daten);
* (optional) Block '''Data_Operations''': Datenoperationen
*# (optional) '''With_Ordinary_Differences''': Gewöhnliche Differenzen (falls möglich) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Taylor_Diagram_Data''': Daten für Taylor-Diagramm (falls möglich) berechnen (.true.) oder nicht berechnen (.false.); inklusive Skill nach Taylor (2001) Gleichungen 4 und 5;
*# (optional) '''With_Median''': Median (>=32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_05_95''': Perzentile Q05, Q95 (>= 32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Percentiles_01_99''': Perzentile Q01, Q99 (>= 51 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# (optional) '''With_Skill_Murphy_1988''': Skill nach Murphy (1988) Gleichung 4;
*# (optional) '''With_Skill_Willmott_1981''': Skill nach Willmott (1981) Index of agreement (d);
*# (optional) '''With_Original_Data''': Kopie der für die Berechnung der gewöhnlichen Differenzen benutzten Eingangsdaten.
* (optional) Block '''Exclude_Variable_From_NCDELTA''': Liste der auszuschließenden Variablen.
*# '''Variant_Variable''': Name einer Variablen aus dem ''Variant-File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen werden alle vom Programm ermittelten primären Variablenpaare ausgewertet.
* (optional) Block '''Include_Only_Variable_for_NCDELTA''': Liste der exklusiv zu bearbeitenden Variablen.
*# '''Variant_Variable''': Name einer Variablen aus dem ''Variant-File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen keine weiteren vom Programm ermittelten primären Variablenpaare ausgewertet.
* (optional) Block '''No_Normal_Vector_Variable''': Die Liste der Variablen, die Normalen-Vektoren sind wird (weitestgehend) automatisch von [[NCDELTA]] erzeugt. Bislang können nicht alle sicher erkannt werden. Mit dieser Liste werden Variablen von der Zugehörigkeit zur Klasse der Normalen-Vektor-Variablen '''''ausgeschlossen''''', falls deren automatische Zurodnung fehlerhaft ist.
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
* (optional) Block '''Normal_Vector_Variable''': Die Liste der Variablen, die Normalen-Vektoren sind wird (weitestgehend) automatisch von [[NCDELTA]] erzeugt. Bislang können nicht alle sicher erkannt werden. Mit dieser Liste werden Variablen in die Zugehörigkeit zur Klasse der Normalen-Vektor-Variablen '''''eingeschlossen''''', falls deren automatische Zurodnung fehlerhaft ist.
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
* (optional) Block '''Label_Relation''': Für den Vergleich ''fraktionierter'' Variable, für die ein Zusammenhang zwischen den einzelnen ''Fraktionen'' (Sediment, Partialtide. usw.) nicht automatisch hergestellt werden kann, muss der Zusammenhang vom Anwender vorgegeben werden. Block kann mehrfach angegeben werden.
*# '''Variant_Label_KV''': Name einer Label-Koordinatenvariable aus ''Variant_File'' oder ''NONE''.
*# '''Reference_Label_KV''': Name einer Label-Koordinatenvariable aus ''Reference_File'' oder ''NONE''.
*# '''Relation''': ''Name der ''Fraktion'' im Variant_File'' ''':''' ''Name der ''Fraktion'' im Reference_File''. Key kann mehrfach angegeben werden. Für den Namen ist ''NONE'' anzugeben, falls keine entsprechende Label-Koordinatenvariable vorhanden ist. Der Doppelpunkt dient als Trennzeichen.

===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncdelta_dico.dat'''''.
# Anwendungsmöglichkeiten:
#* Fall 1: '''Reference_File''' = Simulation 1, '''Variant_File''' = Simulation 2;
#* Fall 2: '''Reference_File''' = Messung, '''Variant_File''' = Simulation;
#* Fall 3: '''Reference_File''' = Messung 1, '''Variant_File''' = Messung 2;
#: Es können entweder jeweils synoptische Daten ''oder'' Ergebnisse des Programms [[NCANALYSE]] verwendet werden.
# Allgemeine Anforderungen:
#* synoptische Daten:
#** Zeitraum muss gleich lang (nicht identisch) sein, und
#** Zeitschritt muss identisch sein.
#* Analyseergebnisse ([[NCANALYSE]]):
#** Analysezeitraum muss von vergleichbarer Länge sein, und
#** Anzahl der Ereignisse, z.B. Thw, muss identisch sein.
#* Z-Koordinatenvariablen:
#: z-Koordinaten-Variablen müssen, soweit vorhanden, entweder
#:* alle mit (CF-Attribut) positive = "down", oder
#:* alle mit (CF-Attribut) positive = "up"
#: vorliegen (siehe [http://cfconventions.org/ CF Metadaten Konvention]).
# Spezielle Anforderungen:
#* zu Fall 1:
#** gleiche Vertikalstruktur (Anzahl der Schichten), und
#** gleiche (Tracer-) Fraktionen (falls vorhanden).
#* zu Fall 2:
#** gleiche (Tracer-) Fraktionen (falls vorhanden), und
#** in den Messdaten dürfen an derselben (Geo-) Position (x,y) mehrere Messergebnisse in verschiedenen Tiefen (z) vorhanden sein. Außerdem muss
#** für Vergleiche mit gemessener Strömung das Attribut "name_id" der Variable "current_velocity" den Wert 836 aufweisen. Diese Voraussetzung sollte überprüft werden (z.B. mit ncdump). Falls diese Bedingung nicht erfüllt wird, so kann mit Hilfe des NCO-Tools NCATTED '''ncatted -a name_id,current_velocity,m,i,836 -O ''reference_file''.nc''' der Wert des Attributs auf 836 abgewandelt werden.
#* zu Fall 3:
#** (Geo-) Positionen (x,y) dürfen in jeder Datei jeweils nur einmal vorhanden sein; d.h., mehrere an einem Ort übereinander angeordnete Messergebnisse (verschiedene Tiefen (z) bei identischem (x,y)) werden von der aktuellen Version nicht unterstützt.

|nutzerprogramme=[[NCDELTA]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncdelta/*/mod_m_ncdelta_steer.f90
|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]
|beispieldatei=$PROGHOME/examples/ncdelta/ncdelta.dat
}}

NCANALYSE.DAT

2023-03-29T13:15:35Z

Ak3spohr: update Version

{{Dateikennblatt
|name_en=NCANALYSE.DAT
|dateityp=ncanalyse.dat
|version=März 2023
|version_beschr=Oktober 2021
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCANALYSE]]
|dateiinhalt=
'''Eingabesteuerdaten'''

* Block '''Program_Parameters''': Allgemeine Steuerdaten
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Analysezyklus gelesen, gespeichert und verarbeitet werden können.
*# '''Min_Water_Depth''': minimale Wasserbedeckung bis zu der Analysen durchgeführt werden.
*# (optional) '''Create_Missing_Variables''': zusätzliche (virtuelle) Variable erzeugen
*#: 0 = nicht erzeugen (Default);
*#: 1 = erzeugen (derzeit nur "magnitude_of_sea_water_velocity" für DFlow FM UGRID CF NetCDF).
*# (optional) '''NC_Deflate_Level''': Niveau (0 bis 9) der Online-Kompression beim Schreiben der Ergebnisdatei
*#: 0 = keine Kompression (Default);
*#: 5 = gute Kompression (Empfehlung);
*#: 9 = höchste Stufe der Kompression.
*# (optional) '''FRQ_use_j_v_correction''': Korrektur der Nodaltide bei der Berechnung der Partialtiden
*#: .true. = Einfluss der Nodaltide korrigieren (Default)
*#: .false. = Einfluss der Nodaltide ''nicht'' korrigieren
*# (optional) '''END_after_hrp''': Beende den Programmlauf unmittelbar im Anschluss an die Analyse für die Referenzpositionen, vor dem Beginn der (eigentlichen) flächenhaften Analyse
*#: .true. = Programmlauf vorzeitig beenden
*#: .false. = Programmlauf vollständig durchführen (Default)
*# (optional) '''CU_Zero_Slack''': Grenzwert für Strömungsgeschwindigkeit in [m s-1] unterhalb der ein Richtungswechsel der Strömung (Kenterung) nicht ausgewertet wird. Typischer Weise werden Werte von 1 cm s-1 verwendet (diese sind in den Konfigurationsdateien für die verschiedenen Analysen voreingestellt). Als Kenterung wird eine Situation erkannt, falls die Geschwindigkeit größer als der Grenzwert ist und ein Richtungswechsel stattgefunden hat.
*# (optional) '''Compute_FE_Ratio''': Berechne Flut(strom):Ebbe(strom) Kenngrößen, falls solche mit <OPT:COMPUTE_FE_RATIO> in der Konfigurationsdatei markiert sind
*#: .true. = F:E-Kenngrößen berechnen
*#: .false. = F:E-Kenngrößen nicht berechnen (Default)
*# (optional) '''CFG_Level''': Einige Konfigurationsdateien enthalten Anweisungen der Art <OPT:CFG_Level_''number''> zur flexiblen Verwendung derselben Konfigurationsdatei für verschiedene Fragestellungen.
*#: 0 = aktiviere Zeilen mit <OPT:CFG_Level_0> (Default)
*#: 1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
*# (optional) '''Location_XY_EPSG''': EPSG-Code der in den Blöcken '''Location''' angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block '''Input_Files''') verwendet.
*# (optional) '''Gap_Fill''': Steuerparameter für das Auffüllen von Datenlücken an Referenzpositionen durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
*#: 0 = Datenlücken werden nicht aufgefüllt (Default)
*#: 1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
* Block '''Data_Analysis_Period''': Analysezeitraum
*# '''Start_Time''': Beginn des Analysezeitraums.
*# '''End_Time''': Ende des Analysezeitraums.
* Block '''Input_Files''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Data_File''': Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]). Optional kann als dritter Parameter auch noch angegeben werden, ob die Datei mit MPI COLLECTIVE I/O oder MPI INDEPENDENT I/O gelesen werden soll (relevant nur für die MPI-Version des Programms).
* Block '''Location''': Referenzpositionen (je Position ein Block).
*# '''Name''': Name der Referenzposition.
*# '''Type''': Typ der Referenzposition:
*#* 0 = Referenzposition Tide (muss einmal angegeben werden);
*#* 1 = Referenzposition Phase (muss einmal angegeben werden);
*#* 2 = Hilfsposition (kann angegeben werden).
*# '''X''': x-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Y''': y-Koordinate der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LON''': geografische Länge der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''LAT''': geografische Breite der Position (entweder '''X''' und '''Y''' oder '''LON''' und '''LAT''' angeben).
*# '''Z''': z-Koordinate der Position (nach Unten positiv).
*# '''Rank''': ''Rang'' der Position (nicht für ''Referenzposition Phase'').
*# '''Previous_Rank''': Verweis auf den ''Rang'' der vorangehenden Position (nicht für ''Referenzposition Tide'' und ''Referenzposition Phase'').
* Block '''Input_Variables''': Name(n) der zu analysierenden Variablen.
*# '''Name''': Name der zu analysierenden Variable (ist ein gültiger [[NetCDF|CF NetCDF]] Variablenname der Datei mit den Eingangsdaten).
* Block '''Data_Analysis''': Art der Analyse sowie [[NetCDF|CF NetCDF]] Datei für Analyseergebnisse
*# '''Type''': Typ der durchzuführenden Analyse:
*#* '''TDKW''' = [[Tidekennwerte des Wasserstandes]];
*#* '''TDKV''' = [[Tidekennwerte der Strömung]];
*#* '''TDXF''' = [[Tidekennwerte des Wassertransports]];
*#* '''TDKS''', '''TDWS'''= [[Tidekennwerte des Salzgehalts]];
*#* '''TDXS''' = [[Tidekennwerte des Salztransports]];
*#* '''TDKT''' = [[Tidekennwerte der Temperatur]];
*#* '''TDXT''' = [[Tidekennwerte des Wärmetransports]];
*#* '''TDKC''' = [[Tidekennwerte des Schwebstoffgehalts]];
*#* '''TDXC''' = [[Tidekennwerte des Schwebstofftransports]];
*#* '''TDKP''' = [[Tidekennwerte des Tracergehalts]];
*#* '''TDXP''' = [[Tidekennwerte des Tracertransports]];
*#* '''TDKB''' = [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*#* '''TDKG''' = [[Tidekennwerte des Geschiebetransports]];
*#* '''TDKA''' = [[Tidekennwerte der Anomalie der Potentiellen Energie]];
*#* '''FRQW''' = [[Harmonische Analyse des Wasserstands|Harmonische Analyse des Wasserstands (Partialtiden)]];
*#* '''FRQV''' = [[Harmonische Analyse der Strömung|Harmonische Analyse der Strömung (Partialtiden)]];
*#* '''LZKW''' = [[Tideunabhängige Kennwerte des Wasserstands]];
*#* '''LZKV''' = [[Tideunabhängige Kennwerte der Strömung]];
*#* '''LZKS''' = [[Tideunabhängige Kennwerte des Salzgehalts]];
*#* '''LZKT''' = [[Tideunabhängige Kennwerte der Temperatur]];
*#* '''LZKC''' = [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
*#* '''LZKP''' = [[Tideunabhängige Kennwerte des Tracergehalts]];
*#* '''LZKO''' = [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
*#* '''LZKM''' = [[Tideunabhängige Kennwerte der Morphodynamik]];
*#* '''LZKG''' = [[Tideunabhängige Kennwerte des Geschiebetransports]];
*#* '''LZKB''' = [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*#* '''LZKA''' = [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
*#* '''LZXF''' = [[Tideunabhängige Kennwerte des Wassertransports]];
*#* '''LZXS''' = [[Tideunabhängige Kennwerte des Salztransports]];
*#* '''LZXP''' = [[Tideunabhängige Kennwerte des Tracertransports]];
*#* '''LZXC''' = [[Tideunabhängige Kennwerte des Schwebstofftransports]];
*#* '''LZXG''' = [[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle);
*#* '''LZXE''' = [[Tideunabhängige Kennwerte des Tide-Energietransports]];
*#* '''LZMW''' = [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
*#* '''LZSS''' = [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
*# '''Result_File''': Name und Typ (NETCDF) der Datei für die Analyseergebnisse (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).
* '''Optionale Blöcke''' für verschiedene Analysen
** Optional für '''TDKW''':
*** Block '''TDKW_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKV''':
*** Block '''TDKV_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKS''' oder '''TDWS'''
*** Block '''TDKS_Quantiles''' oder '''TDWS_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKT''':
*** Block '''TDKT_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKC''':
*** Block '''TDKC_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKP''':
*** Block '''TDKP_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKG''':
*** Block '''TDKG_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKB''':
*** Block '''TDKB_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKA''':
*** Block '''TDKA_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''FRQW''' und '''FRQV''':
*** Block '''Tidal_Constituents''': Liste der zu berechnenden Partialtiden.
***# '''Value''': Code der Partialtide, z. B. Mm, Mf, K_1, O_1, S_2, M_2, M_4, M_6, M_8.
* '''Optional erforderliche Blöcke''' für verschiedene Analysen
*: Um die ''Bounds'', also die jeweiligen Intervallgrenzen für die Häufigkeitsverteilung optimal angeben zu können, sollte vorab der Wertebereich der physikalischen Größe ermittelt werden, z. B. mit dem Programm [[NCAUTO]].
** Erforderlich für '''LZKW''':
*** Block '''Water_Level_Bounds''': Definition der Wasserstandsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Water_Level_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKV''':
*** Block '''Current_Velocity_Bounds''': Definition der Strömungsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Current_Velocity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKS''':
*** Block '''Salinity_Bounds''': Definition der Salzgehaltsklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Salinity_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKT''':
*** Block '''Temperature_Bounds''': Definition der Temperaturklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Temperature_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKC''':
*** Block '''Suspended_Sediment_Bounds''': Definition der Klassen für den Schwebstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Suspended_Sediment_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKP''':
*** Block '''Tracer_Bounds''': Definition der Klassen für den Tracergehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Tracer_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKO''':
*** Block '''Oxygen_Bounds''': Definition der Klassen für den Sauerstoffgehalt.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Oxygen_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKM''':
*** Block '''Bathymetry_Bounds''': Definition der Sohltiefenklassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bathymetry_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKG''':
*** Block '''Bedload_Bounds''': Definition der Geschiebetransport-Klassen.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedload_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKB''':
*** Block '''Bedfriction_Bounds''': Definition der Klassen für die eff. Bodenschubspannung.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedfriction_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKA''':
*** Block '''PE_Anomaly_Bounds''': Definition der Klassen für die PEA.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''PE_Anomaly_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZMW''':
*** Block '''Wind_Bounds''': Definition der Klassen für die Windgeschwindigkeit.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Wind_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZSS''':
*** Block '''Sig_Wave_Bounds''': Definition der Klassen für die signifikante Wellenhöhe.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Sig_Wave_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
===Anmerkungen===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncanalyse_dico.dat''''' und
#* '''''ncanalyse_config_dico.dat'''''.
# Benutzte '''Standard-Konfigurationsdateien''' aus dem Verzeichnis '''''$PROGHOME/cfg/''''':
#* '''TDKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wasserstandes]];
#* '''TDKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Strömung]];
#* '''TDXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wassertransports]];
#* '''TDKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salzgehalts]];
#* '''TDXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Salztransports]];
#* '''TDKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Temperatur]];
#* '''TDXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Wärmetransports]];
#* '''TDKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstoffgehalts]];
#* '''TDXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Schwebstofftransports]];
#* '''TDKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracergehalts]];
#* '''TDXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Tracertransports]];
#* '''TDKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
#* '''TDKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Geschiebetransports]];
#* '''TDKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Anomalie der Potentiellen Energie]];
#* '''FRQW_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse des Wasserstands|Partialtiden des Wasserstands]];
#* '''FRQV_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse der Strömung|Partialtiden der Strömung]];
#* '''LZKW_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wasserstands]];
#* '''LZKV_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Strömung]];
#* '''LZKS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salzgehalts]];
#* '''LZKT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Temperatur]];
#* '''LZKC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
#* '''LZKP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracergehalts]];
#* '''LZKO_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
#* '''LZKM_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Morphodynamik]];
#* '''LZKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Geschiebetransports]];
#* '''LZKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
#* '''LZKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
#* '''LZXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wassertransports]];
#* '''LZXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salztransports]];
#* '''LZXT_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wärmetransports]];
#* '''LZXP_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tracertransports]];
#* '''LZXC_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Schwebstofftransports]];
#* '''LZXG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Sedimenttransports]];
#* '''LZXE_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Tide-Energietransports]];
#* '''LZMW_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]];
#* '''LZSS_ncanalyse_cfg.dat''': Datei mit Definition der [[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]].
|nutzerprogramme=[[NCANALYSE]]
|programmiersprache=Fortran90
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor
|lesemodule=$PROGHOME/fortran/prg/ncanalyse/*/mod_m_ncanalyse_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/ncanalyse/ncanalyse.dat
}}

NCANALYSE

2023-03-29T13:10:40Z

Ak3spohr: update Version

{{Programmkennblatt
|name_en=NCANALYSE
|name=NCANALYSE
|version=März 2023
|version_beschr=September 2022
|stichworte=Analyse 
Postprocessor 
synoptische Berechnungsergebnisse 
Zeitserien gemessener Daten (optional mit weiter qualifizierenden [http://cfconventions.org/Data/cf-conventions/cf-conventions-1.6/build/cf-conventions.html#flags Flag Variablen]) 
tiefengemittelte (2D) und tiefenstrukturierte Daten (3D) mit z-Schichten 
[[Tidekennwerte des Wasserstandes]] 
[[Tidekennwerte der Strömung]], [[Tidekennwerte des Wassertransports]] 
[[Tidekennwerte des Salzgehalts]], [[Tidekennwerte des Salztransports]] 
[[Tidekennwerte der Temperatur]], [[Tidekennwerte des Wärmetransports]] 
[[Tidekennwerte des Schwebstoffgehalts]], [[Tidekennwerte des Schwebstofftransports]] 
[[Tidekennwerte des Tracergehalts]], [[Tidekennwerte des Tracertransports]] 
[[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]] 
[[Tidekennwerte des Geschiebetransports]] 
[[Tidekennwerte der Anomalie der Potentiellen Energie]] 
[[Harmonische Analyse des Wasserstands]] 
[[Harmonische Analyse der Strömung]] 
[[Tideunabhängige Kennwerte des Wasserstands]] 
[[Tideunabhängige Kennwerte der Strömung]] 
[[Tideunabhängige Kennwerte des Salzgehalts]] 
[[Tideunabhängige Kennwerte der Temperatur]] 
[[Tideunabhängige Kennwerte des Schwebstoffgehalts]] 
[[Tideunabhängige Kennwerte des Tracergehalts]] 
[[Tideunabhängige Kennwerte des Sauerstoffgehalts]] 
[[Tideunabhängige Kennwerte der Morphodynamik]] 
[[Tideunabhängige Kennwerte des Geschiebetransports]] 
[[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]] 
[[Tideunabhängige Kennwerte des Wassertransports]] 
[[Tideunabhängige Kennwerte des Salztransports]] 
[[Tideunabhängige Kennwerte des Wärmetransports]] 
[[Tideunabhängige Kennwerte des Tracertransports]] 
[[Tideunabhängige Kennwerte des Schwebstofftransports]] 
[[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle) 
[[Tideunabhängige Kennwerte des Tide-Energietransports]] 
[[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]] 
[[Kennwerte meteorologischer Größen|Kennwerte meteorologischer Größen (Windgeschwindigkeit)]] 
[[Kennwerte des Seegangs|Kennwerte des Seegangs (signifikante Wellenhöhe)]] 
[[NetCDF|CF NetCDF]] Format für 2D-/3D-Daten 
Verfahren für unstrukturierte orthogonale Gitternetze 
Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen 
Verfahren für Daten an Einzelpositionen (''Discrete Sampling Geometry'' featureType = '''timeSeriesProfile''') 
Verfahren für Daten auf Profilen (''Discrete Sampling Geometry'' featureType = '''trajectoryProfile''') 
Parallelisierung mit [http://openmp.org/wp/ OpenMP] und [http://de.wikipedia.org/wiki/Message_Passing_Interface MPI] 
[[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(Teil-) Automatisierte Qualitätssicherung (Wertebereich)]] 
Automatische Anpassung der READ-Daten-Portionen an Chunk-Größe 
Automatisches Setzen der WRITE Chunk-Größe 
Ablage des Inhalts der ASCII-Eingabesteuerdateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Ablage der [https://de.wikipedia.org/wiki/Message-Digest_Algorithm_5 MD5-Hash]-Werte von Eingabedateien in [[CF-NETCDF.NC|netcdf.nc]] (als Variable) 
Optionales Schließen von Datenlücken an Referenz-Positionen durch Interpolation 

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 NCANALYSE dient zur Analyse von in CF NetCDF Dateien gespeicherten synoptischen Daten.

|eingabedateien=
# '''allgemeine Eingabedaten''' (Dateityp [[NCANALYSE.DAT|ncanalyse.dat]]);
# '''synoptische Datensätze''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
# für eine [[NetCDF#Qualitätssicherung mit NetCDF-Attributen|(teil-) automatisierte Qualitätssicherung]] (Dateityp [[BOUNDS.CFG.DAT|bounds_verify.dat]]).

|ausgabedateien=
# '''Analyseergebnisse''' Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
# (optional) Datei mit '''Informationen zum Programmablauf''' (Dateityp ncanalyse.sdr)
# (optional) Datei mit '''Testausgaben''' (Dateityp ncplot.trc)
|methode=
Folgende Analysen stehen zur Verfügung:
* Tidekennwerte:
*# [[Tidekennwerte des Wasserstandes]];
*# [[Tidekennwerte der Strömung]];
*# [[Tidekennwerte des Salzgehalts]];
*# [[Tidekennwerte der Temperatur]];
*# [[Tidekennwerte des Schwebstoffgehalts]];
*# [[Tidekennwerte des Tracergehalts]];
*# [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*# [[Tidekennwerte des Geschiebetransports]];
*# [[Tidekennwerte der Anomalie der Potentiellen Energie]].
* Tide-Transport-Kennwerte (basierend auf ''exakten'' Integralen):
*# [[Tidekennwerte des Wassertransports]];
*# [[Tidekennwerte des Salztransports]];
*# [[Tidekennwerte des Wärmetransports]];
*# [[Tidekennwerte des Schwebstofftransports]];
*# [[Tidekennwerte des Tracertransports]].
* Harmonische Analyse:
*# [[Harmonische Analyse des Wasserstands]];
*# [[Harmonische Analyse der Strömung]].
* Tideunabhängige Kennwerte:
*# [[Tideunabhängige Kennwerte des Wasserstands]];
*# [[Tideunabhängige Kennwerte der Strömung]];
*# [[Tideunabhängige Kennwerte des Salzgehalts]];
*# [[Tideunabhängige Kennwerte der Temperatur]];
*# [[Tideunabhängige Kennwerte des Schwebstoffgehalts]];
*# [[Tideunabhängige Kennwerte des Tracergehalts]];
*# [[Tideunabhängige Kennwerte des Sauerstoffgehalts]];
*# [[Tideunabhängige Kennwerte der Morphodynamik]];
*# [[Tideunabhängige Kennwerte des Geschiebetransports]];
*# [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*# [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]].
* Tideunabhängige Transport-Kennwerte (basierend auf ''exakten'' Integralen):
*# [[Tideunabhängige Kennwerte des Wassertransports]];
*# [[Tideunabhängige Kennwerte des Salztransports]];
*# [[Tideunabhängige Kennwerte des Wärmetransports]];
*# [[Tideunabhängige Kennwerte des Tracertransports]];
*# [[Tideunabhängige Kennwerte des Schwebstofftransports]];
*# [[Tideunabhängige Kennwerte des Sedimenttransports]] (Geschiebe, Schwebstoff - Sohle).
* Tide-Energietransport:
*# [[Tideunabhängige Kennwerte des Tide-Energietransports]].
* Kennwerte meteorologischer Größen:
*# [[Kennwerte meteorologischer Größen|Windgeschwindigkeit]]. 
* Kennwerte des Seegangs:
*# [[Kennwerte des Seegangs|signifikante Wellenhöhe]]. 

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. 

Ein Leitfaden zur Erfassung der DMQS-Metadaten steht [[Leitfaden_Metadaten_Küstengewässer|hier]].

|preprozessor=[[DATACONVERT]], [[BOE2NC]], [[GRIDCONVERT]], [[NCAGGREGATE]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDVAR]], [[NCMERGE]], [[NetCDF Operators]], [[QUICKPLOT]], [[UNTRIM2007]], [[UNTRIM2]]
|postprozessor=[[DAVIT]], [[DISPLAY_CONTROL_VOLUMES]], [[GEOTIFFRASTERTOOL]], [[NCAGGREGATE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCCUTOUT]], [[NCDELTA]], [[NCDVAR]], [[NCPLOT]], [[NC2TABLE]], [[NETCDFRASTERTOOL]], [[PLOTPROFILZEIT]],[[PLOTTS]]
|programmiersprache=Fortran95
|zus_software= ---
|kontakt_original=G. Lang
|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
|dokumentation=
* Vorträge
** 2021-06-16: [http://doi.org/10.13140/RG.2.2.20390.45120 ''Tidal Asymmetry - Classical Parameters vs Skewness''] (DOI: [http://doi.org/10.13140/RG.2.2.20390.45120 http://doi.org/10.13140/RG.2.2.20390.45120]);
** 2015-05-29: [http://ewisa.baw.de/files/12556_tv12_2015_05_29_tide_energie_transport_g_lang.pdf ''Tidewelle und Energietransport''] (DOI: [http://dx.doi.org/10.13140/RG.2.2.31352.14089 http://dx.doi.org/10.13140/RG.2.2.31352.14089]).
** 2014-12-03: [http://ewisa.baw.de/files/11284_tv12_2014_12_03_ncanalyse_lzks_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Salzgehalts''];
** 2014-12-03: [http://ewisa.baw.de/files/11285_tv12_2014_12_03_ncanalyse_tdks_g_lang.pdf ''NCANALYSE - Tidekennwerte des Salzgehalts''];
** 2014-10-08: [http://ewisa.baw.de/files/10587_tv12_2014_10_08_ncanalyse_lzkv_g_lang.pdf ''NCANALYSE - Tideunabhängige Kennwerte der Strömung''];
** 2014-09-10: [http://ewisa.baw.de/files/10588_tv12_2014_09_10_allgemein_g_lang.pdf ''NCANALYSE - Tidekennwerte der Strömung''];
** 2013-08-07: [http://ewisa.baw.de/files/08510_speech_2013-08-07.pdf ''NCANALYSE - Tideunabhängige Kennwerte des Wasserstands''];
** 2013-05-15: [http://ewisa.baw.de/files/08500_speech_2013-05-15.pdf ''NCANALYSE - Daten aus CF netCDF Dateien analysieren''].
* [https://izw-campus.baw.de/ ''IZW-Campus''] (Podcast)
** 2022-04-25: [https://izw-campus.baw.de/goto.php?target=cat_4105&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse LZKW (tideunabhängige Kennwerte des Wasserstands)''];
** 2022-03-21: [https://izw-campus.baw.de/goto.php?target=cat_3829&client_id=iliasclient ''Energietransport einer Tidewelle''];
** 2021-11-29: [https://izw-campus.baw.de/goto.php?target=cat_3490&client_id=iliasclient ''NCANALYSE - Grundlagen - Wechselwirkung zwischen Salzgehalt und Schwebstoffgehalt''];
** 2021-10-18: [https://izw-campus.baw.de/goto.php?target=cat_3301&client_id=iliasclient ''NCANALYSE - Grundlagen verschiedener Kennwerte (Einfluss des Salzgehalts auf verschiedene Kenngrößen)''];
** 2021-09-13: [https://izw-campus.baw.de/goto.php?target=cat_3102&client_id=iliasclient ''NCANALYSE - Grundlagen TDKA (Tidekennwerte der Anomalie der Potentiellen Energie)''];
** 2021-08-09: [https://izw-campus.baw.de/goto.php?target=cat_1830&client_id=iliasclient ''NCANALYSE - Grundlagen TDKS (Tidekennwerte des Salzgehalts)''];
** 2021-06-07: [https://izw-campus.baw.de/goto.php?target=cat_2554&client_id=iliasclient ''NCANALYSE Update zu Skewness - aus Partialtiden des Wasserstands und der Strömung''];
** 2021-04-19: [https://izw-campus.baw.de/goto.php?target=cat_2329&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQV (Harmonische Analyse der Strömung)''];
** 2021-03-08: [https://izw-campus.baw.de/goto.php?target=cat_2224&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse FRQW (Harmonische Analyse des Wasserstands)''];
** 2021-02-08: [https://izw-campus.baw.de/goto.php?target=cat_1940&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKV (Tidekennwerte der Strömungsgeschwindigkeit)''];
** 2021-01-11: [https://izw-campus.baw.de/goto.php?target=cat_1853&client_id=iliasclient ''NCANALYSE - Grundlagen am Beispiel der Analyse TDKW (Tidekennwerte des Wasserstands)''];
* Musterdatei
** Musterdateien finden sich in '''$PROGHOME/examples/ncanalyse/'''
}}

Strukturübersicht

2023-01-03T13:40:12Z

Ak3spohr: Link zu test-Vorlage entfernt

[[en:Overview]]
* [[Hauptseite]]
** [[Bautechnische Methoden]]
** [[Geotechnische Methoden]]
** [[Wasserbauliche Methoden]]
*** [[Mathematische Verfahren]]
**** [[Simulationsverfahren]]
***** [[Modellverfahren für den Küstenbereich und Ästuare]]
***** [[Modellverfahren für den Binnenbereich]]
****** [[Hydrodynamische Modellverfahren]]
****** [[Morphodynamische Modellverfahren - Feststofftransportmodelle]]
****** [[Wasserbauwerksmodelle]]
****** [[Fahrdynamische Modellverfahren]]
******* [[Programm "TRASSE"]]
******* [[Programm "PeTra"]]
**** [[Pre- und Postprocessing]]
***** [[Erzeugung und Bearbeitung von Gitternetzen]]
***** [[Erzeugung von Randwerten]]
****** [[Erzeugung von Randwerten#Literatur zu methodischen Ansätzen|Literatur zu methodischen Ansätzen]]
****** [[Erzeugung von Randwerten#Graphische Darstellungen komplexer Arbeitsvorgänge| Erzeugen von Randwertzeitreihen aus Mess- und Simulationsergebnissen (Grafik)]]
***** [[Umwandeln von Berechnungsergebnissen]]
***** [[Analyse der Berechnungsergebnisse]]
***** [[Differenzen der Berechnungsergebnisse]]
***** [[Immersive Visualisierung]]
***** [[Tools für wasserbauliches Ingenieurwesen]]
***** [[Datenmanagement und Informationssysteme]]
**** [[BAW-Software-Dokumentation]]
***** [[Programmkennblätter]]
***** [[Dateikennblätter]]
***** [[Standard-Software-Anwendungen (Add-ons)]]
****** [[ArcGIS-Anwendungen]]
****** [[EXCEL-Anwendungen]]
****** [[Mathematica]]
****** [[MATLAB]]
****** [[OpenMI]]
****** [[NetCDF]]
****** [[NetCDF Operators]]
****** [[Climate Data Operators]]
**** [[Validierungsstudien]]
***** [[Validierungsstudien Jade-Weser]]
**** [[Modellsysteme]]
*** [[Wasserbauliches Versuchswesen]]
**** [[Schiffserzeugte Belastungen]]
***** [[Definition der Kenngrößen]]
***** [[Funktionelle Abhängigkeiten]]
***** [[Analytische und empirische Ansätze]]
***** [[Hydrodynamisch-numerische Methoden]]
**** [[Schiffsdynamik]]
***** [[Einfluss von Schiffslänge und Kielfreiheit auf Squat und Trimm sehr großer Containerschiffe]]
***** [[Dynamisches Fahrverhalten sehr großer Containerschiffe bei Fahrt über Transportkörperstrecken]]
*** [[Naturmessungen]]
**** [[Küste und Ästuare]]
***** [[Messprogramm Nördlicher Peenestrom 2005]]
***** [[Ankerzugversuche 2013]]
***** [[Pre- und Postprozessierung]]
****** [[Postprocessing von GNSS-Rohdaten]]
***** [[Standardsoftware und Anwendungen (Add-ons)]]
****** [[MATLAB-ViSea]]
****** [[ADCP-NetCDF]]
***** [[Software Naturmessungen]]
*** [[Schiffsführungssimulation]]
**** [[Qualitätssicherung für Schiffsführungssimulation in der WSV]]
**** [[Strömungsdaten für Schiffsführungssimulation in der WSV]]
*** [[Tidedynamik der Ästuare]]
*** [[Ökologische Durchgängigkeit]]
**** [[Ökologische Durchgängigkeit - Aufgabenstellung]]
**** [[Ökologische Durchgängigkeit - Pilotanlagen]]
**** [[Ökologische Durchgängigkeit - FuE-Projekte]]
**** [[Internationale Richtlinien für Fischaufstiegsanlagen]]
***** [[Überblick über internationale Richtlinien für Fischaufstiegsanlagen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Australien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Deutschland]]
****** [[Richtlinien zu Fischaufstiegsanlagen China]]
****** [[Richtlinien zu Fischaufstiegsanlagen Finnland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Frankreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Großbritannien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Irland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Italien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Kanada]]
****** [[Richtlinien zu Fischaufstiegsanlagen Neuseeland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Niederlande]]
****** [[Richtlinien zu Fischaufstiegsanlagen Norwegen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Österreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Russische Föderation]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schottland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schweiz]]
****** [[Richtlinien zu Fischaufstiegsanlagen Tschechische Republik]]
****** [[Richtlinien zu Fischaufstiegsanlagen Türkei]]
****** [[Richtlinien zu Fischaufstiegsanlagen USA ]]
****** [[Richtlinien zu Fischaufstiegsanlagen ESHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen IHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen Vereinte Nationen]]]
****** [[Richtlinien zu Fischaufstiegsanlagen WCD]]
***** [[Richtlinienauswertung nach ausgewählten Themen]]
***** [[Empfehlungen zu Schlitzpässen]]
***** [[Grenz- oder Bemessungswerte für Schlitzpässe]]
**** [[Literaturstudie Sonderbauweisen von Fischaufstiegsanlagen]]
***** [[Baustein 1: Literatur]]
***** [[Baustein 2: Fischlifte]]
***** [[Baustein 3: Fischschleusen]]
***** [[Präsentation_Literaturstudie]]
----
* [[Template:Programmkennblatt]]
* [[Template:Dateikennblatt]]
* [[Template:Dokumentsteckbrief]]
* [[Template:Glossareintrag]]
----
* [[ToDo:ProgHome]]
----

NCPLOT.DAT

2023-01-03T12:58:04Z

Ak3spohr:

{{Dateikennblatt
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=November 2022
|version_beschr=November 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.
* (optional) Key '''"Axis_Font_Size" :''' Schriftgröße für 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
:*'''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_Color_Name" :''' Farben des Legendenfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Frame_Style" :''' Aussehen der Legendenfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Legend_Box_Font_Size" :''' Schriftgröße für Legendenfeld.
* (optional) Key '''"MaxCharNumber_LegendEntry" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.
* (optional) Key '''"Legend_Box_Orientation" :''' Anordnung der Legendeneinträge.
* (optional) Key '''"Legend_Box_HIDE_List" :''' Legenden-Einträge dieser Liste werden NICHT gezeigt.
* (optional) Key '''"Legend_Box_SHOW_List" :''' NUR die Legenden-Einträge dieser Liste werden gezeigt.

===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.
:Platzhalter für Textbox, die mit einem DataRow-Block verbunden ist:
:*<ROW_T_DROW>, <ROW_F_DROW> wird durch Kennung des DataRow-Blocks ersetzt.
:*<ROW_T_DSET>, <ROW_F_DSET> wird durch Kennung des mit dem DataRow-Block verknüpften Datasets ersetzt.
:*<ROW_T_DIM1>, <ROW_F_DIM1> wird durch Infotext zu 1. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM2>, <ROW_F_DIM2> wird durch Infotext zu 2. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM?>, <ROW_F_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im DataRow-Block per KEY ''DataRow_Linked_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.
* (optional) Key '''"MaxCharNumber_TextLine" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.

===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
}}

Vorlage:Dateikennblatt

2023-01-03T12:22:13Z

Ak3spohr: Abschnitt 'Weitere Informationen' gelöscht

__NOAUTOLINKS__
__NOAUTOLINKTARGET__
[[Kategorie:Dateibeschreibung]]
[[en:{{{name_en}}}]]
==Basisinformationen==
===Datei-Typ===
{{{dateityp}}}
===Datei-Form===
{{{dateiform}}}
===Version===
{{{version}}}
===Beschreibung===
{{{version_beschr}}}
==Bedeutung der Datei==
{{{bedeutung}}}
==Datei-Inhalt==
{{{dateiinhalt}}}
==Programme, welche diesen Datei-Typ benutzen==
{{{nutzerprogramme}}}

===Beispiel-Datei===
{{{beispieldatei}}}

----
zurück zu: [[Dateikennblätter]]
----
[[Strukturübersicht]]

NCPLOT.DAT

2022-12-08T14:46:00Z

Ak3spohr: temporäre Umstellung auf neue Testvorlage Dateikennblatt2022

{{Dateikennblatt2022
|name_en=NCPLOT.DAT
|dateityp=ncplot.dat
|version=November 2022
|version_beschr=November 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.
* (optional) Key '''"Axis_Font_Size" :''' Schriftgröße für 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
:*'''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_Color_Name" :''' Farben des Legendenfeldes.
** Parameter 1: für Schrift und Umrandung
** (optional) Parameter 2: für Hintergrund
* (optional) Key '''"Legend_Box_Draw_Frame" :''' Rahmen um das Legendenfeld zeichnen TRUE/FALSE.
* (optional) Key '''"Legend_Box_Frame_Style" :''' Aussehen der Legendenfeld-Umrandung.
** Parameter 1: Strichstärke
** (optional) Parameter 2: Linientyp
* (optional) Key '''"Legend_Box_Font_Size" :''' Schriftgröße für Legendenfeld.
* (optional) Key '''"MaxCharNumber_LegendEntry" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.
* (optional) Key '''"Legend_Box_Orientation" :''' Anordnung der Legendeneinträge.
* (optional) Key '''"Legend_Box_HIDE_List" :''' Legenden-Einträge dieser Liste werden NICHT gezeigt.
* (optional) Key '''"Legend_Box_SHOW_List" :''' NUR die Legenden-Einträge dieser Liste werden gezeigt.

===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.
:Platzhalter für Textbox, die mit einem DataRow-Block verbunden ist:
:*<ROW_T_DROW>, <ROW_F_DROW> wird durch Kennung des DataRow-Blocks ersetzt.
:*<ROW_T_DSET>, <ROW_F_DSET> wird durch Kennung des mit dem DataRow-Block verknüpften Datasets ersetzt.
:*<ROW_T_DIM1>, <ROW_F_DIM1> wird durch Infotext zu 1. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM2>, <ROW_F_DIM2> wird durch Infotext zu 2. Dimension des verknüpften Datensets ersetzt.
:*<ROW_T_DIM?>, <ROW_F_DIM?> usw. bis Anzahl der Dataset-Dimensionen.
:Hinweis: Verknüpfung wird im DataRow-Block per KEY ''DataRow_Linked_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.
* (optional) Key '''"MaxCharNumber_TextLine" :''' feste Zeichenzahl für relative Schriftgrößenberechnung.

===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
}}

Strukturübersicht

2022-12-08T14:40:52Z

Ak3spohr:

[[en:Overview]]
* [[Hauptseite]]
** [[Bautechnische Methoden]]
** [[Geotechnische Methoden]]
** [[Wasserbauliche Methoden]]
*** [[Mathematische Verfahren]]
**** [[Simulationsverfahren]]
***** [[Modellverfahren für den Küstenbereich und Ästuare]]
***** [[Modellverfahren für den Binnenbereich]]
****** [[Hydrodynamische Modellverfahren]]
****** [[Morphodynamische Modellverfahren - Feststofftransportmodelle]]
****** [[Wasserbauwerksmodelle]]
****** [[Fahrdynamische Modellverfahren]]
******* [[Programm "TRASSE"]]
******* [[Programm "PeTra"]]
**** [[Pre- und Postprocessing]]
***** [[Erzeugung und Bearbeitung von Gitternetzen]]
***** [[Erzeugung von Randwerten]]
****** [[Erzeugung von Randwerten#Literatur zu methodischen Ansätzen|Literatur zu methodischen Ansätzen]]
****** [[Erzeugung von Randwerten#Graphische Darstellungen komplexer Arbeitsvorgänge| Erzeugen von Randwertzeitreihen aus Mess- und Simulationsergebnissen (Grafik)]]
***** [[Umwandeln von Berechnungsergebnissen]]
***** [[Analyse der Berechnungsergebnisse]]
***** [[Differenzen der Berechnungsergebnisse]]
***** [[Immersive Visualisierung]]
***** [[Tools für wasserbauliches Ingenieurwesen]]
***** [[Datenmanagement und Informationssysteme]]
**** [[BAW-Software-Dokumentation]]
***** [[Programmkennblätter]]
***** [[Dateikennblätter]]
***** [[Standard-Software-Anwendungen (Add-ons)]]
****** [[ArcGIS-Anwendungen]]
****** [[EXCEL-Anwendungen]]
****** [[Mathematica]]
****** [[MATLAB]]
****** [[OpenMI]]
****** [[NetCDF]]
****** [[NetCDF Operators]]
****** [[Climate Data Operators]]
**** [[Validierungsstudien]]
***** [[Validierungsstudien Jade-Weser]]
**** [[Modellsysteme]]
*** [[Wasserbauliches Versuchswesen]]
**** [[Schiffserzeugte Belastungen]]
***** [[Definition der Kenngrößen]]
***** [[Funktionelle Abhängigkeiten]]
***** [[Analytische und empirische Ansätze]]
***** [[Hydrodynamisch-numerische Methoden]]
**** [[Schiffsdynamik]]
***** [[Einfluss von Schiffslänge und Kielfreiheit auf Squat und Trimm sehr großer Containerschiffe]]
***** [[Dynamisches Fahrverhalten sehr großer Containerschiffe bei Fahrt über Transportkörperstrecken]]
*** [[Naturmessungen]]
**** [[Küste und Ästuare]]
***** [[Messprogramm Nördlicher Peenestrom 2005]]
***** [[Ankerzugversuche 2013]]
***** [[Pre- und Postprozessierung]]
****** [[Postprocessing von GNSS-Rohdaten]]
***** [[Standardsoftware und Anwendungen (Add-ons)]]
****** [[MATLAB-ViSea]]
****** [[ADCP-NetCDF]]
***** [[Software Naturmessungen]]
*** [[Schiffsführungssimulation]]
**** [[Qualitätssicherung für Schiffsführungssimulation in der WSV]]
**** [[Strömungsdaten für Schiffsführungssimulation in der WSV]]
*** [[Tidedynamik der Ästuare]]
*** [[Ökologische Durchgängigkeit]]
**** [[Ökologische Durchgängigkeit - Aufgabenstellung]]
**** [[Ökologische Durchgängigkeit - Pilotanlagen]]
**** [[Ökologische Durchgängigkeit - FuE-Projekte]]
**** [[Internationale Richtlinien für Fischaufstiegsanlagen]]
***** [[Überblick über internationale Richtlinien für Fischaufstiegsanlagen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Australien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Deutschland]]
****** [[Richtlinien zu Fischaufstiegsanlagen China]]
****** [[Richtlinien zu Fischaufstiegsanlagen Finnland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Frankreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Großbritannien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Irland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Italien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Kanada]]
****** [[Richtlinien zu Fischaufstiegsanlagen Neuseeland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Niederlande]]
****** [[Richtlinien zu Fischaufstiegsanlagen Norwegen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Österreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Russische Föderation]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schottland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schweiz]]
****** [[Richtlinien zu Fischaufstiegsanlagen Tschechische Republik]]
****** [[Richtlinien zu Fischaufstiegsanlagen Türkei]]
****** [[Richtlinien zu Fischaufstiegsanlagen USA ]]
****** [[Richtlinien zu Fischaufstiegsanlagen ESHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen IHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen Vereinte Nationen]]]
****** [[Richtlinien zu Fischaufstiegsanlagen WCD]]
***** [[Richtlinienauswertung nach ausgewählten Themen]]
***** [[Empfehlungen zu Schlitzpässen]]
***** [[Grenz- oder Bemessungswerte für Schlitzpässe]]
**** [[Literaturstudie Sonderbauweisen von Fischaufstiegsanlagen]]
***** [[Baustein 1: Literatur]]
***** [[Baustein 2: Fischlifte]]
***** [[Baustein 3: Fischschleusen]]
***** [[Präsentation_Literaturstudie]]
----
* [[Template:Programmkennblatt]]
* [[Template:Dateikennblatt2022]]
* [[Template:Dateikennblatt]]
* [[Template:Dokumentsteckbrief]]
* [[Template:Glossareintrag]]
----
* [[ToDo:ProgHome]]
----

Strukturübersicht

2022-12-08T14:30:47Z

Ak3spohr:

[[en:Overview]]
* [[Hauptseite]]
** [[Bautechnische Methoden]]
** [[Geotechnische Methoden]]
** [[Wasserbauliche Methoden]]
*** [[Mathematische Verfahren]]
**** [[Simulationsverfahren]]
***** [[Modellverfahren für den Küstenbereich und Ästuare]]
***** [[Modellverfahren für den Binnenbereich]]
****** [[Hydrodynamische Modellverfahren]]
****** [[Morphodynamische Modellverfahren - Feststofftransportmodelle]]
****** [[Wasserbauwerksmodelle]]
****** [[Fahrdynamische Modellverfahren]]
******* [[Programm "TRASSE"]]
******* [[Programm "PeTra"]]
**** [[Pre- und Postprocessing]]
***** [[Erzeugung und Bearbeitung von Gitternetzen]]
***** [[Erzeugung von Randwerten]]
****** [[Erzeugung von Randwerten#Literatur zu methodischen Ansätzen|Literatur zu methodischen Ansätzen]]
****** [[Erzeugung von Randwerten#Graphische Darstellungen komplexer Arbeitsvorgänge| Erzeugen von Randwertzeitreihen aus Mess- und Simulationsergebnissen (Grafik)]]
***** [[Umwandeln von Berechnungsergebnissen]]
***** [[Analyse der Berechnungsergebnisse]]
***** [[Differenzen der Berechnungsergebnisse]]
***** [[Immersive Visualisierung]]
***** [[Tools für wasserbauliches Ingenieurwesen]]
***** [[Datenmanagement und Informationssysteme]]
**** [[BAW-Software-Dokumentation]]
***** [[Programmkennblätter]]
***** [[Dateikennblätter]]
***** [[Standard-Software-Anwendungen (Add-ons)]]
****** [[ArcGIS-Anwendungen]]
****** [[EXCEL-Anwendungen]]
****** [[Mathematica]]
****** [[MATLAB]]
****** [[OpenMI]]
****** [[NetCDF]]
****** [[NetCDF Operators]]
****** [[Climate Data Operators]]
**** [[Validierungsstudien]]
***** [[Validierungsstudien Jade-Weser]]
**** [[Modellsysteme]]
*** [[Wasserbauliches Versuchswesen]]
**** [[Schiffserzeugte Belastungen]]
***** [[Definition der Kenngrößen]]
***** [[Funktionelle Abhängigkeiten]]
***** [[Analytische und empirische Ansätze]]
***** [[Hydrodynamisch-numerische Methoden]]
**** [[Schiffsdynamik]]
***** [[Einfluss von Schiffslänge und Kielfreiheit auf Squat und Trimm sehr großer Containerschiffe]]
***** [[Dynamisches Fahrverhalten sehr großer Containerschiffe bei Fahrt über Transportkörperstrecken]]
*** [[Naturmessungen]]
**** [[Küste und Ästuare]]
***** [[Messprogramm Nördlicher Peenestrom 2005]]
***** [[Ankerzugversuche 2013]]
***** [[Pre- und Postprozessierung]]
****** [[Postprocessing von GNSS-Rohdaten]]
***** [[Standardsoftware und Anwendungen (Add-ons)]]
****** [[MATLAB-ViSea]]
****** [[ADCP-NetCDF]]
***** [[Software Naturmessungen]]
*** [[Schiffsführungssimulation]]
**** [[Qualitätssicherung für Schiffsführungssimulation in der WSV]]
**** [[Strömungsdaten für Schiffsführungssimulation in der WSV]]
*** [[Tidedynamik der Ästuare]]
*** [[Ökologische Durchgängigkeit]]
**** [[Ökologische Durchgängigkeit - Aufgabenstellung]]
**** [[Ökologische Durchgängigkeit - Pilotanlagen]]
**** [[Ökologische Durchgängigkeit - FuE-Projekte]]
**** [[Internationale Richtlinien für Fischaufstiegsanlagen]]
***** [[Überblick über internationale Richtlinien für Fischaufstiegsanlagen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Australien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Deutschland]]
****** [[Richtlinien zu Fischaufstiegsanlagen China]]
****** [[Richtlinien zu Fischaufstiegsanlagen Finnland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Frankreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Großbritannien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Irland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Italien]]
****** [[Richtlinien zu Fischaufstiegsanlagen Kanada]]
****** [[Richtlinien zu Fischaufstiegsanlagen Neuseeland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Niederlande]]
****** [[Richtlinien zu Fischaufstiegsanlagen Norwegen]]
****** [[Richtlinien zu Fischaufstiegsanlagen Österreich]]
****** [[Richtlinien zu Fischaufstiegsanlagen Russische Föderation]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schottland]]
****** [[Richtlinien zu Fischaufstiegsanlagen Schweiz]]
****** [[Richtlinien zu Fischaufstiegsanlagen Tschechische Republik]]
****** [[Richtlinien zu Fischaufstiegsanlagen Türkei]]
****** [[Richtlinien zu Fischaufstiegsanlagen USA ]]
****** [[Richtlinien zu Fischaufstiegsanlagen ESHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen IHA]]
****** [[Richtlinien zu Fischaufstiegsanlagen Vereinte Nationen]]]
****** [[Richtlinien zu Fischaufstiegsanlagen WCD]]
***** [[Richtlinienauswertung nach ausgewählten Themen]]
***** [[Empfehlungen zu Schlitzpässen]]
***** [[Grenz- oder Bemessungswerte für Schlitzpässe]]
**** [[Literaturstudie Sonderbauweisen von Fischaufstiegsanlagen]]
***** [[Baustein 1: Literatur]]
***** [[Baustein 2: Fischlifte]]
***** [[Baustein 3: Fischschleusen]]
***** [[Präsentation_Literaturstudie]]
----
* [[Template:Programmkennblatt]]
* [[Template:Test_FKB_neu]]
* [[Template:Dateikennblatt]]
* [[Template:Dokumentsteckbrief]]
* [[Template:Glossareintrag]]
----
* [[ToDo:ProgHome]]
----

NCPLOT.DAT

2022-11-14T13:53:43Z

Ak3spohr: Neues mit Version ncplot_2022_09_28

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.