Aktionen

NCPROFIL: Unterschied zwischen den Versionen

Aus BAWiki

(Die Seite wurde neu angelegt: „{{Programmkennblatt |name_en=NCPROFIL |name=ncprofil |version=Juni 2021 |version_beschr=Juni 2021 |stichworte= Profile<br /> Aggregation<br /> Perzentile<br />…“)
 
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:
|name=ncprofil
|name=ncprofil
|version=Juni 2021
|version=Juni 2021
|version_beschr=Juni 2021
|version_beschr=September 2022
|stichworte=
|stichworte=
Profile<br />
Profile<br />
Zeile 15: Zeile 15:


|kurzbeschreibung=
|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.<br />
Mit der Anwendung '''ncprofil''' 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_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 />
ncprofil ist das Nachfolgeprogramm von [[PLOTPROFILZEIT]], das nicht mehr aktualisiert wird. Der Unterschied ist ein Re-Engineering des Programms auf die neuen Standards für Matlab-Proghome Programme. In einem nächsten Schritt wird noch eine Anpassung der Leseroutine erfolgen. Mit dem Re-Engineering fällt das veraltete Inputformat [[XTRDATA]] weg.<br />


Die Art der Darstellung ist auswählbar:<br />
Die Art der Darstellung ist auswählbar:<br />
* 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 = '''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 = '''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 = '''Prognose''': Aus den Perzentilen kann auch ein Prognosewert gebildet werden. Entsprechend dem im Weserverfahren angewendeten Verfahren zur Prognosebildung wird dafür der Perzentilwert um einen wählbaren Rundungswert aufgerundet (z. B. 1 cm für den Wasserstand). Weiterhin wird für angegebene Bereiche (z. B. 5-km Abschnitte) der höchste gerundete Wert gewählt. Dies ist dann der Prognosewert für diesen Abschnitt und wird neben den Perzentilwerten (grau) dann standardmäßig als rote Linie angezeigt. Auf der x-Achse ist die räumliche Dimension, auf der y-Achse die Größe selbst. 
* 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 = '''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. <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.  
* Type = '''IsoLine''':
* Type = '''IsoShift''':
* Type = '''IsoClass''':
* Type = '''IsoComp''':
<br />


Inputformate:<br />
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 = '''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 = '''Mesh1''' fuer Netcdf Ergebnisse auf Profilen ([[DATACONVERT]] Ergebnis von [[DIRZ.BIN|BDF]] Profildatei)
Zeile 35: Zeile 40:
[[File:TSM 2.png|400 px|Beispiel '''Allevents''']]
[[File:TSM 2.png|400 px|Beispiel '''Allevents''']]
[[File:CVMesh2 exch hor adv ssc flux res sumen 1.png|400 px|Beispiel '''Multidata''']]
[[File:CVMesh2 exch hor adv ssc flux res sumen 1.png|400 px|Beispiel '''Multidata''']]
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.


|eingabedateien=
|eingabedateien=
# Steuerdatei (Beispiel unter $PROGHOME/examples/plotProfilZeit, Typ [[plotProfilZeit_steer.dat]])
# Steuerdatei (Beispiel unter $PROGHOME/examples/ncprofil, Typ [[ncprofil_steer.dat]])
# [[UNTRIM]] Ergebnisse in den oben genannten Formaten
# [[UNTRIM]] Ergebnisse in den oben genannten Formaten


|ausgabedateien=   
|ausgabedateien=   
# Abbildung(en) der statistischen Größe(n) entlang des Profilkilometers (als *.pdf, *.png, *.eps oder *.fig)
# 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)
# sdr Datei zum Programmverlauf
# Datei mit Meldungen der dictionary_ui (error.txt)
# err Datei für Fehler


|methode=
|methode=
Zeile 57: Zeile 59:
* für das Minimum: nanmin (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)


|preprozessor=[[XTRDATA]], [[DATACONVERT]], [[NCAGGREGATE]], [[NCANALYSE]], [[UNTRIM]]
|preprozessor=[[NCAGGREGATE]], [[NCANALYSE]], [[UNTRIM]]
|postprozessor=[[MATLABFIGVIEWER]]
|postprozessor=[[MATLABFIGVIEWER]]
|programmiersprache=[[MATLAB]] (erstellt mit Version R2016b)
|programmiersprache=[[MATLAB]] (erstellt mit Version R2019b)
|zus_software= Benötigt zum Ausführen MATLAB Compiler Runtime (zu finden auf Linux unter /usr/local/MATLAB/MATLAB_Runtime/v85)
|zus_software= Benötigt zum Ausführen MATLAB Compiler Runtime (zu finden auf Linux unter /usr/local/MATLAB/MATLAB_Runtime/v97)
|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, U. Schiller und Catie Bachmann
|dokumentation=
|dokumentation=
Anwendungsbeispiele findet sich unter $PROGHOME/examples/plotProfilZeit/.<br />
Anwendungsbeispiele findet sich unter $PROGHOME/examples/ncprofil/.<br />
Beschreibungen der unter Methode erwähnten MATLAB-Funktionen finden sich hier:  
Beschreibungen der unter Methode erwähnten MATLAB-Funktionen finden sich hier:  
http://de.mathworks.com/help/stats/descriptive-statistics.html .<br />
http://de.mathworks.com/help/stats/descriptive-statistics.html .<br />




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


}}
}}

