PLOTPROFILZEIT: Unterschied zwischen den Versionen

Aktuelle Version vom 6. September 2022, 11:03 Uhr

Basisinformationen

Programm-Name

plotProfilZeit

Version

Juli 2018

Beschreibung

September 2022

Stichworte

Profile
Aggregation
Perzentile
Hovmoeller
ProfilZeit
MATLAB

Kurzbeschreibung

Mit der Anwendung plotProfilZeit lassen sich Daten darstellen, die auf Profilen und ggf. auch über die Zeit vorliegen. Die Besonderheit ist, dass die Daten auch auf Profilen vorliegen können, die aus einer Reihe an aneinandergreihten Kontrollvolumina bestehen.

Achtung: Wenn Sie nicht das gute alte XTRDATA Input Format nutzen möchten, nutzen Sie lieber das neue Programm NCPROFIL mit gleicher bzw. erweiterter Funktionalität.

plotProfilZeit ist das Nachfolgeprogramm von DISPLAY_PERCENTILES und "DISPLAY_HOVMOLLER". Beide Programme waren vorher zum Darstellen von Daten entlang eines Profils entwickelt worden. Beide Programme nutzten die gleichen Datentypen und unterschieden sich nur durch das entstehende Bild (Perzentilplot, Hovöller Darstellung). Zur Vereinfachung der Programmpflege wurden beide Programme zu plotProfilZeit zusammen geführt. DISPLAY_PERCENTILES ist noch verfügbar, wird aber nicht mehr weiter entwickelt. "DISPLAY_HOVMOLLER" ist nicht mehr verfügbar und wird komplett durch plotProfilZeit abgelöst.

Die Art der Darstellung ist auswählbar:

Type = Hovmoeller: Physikalische Größen, die auf einem Profil und entlang der Zeitdimension vorliegen, lassen sich als Hovmöller-Diagramm darstellen. In dieser Darstellungsform wird entlang der x-Achse die räumliche Dimension dargestellt und entlang der y-Achse die zeitliche Dimension. Der Wert der physikalischen Größe an jedem Punkt ist farbig codiert.
Type = Percentiles: Die zeitliche Variation der Größen über das Profil kann alternativ mit Hilfe dieser Darstellung gezeigt werden. Auf der x-Achse ist die räumliche Dimension, auf der y-Achse die Größe selbst. Als Linie wird der zeitliche Mittelwert der Daten an jedem Profilpunkt dargestellt. Als graue Spannweiter im Hintrgrund wird ein Bereich zwischen zwei Perszentilen dargestellt, Default sind 5 % und 95 %.
Type = Allevents: Die zeitliche Variation wird dargestellt, indem alle in der Inputdatei enthaltenen synoptischen Werte als einzelne Linien über das Profil dargestellt werden. Es wird ein Farbspektrum verwendet so dass der zeitliche Verlauf erkennbar ist, solange nicht zu viele Ereignisse übereinander dargestellt werden.
Type = Multidata: Diese Darstellungsform erlaubt keine Darstellung der Variation der Werte über die Zeit. Stattdessen können Werte aus verschiedenen Läufen verglichen werden. So können Einzelwerte aus mehreren Dateien zusammen in einem Diagramm dargestellt werden. Die Variablen dürfen dann keine Zeitdimension enthalten, sind also in der Regel Mittelwerte von Tidekennwertanalysen oder die Ergebnisse von Langzeitanalysen.

Inputformate:

Input_Format = Xtrdata: Output von XTRDATA, der als Einzelereignisse entlang eines Profils vorliegt im Format excel.dat
Input_Format = CVMesh2 fuer Netcdf Analyseergebnisse auf Kontrollvolumina oder aggregierte und nicht weiter analysierte Simulationsergebnisse
Input_Format = Mesh1 fuer Netcdf Ergebnisse auf Profilen (DATACONVERT Ergebnis von BDF Profildatei)
Input_Format = Mesh0 fuer Netcdf Ergebnisse auf Profilen (Profiloutput von UnTRIM2009)

Fehlerbehandlung: Im Gegensatz zu den Vorgängerprogrammen ist an plotProfilZeit derzeit noch keine Prüfung mit dem Fortran-Modul dictionary_ui angeschlossen. Daher kann es bei falschen Steuerwörtern noch zu unkontrollierten Programmabbrüchen ohne ordentliche Fehlermeldungen kommen.

Eingabe-Dateien

Steuerdatei (Beispiel unter $PROGHOME/examples/plotProfilZeit, Typ plotProfilZeit_steer.dat)
UNTRIM Ergebnisse in den oben genannten Formaten

Ausgabe-Dateien

Abbildung(en) der statistischen Größe(n) entlang des Profilkilometers (als *.pdf, *.png, *.eps oder *.fig)
Exceltabelle mit den statistischen Größen, die in den Abbildungen dargestellt sind (optional)
Datei mit Meldungen der dictionary_ui (error.txt)

