Aktionen

NCPOLO.DAT: Unterschied zwischen den Versionen

Aus BAWiki

imported>Hagen Robert
KKeine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(7 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 '''Program_Parameters''': Allgemeine Steuerdaten
* '''Block 1 Properties'''
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Analysezyklus gelesen, gespeichert und verarbeitet werden können. Dieser Wert, multipliziert mit 24 (REAL Single) oder 48 (REAL Double), bezeichnet in etwa den Memory-Bedarf in Byte für [[NCDELTA]].
*# '''identifier''': Eindeutiger Bezeichner für den Output (z.B. run001)
*# '''Max_Distance''': maximaler Abstand in [m] bis zu dem Punkte mit unterschiedlicher Lage verglichen werden.
*# '''outlier_check''': (opt) Durchführen eines Ausreißercheck mit [https://de.mathworks.com/help/matlab/ref/isoutlier.html MATLAB isoutlier(data,6)]
*# (optional) '''Print_Modus_Classify''': Modus der informativen Druckerausgabe im Programmteil ''Klassifikation'':
*# '''plot_linewidth''': (opt) Dicke der Achsenumrandung (default 1.5)
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
 
*## '''1''' = Variablen-Klassifizierung der Eingangsdateien in die SDR-Datei schreiben.  
* '''Block 2 input''': Eingabewerte (kann beliebig oft angegeben werden)
*# (optional) '''Print_Modus_Pairs''': Modus der informativen Druckerausgabe im Programmteil ''Primäre Partnervariable'':
*# '''infile''': Name des Eingangsdatensatzes [[CF-NETCDF.NC|cf-netcdf.nc]] Format aus [[NCDELTA]]
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''refname''': Bezeichner für die Referenzdaten aus [[NCDELTA]]
*## '''1''' = nur Testergebnisse der gefundenen Variablen-Paare werden in die SDR-Datei geschrieben;
*# '''varname''': Bezeichner für die Variantendaten aus [[NCDELTA]]
*## '''2''' = auch Testergebnisse verworfener Kandidaten werden in die SDR-Datei geschrieben.
*# '''variable''': Skalare Variablenname der auszuwertenden Variable ('''ohne''' ODdif, OCvar oder OCref)
*# (optional) '''Print_Modus_Define''': Modus der informativen Druckerausgabe im Programmteil ''Definition Berechnungsergebnisse'':
*# '''variable_xy''': Vektorielle Variablennamen der auszuwertenden Variable ('''ohne''' ODdif, OCvar oder OCref, nur für Hodographen)
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''export_dir''': Ausgabeordner (wird automatisch erstellt)
*## '''1''' = Informationen zu den Metadaten der Ergebnisdaten in die SDR-Datei schreiben.
*# '''fraction''': Index oder Name der darzustellenden Fraktion (z.B. 2 oder very_fine_silt)
*# (optional) '''Print_Modus_Compute''': Modus der informativen Druckerausgabe im Programmteil ''Berechnung der Ergebnisse'':
*# '''time_series''': (opt) true/false, ob Darstellung erfolgen soll
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''scatterplot''': (opt) true/false, ob Darstellung erfolgen soll
*## '''1''' = Informationen zu den Ergebnisdaten in die SDR-Datei schreiben.
*# '''hodograph''': (opt) true/false, ob Darstellung erfolgen soll
*# (optional) '''NC_Deflate_Level''': ''deflate level'' (0,1,2,...,9) für die Online-Kompression der Daten beim Schreiben. 0 bedeutet keine Kompression, 9 maximale Kompression
*# '''error_distr''': (opt) true/false, ob Darstellung erfolgen soll
*# (optional) '''NC_Cmode_Id''': ''creation mode flag'' der [[NetCDF|CF NetCDF]] Methode  [https://www.unidata.ucar.edu/software/netcdf/netcdf-4/newdocs/netcdf-f90/NF90_005fCREATE.html NF90_CREATE]. Typische Werte für diese Anwendung sind:
*# '''boxplot''': (opt) true/false, ob Darstellung erfolgen soll
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF-Datei mit 64Bit, kein HDF - keine Online-Kompression);
*# '''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.
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF-Datei ohne Nutzung der erweiterten HDF-Möglichkeiten - mit Online-Kompression).
*# '''tsBounds''': (opt) y-Limits für time_series - kein Einfluss auf Datenverarbeitung
* Block '''Data_Files''': Dateien
*# '''scatBounds''': (opt) y-Limits für scatterplot - kein Einfluss auf Datenverarbeitung
*# '''Reference_File''': Datei (NETCDF) mit '''Referenz'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''hodoBounds''': (opt) y-Limit für Hodograph (nur eine Angabe erf.) - kein Einfluss auf Datenverarbeitung
*# '''Variant_File''': Datei (NETCDF) mit '''Varianten'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''errorBounds''': (opt) y-Limits für error_distr - kein Einfluss auf Datenverarbeitung
*# '''Result_File''': Datei (NETCDF) für '''Ergebnis'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''boxBounds''': (opt) y-Limits für boxplot - kein Einfluss auf Datenverarbeitung
*# (optional) '''Reference_Period''': Start- und Enddatum der Vergleichsperiode für die Referenz-Daten (nur für synoptische Daten);
*# '''stat_all''': (opt) Aktiviert den Statistiküberblickexport für die Formate xlsx csv mat
*# (optional) '''Variant_Period''': Start- und Enddatum der Vergleichsperiode für die Varianten-Daten (nur für synoptische Daten);
 
