NCPLOT: Unterschied zwischen den Versionen

Aktuelle Version vom 28. August 2023, 06:17 Uhr

Basisinformationen

Programm-Name

NCPLOT

Version

März 2022

Beschreibung

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 (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 1: Salzgehalt mit hinterlegter Topografie.

Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von 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.

Flächenhafte Diagramme:

Karte, bzw. Draufsicht-Darstellung
Vertikalschnitt entlang Profil (3D-Daten)
Tiefenzeitreihe an einem Ort (3D-Daten)
Hovmöller: zeitliche Entwicklung über Profil

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.

Eingabe-Dateien

allgemeine Eingabedaten (Dateityp ncplot.dat)
Berechnungs und/oder Analyseergebnisse (Dateityp cf-netcdf.nc)
Datei mit Intervalldefinitionen von Farblegenden (bounds.cfg.dat)
Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
Datei mit Verweisen zu Palettendefinitionen (palettes.cfg.dat)
Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
Datei mit Farbdefinitionen (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

Ausgabe-Dateien

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.

Vorlauf-Programme

BOE2NC, TS2NC, DATACONVERT, GRIDCONVERT, NCAGGREGATE, NCANALYSE, NCCUTOUT, NCDELTA, NCDVAR, NCMERGE, UNK, UNTRIM2007, UNTRIM2

Nachlauf-Programme

---

Weitere Informationen

Programmiersprache

Fortran95

zusätzliche Software

GKS (GTS-Gral)

Originalversion

G. Lang, S. Spohr

Programmpflege

Arbeitsgruppe POS

Dokumentation/Literatur

Musterdateien finden sich in $PROGHOME/examples/ncplot/

zurück zu Programmkennblätter

Strukturübersicht

@@ Zeile 2: / Zeile 2: @@
 |name_en=NCPLOT
 |name=NCPLOT
-|version=März 2013
+|version=März 2022
-|version_beschr=März 2013
+|version_beschr=September 2022
 |stichworte=Graphik-Postprozessor<br />
 Darstellung von Berechnungsergebnissen<br />
-CF-NetCDF-Format für 2D-/3D-Daten<br />
+CF-NetCDF-Format für 2D-/3D-Daten (unbekannte Attribute werden ignoriert)<br />
 Finite Elemente Verfahren<br />
 Finite Differenzen Verfahren<br />
 Verfahren für unstrukturierte orthogonale Gitternetze<br />
-Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen
+Verfahren für unstrukturierte orthogonale Gitternetze mit SubGrid-Informationen<br />
+Umrechnung bzw. Transformation (extensiv - intensiv) der physikalischen Einheit<br />
+Verknüpfung mehrerer Eingangsgrößen zu einer neuen Größe für Darstellungszwecke<br />
+(optional) Filterung der Darstellung basierend auf der Wassertiefe<br />
+(optional) Filterung der Darstellung baiserend auf der Anzahl der Beobachtungen<br />
+ 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 maßstäblichen, flächenhaften Darstellung von
+Das Programm NCPLOT dient der Darstellung von Berechnungs- und Analyseergebnissen,
-skalaren Berechnungs- und Analyseergebnissen, die im CF-NetCDF-Format abgelegt sind.
+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.<br />
+vorliegen. Es können 2D-, und 3D-Daten, sowie Daten mit subgridskaligen Details
-Die Darstellung vektorieller Größen ist derzeit noch nicht implementiert.
+verarbeitet werden.<br />
+[[Bild:NcplotBspFaceArea.png|thumb|250px|Bild 1: Salzgehalt mit hinterlegter Topografie.]]
-NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
+Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT.<br />
-Interaktion mit dem Anwender statt.
+[[Beispiel-Grafiken: NCPLOT|NCPLOT: Beispiel-Grafiken]]
-Das Layout des Bildes und die graphischen Darstellung der Daten wird über Angaben
-in den Eingabedateien des Programmes festgelegt.
+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.<br />
+[[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]]:<br />
+* 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.
+<br />
-Die Visualisierung eines Datensatzes wird in einem sogenannten Layer beschrieben.
-Die Zuordnung von Farben zu Datenwerten und die Repräsentationsform der
-zugrundeliegenden Geometrie werden dort festgelegt.
-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).
-Verschiedene Layer können in einer Karte übereinander geplottet werden.
+Bildserien:<br />
-Jede Karte kann mit einem Rahmen ausgestattet werden, wobei es sich
+Sowohl linien- als auch flächenhafte Diagrammdefinitionen können das Erstellen von
-um eine einfache Umrandung oder einen ausgefeilten Koordinatenrahmen handeln kann.
+Bildserien anfordern. Ein Plot kann somit neben statischen auch dynamische, also
-Die Koordinatenrahmen sind für Gauß-Krüger-Werte optimiert.
+über die Bildserie veränderliche Bildanteile beinhalten.
-Auf einem Bild können mehrere Kartenfenster angeordnet werden.
+<br />
-NCPLOT erzeugt Vektorgrafiken im CGM-Format.
+Damit das Programm den sich dadurch ergebenden Kombinationsmöglichkeiten irgendwie
+Herr wird, gilt folgende Regel:<br />
+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.
+<br />
+Weitere Prüfungen hinsichtlich der Sinnhaftigkeit der Daten-Adressierung zwischen
+beteiligten Bildelementen werden nicht vorgenommen.
+<br />
-Die Beispiel-Grafiken veranschaulichen die Leistungsfähigkeit von NCPLOT.<br />
+Verschiedene Seriendiagramme aus dynamischen Diagramm-Defintionen gleicher
-[[Beispiel-Grafiken: NCPLOT]]
+Länge werden vom Programm verarbeitet. Die statischen Bildelemente finden
+sich dabei auf jedem Bild der Serie.
+<br />
 |eingabedateien=
 # '''allgemeine Eingabedaten''' (Dateityp [[NCPLOT.DAT|ncplot.dat]])
 # '''Berechnungs und/oder Analyseergebnisse''' (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]])
-# Datei mit '''Intervalldefinitionen''' von Farblegenden (Dateityp [[BOUNDS.CFG.DAT|bounds.cfg.dat]]) <br />Hinweis: Die Anzahl der Intervalle muss der Anzahl der Farben der zugeordneten Palette entsprechen.
+# Datei mit '''Intervalldefinitionen''' von Farblegenden ([[BOUNDS.CFG.DAT|bounds.cfg.dat]]) <br />Hinweis: Lokale Konfigurationsdatei (empfohlen) oder Datei aus $PROGHOME/cfg/-Verzeichnis.
-# Datei mit '''Verweisen zu Palettendefinitionen''' (Dateityp [[PALETTES.CFG.DAT|palettes.cfg.dat]])
+# Datei mit '''Verweisen zu Palettendefinitionen''' ([[PALETTES.CFG.DAT|palettes.cfg.dat]]) <br />Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
-# Datei mit '''Farbdefinitionen''' (Dateiname colors.cfg.dat, Dateityp [[COLORS.DAT|colors.dat]])
+# Datei mit '''Farbdefinitionen''' ([[COLORS.CFG.DAT|colors.cfg.dat]]) <br />Hinweis: Bereitgestellte Datei aus $PROGHOME/cfg/-Verzeichnis (empfohlen) oder aus lokaler Konfigurationsdatei.
 Desweiteren werden von dem Programm NCPLOT folgende Standard-Konfigurationsdateien aus dem Verzeichnis
@@ Zeile 54: / Zeile 86: @@
 |ausgabedateien=
-# '''Plot-Metafiles''' (CGM) <br />Hinweis: Die erzeugten CGM-Dateien werden, aus verschiedenen Gr&uuml;nden, schnell unhandlich gro&szlig;. Ein direktes Konvertieren in ein Bitmap-Format (z.B. PNG) wird empfohlen.
+# '''Grafikdatei(en)''' (Format: CGM oder SVG) <br />Hinweis: Die erzeugten Vektorgrafiken k&ouml;nnen ggf. unhandlich gro&szlig; 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=
-Die Daten werden vom Programm an ihren originalen Positionen (node, edge, face) dargestellt.
+NCPLOT ist ein reines Plotprogramm, d.h. zur Laufzeit des Programms findet keine
-Eine horizontale Interpolation der Daten ist derzeit noch nicht möglich.
+Interaktion mit dem Anwender statt.
-Knotendaten können mit Marker-Symbolen oder als Text visualisiert werden.
+Das Layout des Bildes und die graphische Darstellung der Daten wird über Angaben
-Kantendaten können per Linien-Symbolisierung und Daten auf Polygon können mit Hilfe
+in den Eingabedateien des Programmes festgelegt.
-der angebotenen Flächen-Symbolisierung dargestellt werden.
+<br />
-Für Knoten- und Polygondaten bestehen auch die Möglichkeiten der Punkt-Symbolisierung.
-Die Marker oder Texte werden in dem Fall an der Kantenmitte, bzw. am Polygonschwerpunkt
+NCPLOT erzeugt Vektorgrafiken im CGM- oder SVG-Format.
-verortet.
+<br />
 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.
+<br />
+Hinweis: '''HDF error'''<br />
+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.
+<br />
-|preprozessor=[[DATACONVERT]], [[GRIDCONVERT]], [[UNTRIM2007]], UnTRIM2 (SubGrid)
+|preprozessor=[[BOE2NC]], [[TS2NC]], [[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:jens.juerges@baw.de J. Jürges]
+|kontakt_original=G. Lang, S. Spohr
-|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang],[mailto:jens.juerges@baw.de J. Jürges]
+|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
 |dokumentation=
 Musterdateien finden sich in '''$PROGHOME/examples/ncplot/'''
 }}