Aktionen

NCPOLO.DAT: Unterschied zwischen den Versionen

Aus BAWiki

imported>Hagen Robert
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
|name_en=NCPOLO.DAT
|name_en=NCPOLO.DAT
|dateityp=ncpolo.dat  
|dateityp=ncpolo.dat  
|version=Mai 2019
|version=September 2021
|version_beschr=Mai 2019
|version_beschr=September 2021
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPOLO]]
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCPOLO]]
|dateiinhalt=
|dateiinhalt=
'''Eingabesteuerdaten'''
'''Eingabesteuerdaten'''


* '''Block 1 Messdaten''': Eingabewerte Messung
* '''Block 1 Properties'''
*# '''MEAS_WL''': Messdaten Wasserstand im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# '''identifier''': Eindeutiger Bezeichner für den Output (z.B. run001)
*# '''MEAS_CU''': Messdaten Strömung im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# '''outlier_check''': (opt) Durchführen eines Ausreißercheck mit [https://de.mathworks.com/help/matlab/ref/isoutlier.html MATLAB isoutlier(data,6)]
*# '''MEAS_SA''': Messdaten Salzgehalt im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# '''plot_linewidth''': (opt) Dicke der Achsenumrandung (default 1.5)
*# '''MEAS_TE''': Messdaten Temperatur im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# '''MEAS_SW''': Messdaten sig. Wellenhöhe im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])
*# '''MEAS_PP''': Messdaten Peak Wellenperiode im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])
*# '''MEAS_MP''': Messdaten mit. Wellenperiode im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])


* '''Block 2 Modelldaten''': Eingabewerte Modellergebnisse
* '''Block 2 input''': Eingabewerte (kann beliebig oft angegeben werden)
*# '''MOD_ARE''': Gechunkte (siehe [[NCCHUNKIE]]), flächige, 2D [[UNTRIM2007]] oder [[UNTRIM2]] Ergebnisdatei
*# '''infile''': Name des Eingangsdatensatzes [[CF-NETCDF.NC|cf-netcdf.nc]] Format aus [[NCDELTA]]
*# '''MOD_UNK''': Gechunkte (siehe [[NCCHUNKIE]]), flächige, 2D [[UNK]] Ergebnisdatei
*# '''refname''': Bezeichner für die Referenzdaten aus [[NCDELTA]]
*# '''varname''': Bezeichner für die Variantendaten aus [[NCDELTA]]
*# '''variable''': Skalare Variablenname der auszuwertenden Variable ('''ohne''' ODdif, OCvar oder OCref)
*# '''variable_xy''': Vektorielle Variablennamen der auszuwertenden Variable ('''ohne''' ODdif, OCvar oder OCref, nur für Hodographen)
*# '''export_dir''': Ausgabeordner (wird automatisch erstellt)
*# '''fraction''': Index oder Name der darzustellenden Fraktion (z.B. 2 oder very_fine_silt)
*# '''time_series''': (opt) true/false, ob Darstellung erfolgen soll
*# '''scatterplot''': (opt) true/false, ob Darstellung erfolgen soll
*# '''hodograph''': (opt) true/false, ob Darstellung erfolgen soll
*# '''error_distr''': (opt) true/false, ob Darstellung erfolgen soll
*# '''boxplot''': (opt) true/false, ob Darstellung erfolgen soll
*# '''time_focus''': (opt) Angabe von Detailzeiträumen für Zeitreihen im Format ddmmyy ddmmyy ddmmyy ddmmyy ... (Start Ende Start End, ...) - maximal 5 Zeiträume möglich.
*# '''tsBounds''': (opt) y-Limits für time_series - kein Einfluss auf Datenverarbeitung
*# '''scatBounds''': (opt) y-Limits für scatterplot - kein Einfluss auf Datenverarbeitung
*# '''hodoBounds''': (opt) y-Limit für Hodograph (nur eine Angabe erf.) - kein Einfluss auf Datenverarbeitung
*# '''errorBounds''': (opt) y-Limits für error_distr - kein Einfluss auf Datenverarbeitung
*# '''boxBounds''': (opt) y-Limits für boxplot - kein Einfluss auf Datenverarbeitung
*# '''stat_all''': (opt) Aktiviert den Statistiküberblickexport für die Formate xlsx csv mat