* (optional) Block '''Data_Operations''': Datenoperationen
* '''Block 3a-e Ploteigenschaften''': Festlegen der Ploteigenschaften
*# (optional) '''With_Ordinary_Differences''': Gewöhnliche Differenzen (falls möglich) berechnen (.true.) oder nicht berechnen (.false.);
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:
*# (optional) '''With_Taylor_Diagram_Data''': Daten für Taylor-Diagramm (falls möglich) berechnen (.true.) oder nicht berechnen (.false.); inklusive Skill nach Taylor (2001) Gleichungen 4 und 5;
 
*# (optional) '''With_Median''': Median (>=32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
* Breite und Höhe
*# (optional) '''With_Percentiles_05_95''': Perzentile Q05, Q95 (>= 32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
* [[MATLAB]] LineSpec
*# (optional) '''With_Percentiles_01_99''': Perzentile Q01, Q99 (>= 51 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
* Textgestaltung
*# (optional) '''With_Skill_Murphy_1988''': Skill nach Murphy (1988) Gleichung 4;
* Ausgabeformat
*# (optional) '''With_Original_Data''': Kopie der für die Berechnung der gewöhnlichen Differenzen benutzten Eingangsdaten.
* Beschriftungsart
* (optional) Block '''Exclude_Variable_From_NCDELTA''': Liste der auszuschließenden Variablen.
* Gitternetz und Hilfslinien
*# '''Variant_Variable''': Name einer Variablen aus dem ''Variant-File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen werden alle vom Programm ermittelten primären Variablenpaare ausgewertet.
* Skillscores im Plot
* (optional) Block '''Include_Only_Variable_for_NCDELTA''': Liste der exklusiv zu bearbeitenden Variablen.
* Fitting Options (Scatterplot, Hodograph)
*# '''Variant_Variable''': Name einer Variablen aus dem ''Variant-File''. Key kann mehrfach angegeben werden. Mit Ausnahme der hier genannten Variablen keine weiteren vom Programm ermittelten primären Variablenpaare ausgewertet.
* Optionen zur farblichen Gestaltung der Dichtefunktion von Scatterplot bzw. Hodograph
* (optional) Block '''No_Normal_Vector_Variable''': Die Liste der Variablen, die Normalen-Vektoren sind wird (weitestgehend) automatisch von [[NCDELTA]] erzeugt. Bislang können nicht alle sicher erkannt werden. Mit dieser Liste werden Variablen von der Zugehörigkeit zur Klasse der Normalen-Vektor-Variablen '''''ausgeschlossen''''', falls deren automatische Zurodnung fehlerhaft ist.
 
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
===Statistische Kennwerte===
* (optional) Block '''Normal_Vector_Variable''': Die Liste der Variablen, die Normalen-Vektoren sind wird (weitestgehend) automatisch von [[NCDELTA]] erzeugt. Bislang können nicht alle sicher erkannt werden. Mit dieser Liste werden Variablen in die Zugehörigkeit zur Klasse der Normalen-Vektor-Variablen '''''eingeschlossen''''', falls deren automatische Zurodnung fehlerhaft ist.
 
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
* MEANREF, Mittelwert der Referenzdaten
* (optional) Block '''Label_Relation''': Für den Vergleich ''fraktionierter'' Variable, für die ein Zusammenhang zwischen den einzelnen ''Fraktionen'' (Sediment, Partialtide. usw.) nicht automatisch hergestellt werden kann, muss der Zusammenhang vom Anwender vorgegeben werden. Block kann mehrfach angegeben werden.
* MAXREF, Maximalwert der Referenzdaten
*# '''Variant_Label_KV''': Name einer Label-Koordinatenvariable aus ''Variant_File'' oder ''NONE''.
* MINREF, Minimalwert der Referenzdaten
*# '''Reference_Label_KV''': Name einer Label-Koordinatenvariable aus ''Reference_File'' oder ''NONE''.
* MEANVAR, Mittelwert der Variantendaten
*# '''Relation''': ''Name der ''Fraktion'' im Variant_File'' ''':''' ''Name der ''Fraktion'' im Reference_File''. Key kann mehrfach angegeben werden. Für den Namen ist ''NONE'' anzugeben, falls keine entsprechende Label-Koordinatenvariable vorhanden ist. Der Doppelpunkt dient als Trennzeichen.
* 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===
# 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“