Aktuelle Version vom 26. Juli 2023, 14:17 Uhr

Basisinformationen

Programm-Name

ncprofil

Version

Juni 2021

Beschreibung

September 2022

Stichworte

Profile
Aggregation
Perzentile
Prognosewerte
Hovmoeller
ProfilZeit
plotProfilZeit
MATLAB

Kurzbeschreibung

Mit der Anwendung ncprofil 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.

ncprofil ist das Nachfolgeprogramm von PLOTPROFILZEIT, das nicht mehr aktualisiert wird. Der Unterschied ist ein Re-Engineering des Programms auf die neuen Standards für Matlab-Proghome Programme. In einem nächsten Schritt wird noch eine Anpassung der Leseroutine erfolgen. Mit dem Re-Engineering fällt das veraltete Inputformat XTRDATA weg.

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 = Prognose: Aus den Perzentilen kann auch ein Prognosewert gebildet werden. Entsprechend dem im Weserverfahren angewendeten Verfahren zur Prognosebildung wird dafür der Perzentilwert um einen wählbaren Rundungswert aufgerundet (z. B. 1 cm für den Wasserstand). Weiterhin wird für angegebene Bereiche (z. B. 5-km Abschnitte) der höchste gerundete Wert gewählt. Dies ist dann der Prognosewert für diesen Abschnitt und wird neben den Perzentilwerten (grau) dann standardmäßig als rote Linie angezeigt. Auf der x-Achse ist die räumliche Dimension, auf der y-Achse die Größe selbst.
  • 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.
  • Type = IsoLine:
  • Type = IsoShift:
  • Type = IsoClass:
  • Type = IsoComp:


Inputformate:

  • 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)

Beispiel Hovmoeller Beispiel Percentiles Beispiel Allevents Beispiel Multidata

Eingabe-Dateien

  1. Steuerdatei (Beispiel unter $PROGHOME/examples/ncprofil, Typ ncprofil_steer.dat)
  2. UNTRIM Ergebnisse in den oben genannten Formaten

Ausgabe-Dateien

  1. Abbildung(en) der statistischen Größe(n) entlang des Profilkilometers (als *.pdf, *.png, *.eps oder *.fig)
  2. sdr Datei zum Programmverlauf
  3. err Datei für Fehler

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

NCAGGREGATE, NCANALYSE, UNTRIM

Nachlauf-Programme

MATLABFIGVIEWER

Weitere Informationen

Programmiersprache

MATLAB (erstellt mit Version R2019b)

zusätzliche Software

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

Originalversion

A. Zorndt

Programmpflege

Arbeitsgruppe POS mit A. Zorndt, U. Schiller und Catie Bachmann

Dokumentation/Literatur

Anwendungsbeispiele findet sich unter $PROGHOME/examples/ncprofil/.
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 Ulrike Schiller.

zurück zu Programmkennblätter

Strukturübersicht

Abgerufen von „https://wiki.baw.de/de/index.php?title=NCPROFIL&oldid=36165“