* '''Block 3 Exportverzeichnis''': Festlegen der Exportverzeichnisse
* '''Block 3a-e Ploteigenschaften''': Festlegen der Ploteigenschaften
*# '''EXPORTDIR_WL''': Exportpfad aller Wasserstands bezogener [[NCPOLO]] Ausgaben.
In diesem Block werden je Darstellungstyp diverse Ploteigenschaften angeboten. Die Angabemöglichkeiten sind für dieses Programmkennblatt zu zahlreich und werden in der Steuerdatei zu [[NCPOLO]] beschrieben. Weitestgehend umschrieben enthalten diese Eingangsparameter:
*# '''EXPORTDIR_CU''': Exportpfad aller Strömungs bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_SA''': Exportpfad aller Salzgehalts bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_TE''': Exportpfad aller Temperatur bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_TU''': Exportpfad aller Schwebstoff bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_SW''': Exportpfad aller sig. Wellenhöhe bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_PP''': Exportpfad aller Peak Wellenperiode bezogener [[NCPOLO]] Ausgaben.
*# '''EXPORTDIR_MP''': Exportpfad aller mittl. Wellenperiode bezogener [[NCPOLO]] Ausgaben.
 
* '''Block 4 Eingangsparameter''': Festlegen relevanter Parameter
*# '''minPOINTS''': [[NCPOLO]] kontrolliert ob eine Edge oder ein Face, das örtlich korreliert wurde trockenfällt. Ist dies der Fall wird die zweitnächste (... usw.) Edge bzw. das zweitnächste (... usw.) Face korreliert. minPOINTS deckelt diese Iteration.
*# '''maxDIST''': Gibt in Metern an, wie weit die Messung maximal von der nächsten Edge bzw. dem nächsten Face entfernt sein darf.
*# '''WLBOUNDS''': Unteres und oberes Limit für die Darstellung von Wasserstand. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''CUBOUNDS''': Unteres und oberes Limit für die Darstellung von Strömung. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''SABOUNDS''': Unteres und oberes Limit für die Darstellung von Salzgehalt. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''TEBOUNDS''': Unteres und oberes Limit für die Darstellung von Temperatur. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''TUBOUNDS''': Unteres und oberes Limit für die Darstellung von Schwebstoff. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''SWBOUNDS''': Unteres und oberes Limit für die Darstellung von sig. Wellenhöhe. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''PPBOUNDS''': Unteres und oberes Limit für die Darstellung von Peak Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''MPBOUNDS''': Unteres und oberes Limit für die Darstellung von mit. Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
*# '''WLTOL''': Messungenauigkeit des Wasserstands zur Berechnung von ARMAE und ARRMSE.
*# '''CUTOL''': Messungenauigkeit der Strömung zur Berechnung von ARMAE und ARRMSE.
*# '''SATOL''': Messungenauigkeit des Salzgehalts zur Berechnung von ARMAE und ARRMSE.
*# '''TETOL''': Messungenauigkeit der Temperatur zur Berechnung von ARMAE und ARRMSE.
*# '''TUTOL''': Messungenauigkeit des Schwebstoffgehalts zur Berechnung von ARMAE und ARRMSE.
*# '''SWTOL''': Messungenauigkeit der sig. Wellenhöhe zur Berechnung von ARMAE und ARRMSE.
*# '''PPTOL''': Messungenauigkeit der Peak Wellenperiode zur Berechnung von ARMAE und ARRMSE.
*# '''MPTOL''': Messungenauigkeit der mit. Wellenperiode zur Berechnung von ARMAE und ARRMSE.
 