Methode

Darstellung mit MATLAB.
Weiterhin werden bei Type = Percentiles auch vom Programm selbst Statistiken berechnet. Dafür werden folgende MATLAB-Funktionen genutzt:

für die Perzentile: prctile
für den Mittelwert: nanmean (d.h. NaNs fließen nicht in die Berechnung ein)
für den Median: nanmedian (d.h. NaNs fließen nicht in die Berechnung ein)
für das Maximum: nanmax (d.h. NaNs fließen nicht in die Berechnung ein)
für das Minimum: nanmin (d.h. NaNs fließen nicht in die Berechnung ein)

Vorlauf-Programme

XTRDATA, DATACONVERT, NCAGGREGATE, NCANALYSE, UNTRIM

Nachlauf-Programme

MATLABFIGVIEWER

Weitere Informationen

Programmiersprache

MATLAB (erstellt mit Version R2016b)

zusätzliche Software

Benötigt zum Ausführen MATLAB Compiler Runtime (zu finden auf Linux unter /usr/local/MATLAB/MATLAB_Runtime/v85)

Originalversion

A. Zorndt

Programmpflege

Arbeitsgruppe POS mit A. Zorndt

Dokumentation/Literatur

Anwendungsbeispiele findet sich unter $PROGHOME/examples/plotProfilZeit/.
Beschreibungen der unter Methode erwähnten MATLAB-Funktionen finden sich hier: http://de.mathworks.com/help/stats/descriptive-statistics.html .

Für ihre Mithilfe bei der Programmentwicklung danke ich Tabea Brodhagen, Marissa Albers und Jens Jürges.

zurück zu Programmkennblätter

Strukturübersicht

