PLOTPROFILZEIT
Aus BAWiki
Basisinformationen
Programm-Name
plotProfilZeit
Version
Juli 2018
Beschreibung
Juli 2018
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.
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.
Die Art der Darstellung ist auswählbar:
- Type = Hovmoeller: Die Daten werden entlang des Profils (x-Achse) und über die Zeit (y-Achse) mit Hilfe eines Hovmöller Plots dargestellt.
- 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 = Allevents: Alle Zeitschritte werden als Einzelllinien verschiedener Farben dargestellt.
- Type = Multidata: Einzelwerte aus mehreren Dateien werden zusammen in einem Diagramm dargestellt.
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
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
Programmpflege
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