* '''Block 5 Plottypen''': Festlegen der Plotarten
*# '''TIME_SERIES''': Zeitreihen (WL, CU, SA, TE, TU, SW, PP, MP)
*# '''SCATTERPLOT''': Scatterplot (WL, CU, SA, TE, TU, SW, PP, MP)
*# '''HODOGRAPH''': Hodograph (CU)
*# '''ERROR_DISTR''': Fehlerverteilung als Balken, Linie oder Stem (WL, CU, SA, TE, TU, SW, PP, MP)
*# '''BOXPLOT''': Fehlerverteilung als Häufigkeitsverteilung bzw. als Boxplot (WL, CU, SA, TE, TU, SW, PP, MP)
*# '''TAYLORDIAGRAM''': Fehlerverteilung als Taylordiagramm (WL, CU, SA, TE, TU, SW, PP, MP), Achtung! Noch nicht verfügbar.
*# '''TARGETDIAGRAM''': Fehlerverteilung als Targetdiagramm (WL, CU, SA, TE, TU, SW, PP, MP), Achtung! Noch nicht verfügbar.
 
* '''Block 6 Ploteigenschaften''': Festlegen der Ploteigenschaften
In diesem Block werden je Darstellungstyp diverse Ploteigenschaften angeboten. Die Angabemöglichkeiten sind für dieses Programmkennblatt zu zahlreich und werden in der Steuerdatei zu [[NCPOLO]] erschöpfend beschrieben. Weitestgehend umschrieben enthalten diese Eingangsparameter:


* Breite und Höhe
* Breite und Höhe
Zeile 67: Zeile 41:
* Textgestaltung
* Textgestaltung
* Ausgabeformat
* Ausgabeformat
* Ausgabesprache
* Beschriftungsart
* Beschriftungsart
* Achsenlimits und -ticks
* Gitternetz und Hilfslinien
* Gitternetz und Hilfslinien
* Skillscores im Plot
* Skillscores im Plot
Zeile 75: Zeile 47:
* Optionen zur farblichen Gestaltung der Dichtefunktion von Scatterplot bzw. Hodograph
* Optionen zur farblichen Gestaltung der Dichtefunktion von Scatterplot bzw. Hodograph


* '''Block 7 Datenexport''': Festlegen des Datenexports
===Statistische Kennwerte===
*# '''TSEXPORT''': Export der Daten (je Pegel) als .dat, .csv, .latex, .boewrt
 