@@ Zeile 1: / Zeile 1: @@
 {{Programmkennblatt
-|name_en=plotProfilZeit
+|name_en=PLOTPROFILZEIT
 |name=plotProfilZeit
 |version=Juli 2018
-|version_beschr=Juli 2018
+|version_beschr=September 2022
 |stichworte=
 Profile<br />
@@ Zeile 15: / Zeile 15: @@
 Mit der Anwendung '''plotProfilZeit''' lassen sich Daten darstellen, die auf Profilen und ggf. auch über die Zeit vorliegen. Die Besonderheit ist, dass die Daten auch auf Profilen vorliegen können, die aus einer Reihe an aneinandergreihten Kontrollvolumina bestehen.<br />
-plotProfilZeit ist das Nachfolgeprogramm von [[DISPLAY_PERCENTILES]] und DISPLAY_HOVMOELLER. DISPLAY_PERCENTILES und DISPLAY_HOVMOELLER waren vorher zum Darstellen von Daten entlang eines Profils entwickelt worden. Beide Programme nutzten die gleichen Datentypen und unterschieden sich nur durch das entstehende Bild (Perzentilplot, Hovöller Darstellung). Zur Vereinfachung der Programmpflege wurden beide Programme zu plotProfilZeit zusammen geführt. [[DISPLAY_PERCENTILES]] ist noch verfügbar, wird aber nicht mehr weiter entwickelt. DISPLAY_HOVMOELLER ist nicht mehr verfügbar und wird komplett durch plotProfilZeit abgelöst.<br />
+Achtung: Wenn Sie nicht das gute alte [[XTRDATA]] Input Format nutzen möchten, nutzen Sie lieber das neue Programm [[NCPROFIL]] mit gleicher bzw. erweiterter Funktionalität.<br />
+plotProfilZeit ist das Nachfolgeprogramm von [[DISPLAY_PERCENTILES]] und "DISPLAY_HOVMOLLER". Beide Programme waren vorher zum Darstellen von Daten entlang eines Profils entwickelt worden. Beide Programme nutzten die gleichen Datentypen und unterschieden sich nur durch das entstehende Bild (Perzentilplot, Hovöller Darstellung). Zur Vereinfachung der Programmpflege wurden beide Programme zu plotProfilZeit zusammen geführt. [[DISPLAY_PERCENTILES]] ist noch verfügbar, wird aber nicht mehr weiter entwickelt. "DISPLAY_HOVMOLLER" ist nicht mehr verfügbar und wird komplett durch plotProfilZeit abgelöst.<br />
 Die Art der Darstellung ist auswählbar:<br />
-* Type = Hovmoeller: Die Daten werden entlang des Profils (x-Achse) und über die Zeit (y-Achse) mit Hilfe eines Hovmöller Plots dargestellt.
+* Type = '''Hovmoeller''': Physikalische Größen, die auf einem Profil und entlang der Zeitdimension vorliegen, lassen sich als Hovmöller-Diagramm darstellen. In dieser Darstellungsform wird entlang der x-Achse die räumliche Dimension dargestellt und entlang der y-Achse die zeitliche Dimension. Der Wert der physikalischen Größe an jedem Punkt ist farbig codiert.
-* Type = Percentiles: Die zeitliche Variation der Werte auf dem Profil kann dargestellt werden, indem ein Mittelwert als schwarze Linie und im Hintergrund eine Spannweite innerhalb von best. Perzentilen als graue Fläche dargestellt werden.
+* Type = '''Percentiles''':  Die zeitliche Variation der Größen über das Profil kann alternativ mit Hilfe dieser Darstellung gezeigt werden. Auf der x-Achse ist die räumliche Dimension, auf der y-Achse die Größe selbst. Als Linie wird der zeitliche Mittelwert der Daten an jedem Profilpunkt dargestellt. Als graue Spannweiter im Hintrgrund wird ein Bereich zwischen zwei Perszentilen dargestellt, Default sind 5 % und 95 %.
-* Type = Allevents: Alle Zeitschritte werden als Einzelllinien verschiedener Farben dargestellt.
+* Type = '''Allevents''': Die zeitliche Variation wird dargestellt, indem alle in der Inputdatei enthaltenen synoptischen Werte als einzelne Linien über das Profil dargestellt werden. Es wird ein Farbspektrum verwendet so dass der zeitliche Verlauf erkennbar ist, solange nicht zu viele Ereignisse übereinander dargestellt werden.
-* Type = Multidata: Einzelwerte aus mehreren Dateien werden zusammen in einem Diagramm dargestellt. <br />
+* Type = '''Multidata''': Diese Darstellungsform erlaubt keine Darstellung der Variation der Werte über die Zeit. Stattdessen können Werte aus verschiedenen Läufen verglichen werden. So können Einzelwerte aus mehreren Dateien zusammen in einem Diagramm dargestellt werden. Die Variablen dürfen dann keine Zeitdimension enthalten, sind also in der Regel Mittelwerte von Tidekennwertanalysen oder die Ergebnisse von Langzeitanalysen. <br />
-[[Datei:Mittlere Temperatur.png|thumb|'''Bild ''Beispiel für eine mit plotProfilZeit erstellte Abbildung'''''.]]
+Inputformate:<br />
+* Input_Format = '''Xtrdata''': Output von [[XTRDATA]], der als Einzelereignisse entlang eines Profils vorliegt im Format [[EXCEL.DAT|excel.dat]]
+* Input_Format = '''CVMesh2''' fuer Netcdf Analyseergebnisse auf Kontrollvolumina oder aggregierte und nicht weiter analysierte Simulationsergebnisse
+* Input_Format = '''Mesh1''' fuer Netcdf Ergebnisse auf Profilen ([[DATACONVERT]] Ergebnis von [[DIRZ.BIN|BDF]] Profildatei)
+* Input_Format = '''Mesh0''' fuer Netcdf Ergebnisse auf Profilen (Profiloutput von UnTRIM2009)
-Inputformate:<br />
+[[File:Mesh0 node skalare Stroemungsgeschwindigkeit 2d 1.png|400 px|Beispiel '''Hovmoeller''']]
-* Input_Format = Xtrdata: Output von [[XTRDATA]], der als Einzelereignisse entlang eines Profils vorliegt im Format [[EXCEL.DAT|excel.dat]]
+[[File:CVSwmean Mesh2 face tide mean su sumen 2.png|400 px|Beispiel '''Percentiles''']]
-* Input_Format = CVMesh2 fuer Netcdf Analyseergebnisse auf Kontrollvolumina oder aggregierte und nicht weiter analysierte Simulationsergebnisse
+[[File:TSM 2.png|400 px|Beispiel '''Allevents''']]
-* Input_Format = Mesh1 fuer Netcdf Ergebnisse auf Profilen ([[DATACONVERT]] Ergebnis von [[BDF]] Profildatei)
+[[File:CVMesh2 exch hor adv ssc flux res sumen 1.png|400 px|Beispiel '''Multidata''']]
-* Input_Format = Mesh0 fuer Netcdf Ergebnisse auf Profilen (Profiloutput von UnTRIM2009)
 Fehlerbehandlung:
@@ Zeile 56: / Zeile 61: @@
 |programmiersprache=[[MATLAB]] (erstellt mit Version R2016b)
 |zus_software= Benötigt zum Ausführen MATLAB Compiler Runtime (zu finden auf Linux unter /usr/local/MATLAB/MATLAB_Runtime/v85)
-|kontakt_original=[mailto:anna.zorndt@baw.de A. Zorndt]
+|kontakt_original=A. Zorndt
-|kontakt_pflege=[mailto:anna.zorndt@baw.de A. Zorndt]
+|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS] mit A. Zorndt
 |dokumentation=
 Anwendungsbeispiele findet sich unter $PROGHOME/examples/plotProfilZeit/.<br />