Aktionen

NCPOLO.DAT: Unterschied zwischen den Versionen

Aus BAWiki

imported>Hagen Robert
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(6 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
* Breite und Höhe
*# '''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.
* [[MATLAB]] LineSpec
*# '''maxDIST''': Gibt in Metern an, wie weit die Messung maximal von der nächsten Edge bzw. dem nächsten Face entfernt sein darf.
* Textgestaltung
*# '''WLBOUNDS''': Unteres und oberes Limit für die Darstellung von Wasserstand. Die Angabe von AUTO wählt die Bounds automatisch.
* Ausgabeformat
*# '''CUBOUNDS''': Unteres und oberes Limit für die Darstellung von Strömung. Die Angabe von AUTO wählt die Bounds automatisch.
* Beschriftungsart
*# '''SABOUNDS''': Unteres und oberes Limit für die Darstellung von Salzgehalt. Die Angabe von AUTO wählt die Bounds automatisch.
* Gitternetz und Hilfslinien
*# '''TEBOUNDS''': Unteres und oberes Limit für die Darstellung von Temperatur. Die Angabe von AUTO wählt die Bounds automatisch.
* Skillscores im Plot
*# '''TUBOUNDS''': Unteres und oberes Limit für die Darstellung von Schwebstoff. Die Angabe von AUTO wählt die Bounds automatisch.
* Fitting Options (Scatterplot, Hodograph)
*# '''SWBOUNDS''': Unteres und oberes Limit für die Darstellung von sig. Wellenhöhe. Die Angabe von AUTO wählt die Bounds automatisch.
* Optionen zur farblichen Gestaltung der Dichtefunktion von Scatterplot bzw. Hodograph
*# '''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.
===Statistische Kennwerte===
*# '''WLTOL''': Messungenauigkeit des Wasserstands zur Berechnung von ARMAE und ARRMSE.
 
*# '''CUTOL''': Messungenauigkeit der Strömung zur Berechnung von ARMAE und ARRMSE.
* MEANREF, Mittelwert der Referenzdaten
*# '''SATOL''': Messungenauigkeit des Salzgehalts zur Berechnung von ARMAE und ARRMSE.
* MAXREF, Maximalwert der Referenzdaten
*# '''TETOL''': Messungenauigkeit der Temperatur zur Berechnung von ARMAE und ARRMSE.
* MINREF, Minimalwert der Referenzdaten
*# '''TUTOL''': Messungenauigkeit des Schwebstoffgehalts zur Berechnung von ARMAE und ARRMSE.
* MEANVAR, Mittelwert der Variantendaten
*# '''SWTOL''': Messungenauigkeit der sig. Wellenhöhe zur Berechnung von ARMAE und ARRMSE.
* MAXVAR, Maximalwert der Variantendaten
*# '''PPTOL''': Messungenauigkeit der Peak Wellenperiode zur Berechnung von ARMAE und ARRMSE.
* MINVAR, Minimalwert der Variantendaten
*# '''MPTOL''': Messungenauigkeit der mit. Wellenperiode zur Berechnung von ARMAE und ARRMSE.
* 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===
# Benutzte '''Dictionary-Dateien''' aus dem Verzeichnis '''''$PROGHOME/dic/''''':
#* '''''ncdelta_dico.dat'''''.
# Anwendungsmöglichkeiten:
#* Fall 1: '''Reference_File''' = Simulation 1, '''Variant_File''' = Simulation 2;
#* Fall 2: '''Reference_File''' = Messung, '''Variant_File''' = Simulation;
#* Fall 3: '''Reference_File''' = Messung 1, '''Variant_File''' = Messung 2;
#: Es können entweder jeweils synoptische Daten ''oder'' Ergebnisse des Programms [[NCANALYSE]] verwendet werden.
# Allgemeine Anforderungen:
# Allgemeine Anforderungen:
#* synoptische Daten:
#* Alle Ploteigenschaften können, müssen aber nicht angegeben werden.
#** Zeitraum muss gleich lang (nicht identisch) sein, und
#** Zeitschritt muss identisch sein.
#* Analyseergebnisse ([[NCANALYSE]]):
#** Analysezeitraum muss von vergleichbarer Länge sein, und
#** Anzahl der Ereignisse, z.B. Thw, muss identisch sein.
#* Z-Koordinatenvariablen: 
#: z-Koordinaten-Variablen müssen, soweit vorhanden, entweder
#:* alle mit (CF-Attribut) positive = "down", oder
#:* alle mit (CF-Attribut) positive = "up"
#: vorliegen (siehe [http://cfconventions.org/ CF Metadaten Konvention]).
# Spezielle Anforderungen:
#* zu Fall 1:
#** gleiche Vertikalstruktur (Anzahl der Schichten), und
#** gleiche (Tracer-) Fraktionen (falls vorhanden).
#* zu Fall 2:
#** gleiche (Tracer-) Fraktionen (falls vorhanden), und
#** in den Messdaten dürfen an derselben (Geo-) Position (x,y) mehrere Messergebnisse in verschiedenen Tiefen (z) vorhanden sein.
#* zu Fall 3:
#** (Geo-) Positionen (x,y) dürfen in jeder Datei jeweils nur einmal vorhanden sein; d.h., mehrere an einem Ort übereinander angeordnete Messergebnisse (verschiedene Tiefen (z) bei identischem (x,y)) werden von der aktuellen Version nicht unterstützt.
      
      
|nutzerprogramme=[[NCDELTA]]
|nutzerprogramme=[[NCPOLO]]
|programmiersprache=Fortran90
|programmiersprache=MATLAB
|dateiform=FORMATTED
|dateiform=none
|dateizugriff=SEQUENTIAL
|dateizugriff=none
|dateiendung=.dat
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor  
|schreibmodule=interaktive Erstellung, Editor  
|lesemodule=$PROGHOME/fortran/prg/ncdelta/*/mod_m_ncdelta_steer.f90
|lesemodule=$PROGHOME/matlab/gitlab/prg/ncpolo/*
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_original=[mailto:robert.hagen@baw.de R. Hagen]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:robert.hagen@baw.de R. Hagen]
|beispieldatei=$PROGHOME/examples/ncdelta/ncdelta.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“