*# '''STATEXPORT''': Export der statistischen Kennwerte (je physikalischer Größe) als .dat, .csv, .latex, .mat
* MEANREF, Mittelwert der Referenzdaten
* MAXREF, Maximalwert der Referenzdaten
* MINREF, Minimalwert der Referenzdaten
* MEANVAR, Mittelwert der Variantendaten
* MAXVAR, Maximalwert der Variantendaten
* MINVAR, Minimalwert der Variantendaten
* ME, Mittelwert der Fehler (var-ref)
* MAXDIF, Maximalwert der Fehler (var-ref)
* MINDIF, Minimalwert der Fehler (var-ref)
* MAE, Mittlerer, absoluter Fehler (var-ref)
* RMSE, Root mean square Error, Wurzel aus der Summe aller quadrierten Fehler
* BIAS, Differenz der Mittelwerte von Referenz und Variante (mean(var)-mean(ref))
* MSE, Mittlerer, quadrierter Fehler
* R, Pearson Korrelation
* R^2, Bestimmtheitsmaß (Quadrat der Pearson Korrelation)
* MURPHYSKILL, Skill Score nach Murphy (1988)
* d_ 1981, Skill Score nach [https://doi.org/10.1002/joc.2419 Willmott (1981)]
* d_ 1985, Skill Score nach [https://doi.org/10.1002/joc.2419 Willmott (1985)]
* d_2012, Skill Score nach [https://doi.org/10.1002/joc.2419 Willmott (2012)]
* M, Steigung einer linearen Regression aus (var,ref i.e., x,y)
* B, y-Achsen Abschnitt einer linearen Regression aus (var,ref i.e., x,y)
* STDVAR, Standardabweichung Variantendaten
* STDREF, Standardabweichung Referenzdaten
* STDDIF, Standardabweichung Fehler


===Anmerkungen===
===Anmerkungen===
# Allgemeine Anforderungen:
# Allgemeine Anforderungen:
#* Es müssen Modelldaten angegeben werden. Werden keine Messdaten vorgegeben läuft das Programm ohne Ergebnis ab.
#* Für alle Toleranzen und Bounds werden im Examplesbereich sinnvolle  Werte vorgegeben, die erst im Zweifelsfall modifiziert werden sollten
#* Alle Ploteigenschaften können, müssen aber nicht angegeben werden.
#* Alle Ploteigenschaften können, müssen aber nicht angegeben werden.
#* Bei einem Vergleich mit Seegangsdaten müssen die flächigen Ergebnisdaten der Hydrodynamik und des Seegangs jeweils vorliegen.
#* Nach aktuellem Stand (02.05.2019) sind das Taylor-und das Targetdiagramm noch nicht implementiert.
      
      
|nutzerprogramme=[[NCPOLO]]
|nutzerprogramme=[[NCPOLO]]
Zeile 93: Zeile 84:
|dateiendung=.dat
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor  
|schreibmodule=interaktive Erstellung, Editor  
|lesemodule=$PROGHOME/matlab/gitlab/prg/ncpolo/for_redistribution_files_only/*
|lesemodule=$PROGHOME/matlab/gitlab/prg/ncpolo/*
|kontakt_original=[mailto:robert.hagen@baw.de R. Hagen], [mailto:maurice.jurke@baw.de M. Jurke]
|kontakt_original=[mailto:robert.hagen@baw.de R. Hagen]
|kontakt_pflege=[mailto:robert.hagen@baw.de R. Hagen]
|kontakt_pflege=[mailto:robert.hagen@baw.de R. Hagen]
|beispieldatei=$PROGHOME/examples/ncpolo/ncpolo.dat   
|beispieldatei=$PROGHOME/examples/ncpolo/ncpolo_steer.dat   
}}
}}

Aktuelle Version vom 22. September 2021, 06:49 Uhr

Basisinformationen

Datei-Typ

ncpolo.dat

Datei-Form

none

Version

September 2021

Beschreibung

September 2021

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NCPOLO

Datei-Inhalt

Eingabesteuerdaten

  • Block 1 Properties
    1. identifier: Eindeutiger Bezeichner für den Output (z.B. run001)
    2. outlier_check: (opt) Durchführen eines Ausreißercheck mit MATLAB isoutlier(data,6)
    3. plot_linewidth: (opt) Dicke der Achsenumrandung (default 1.5)
  • Block 2 input: Eingabewerte (kann beliebig oft angegeben werden)
    1. infile: Name des Eingangsdatensatzes cf-netcdf.nc Format aus NCDELTA
    2. refname: Bezeichner für die Referenzdaten aus NCDELTA
    3. varname: Bezeichner für die Variantendaten aus NCDELTA
    4. variable: Skalare Variablenname der auszuwertenden Variable (ohne ODdif, OCvar oder OCref)
    5. variable_xy: Vektorielle Variablennamen der auszuwertenden Variable (ohne ODdif, OCvar oder OCref, nur für Hodographen)
    6. export_dir: Ausgabeordner (wird automatisch erstellt)
    7. fraction: Index oder Name der darzustellenden Fraktion (z.B. 2 oder very_fine_silt)
    8. time_series: (opt) true/false, ob Darstellung erfolgen soll
    9. scatterplot: (opt) true/false, ob Darstellung erfolgen soll
    10. hodograph: (opt) true/false, ob Darstellung erfolgen soll
    11. error_distr: (opt) true/false, ob Darstellung erfolgen soll
    12. boxplot: (opt) true/false, ob Darstellung erfolgen soll
    13. time_focus: (opt) Angabe von Detailzeiträumen für Zeitreihen im Format ddmmyy ddmmyy ddmmyy ddmmyy ... (Start Ende Start End, ...) - maximal 5 Zeiträume möglich.
    14. tsBounds: (opt) y-Limits für time_series - kein Einfluss auf Datenverarbeitung
    15. scatBounds: (opt) y-Limits für scatterplot - kein Einfluss auf Datenverarbeitung
    16. hodoBounds: (opt) y-Limit für Hodograph (nur eine Angabe erf.) - kein Einfluss auf Datenverarbeitung
    17. errorBounds: (opt) y-Limits für error_distr - kein Einfluss auf Datenverarbeitung
    18. boxBounds: (opt) y-Limits für boxplot - kein Einfluss auf Datenverarbeitung
    19. stat_all: (opt) Aktiviert den Statistiküberblickexport für die Formate xlsx csv mat
  • Block 3a-e Ploteigenschaften: Festlegen der Ploteigenschaften

In diesem Block werden je Darstellungstyp diverse Ploteigenschaften angeboten. Die Angabemöglichkeiten sind für dieses Programmkennblatt zu zahlreich und werden in der Steuerdatei zu NCPOLO beschrieben. Weitestgehend umschrieben enthalten diese Eingangsparameter:

  • Breite und Höhe
  • MATLAB LineSpec
  • Textgestaltung
  • Ausgabeformat
  • Beschriftungsart
  • Gitternetz und Hilfslinien
  • Skillscores im Plot
  • Fitting Options (Scatterplot, Hodograph)
  • Optionen zur farblichen Gestaltung der Dichtefunktion von Scatterplot bzw. Hodograph

Statistische Kennwerte

  • MEANREF, Mittelwert der Referenzdaten
  • MAXREF, Maximalwert der Referenzdaten
  • MINREF, Minimalwert der Referenzdaten
  • MEANVAR, Mittelwert der Variantendaten
  • MAXVAR, Maximalwert der Variantendaten
  • MINVAR, Minimalwert der Variantendaten
  • ME, Mittelwert der Fehler (var-ref)
  • MAXDIF, Maximalwert der Fehler (var-ref)
  • MINDIF, Minimalwert der Fehler (var-ref)
  • MAE, Mittlerer, absoluter Fehler (var-ref)
  • RMSE, Root mean square Error, Wurzel aus der Summe aller quadrierten Fehler
  • BIAS, Differenz der Mittelwerte von Referenz und Variante (mean(var)-mean(ref))
  • MSE, Mittlerer, quadrierter Fehler
  • R, Pearson Korrelation
  • R^2, Bestimmtheitsmaß (Quadrat der Pearson Korrelation)
  • MURPHYSKILL, Skill Score nach Murphy (1988)
  • d_ 1981, Skill Score nach Willmott (1981)
  • d_ 1985, Skill Score nach Willmott (1985)
  • d_2012, Skill Score nach Willmott (2012)
  • M, Steigung einer linearen Regression aus (var,ref i.e., x,y)
  • B, y-Achsen Abschnitt einer linearen Regression aus (var,ref i.e., x,y)
  • STDVAR, Standardabweichung Variantendaten
  • STDREF, Standardabweichung Referenzdaten
  • STDDIF, Standardabweichung Fehler

Anmerkungen

  1. Allgemeine Anforderungen:
    • Alle Ploteigenschaften können, müssen aber nicht angegeben werden.

Programme, welche diesen Datei-Typ benutzen

NCPOLO

Beispiel-Datei

$PROGHOME/examples/ncpolo/ncpolo_steer.dat

zurück zu: Dateikennblätter

Strukturübersicht

Abgerufen von „https://wiki.baw.de/de/index.php?title=NCPOLO.DAT&oldid=35186“