Aktionen

NCPOLO.DAT: Unterschied zwischen den Versionen

Aus BAWiki

imported>Hagen Robert
KKeine Bearbeitungszusammenfassung
imported>Hagen Robert
Keine Bearbeitungszusammenfassung
Zeile 8: Zeile 8:
'''Eingabesteuerdaten'''
'''Eingabesteuerdaten'''


* Block '''Program_Parameters''': Allgemeine Steuerdaten
* '''Block 1 Messdaten''': Eingabewerte Messung
*# '''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]].
*# '''MEAS_WL''': Messdaten Wasserstand im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# '''Max_Distance''': maximaler Abstand in [m] bis zu dem Punkte mit unterschiedlicher Lage verglichen werden.
*# '''MEAS_CU''': Messdaten Strömung im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*# (optional) '''Print_Modus_Classify''': Modus der informativen Druckerausgabe im Programmteil ''Klassifikation'':
*# '''MEAS_SA''': Messdaten Salzgehalt im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''MEAS_TE''': Messdaten Temperatur im [[CF-NETCDF.NC|cf-netcdf.nc]] Format
*## '''1''' = Variablen-Klassifizierung der Eingangsdateien in die SDR-Datei schreiben.  
*# '''MEAS_SW''': Messdaten sig. Wellenhöhe im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])
*# (optional) '''Print_Modus_Pairs''': Modus der informativen Druckerausgabe im Programmteil ''Primäre Partnervariable'':
*# '''MEAS_PP''': Messdaten Peak Wellenperiode im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''MEAS_MP''': Messdaten mit. Wellenperiode im [[CF-NETCDF.NC|cf-netcdf.nc]] Format (siehe auch [[Kennwerte des Seegangs]])
*## '''1''' = nur Testergebnisse der gefundenen Variablen-Paare werden in die SDR-Datei geschrieben;
 
*## '''2''' = auch Testergebnisse verworfener Kandidaten werden in die SDR-Datei geschrieben.
* '''Block 2 Modelldaten''': Eingabewerte Modellergebnisse
*# (optional) '''Print_Modus_Define''': Modus der informativen Druckerausgabe im Programmteil ''Definition Berechnungsergebnisse'':
*# '''MOD_ARE''': Gechunkte (siehe [[NCCHUNKIE]]), flächige, 2D [[UNTRIM2007]] oder [[UNTRIM2]] Ergebnisdatei
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''MOD_UNK''': Gechunkte (siehe [[NCCHUNKIE]]), flächige, 2D [[UNK]] Ergebnisdatei
*## '''1''' = Informationen zu den Metadaten der Ergebnisdaten in die SDR-Datei schreiben.  
 
*# (optional) '''Print_Modus_Compute''': Modus der informativen Druckerausgabe im Programmteil ''Berechnung der Ergebnisse'':
* '''Block 3 Exportverzeichnis''': Festlegen der Exportverzeichnisse
*## '''0''' = keine ausführliche Ausgabe auf Drucker;
*# '''EXPORTDIR_WL''': Exportpfad aller Wasserstands bezogener [[NCPOLO]] Ausgaben.
*## '''1''' = Informationen zu den Ergebnisdaten in die SDR-Datei schreiben.
*# '''EXPORTDIR_CU''': Exportpfad aller Strömungs bezogener [[NCPOLO]] Ausgaben.
*# (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
*# '''EXPORTDIR_SA''': Exportpfad aller Salzgehalts bezogener [[NCPOLO]] Ausgaben.
*# (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:
*# '''EXPORTDIR_TE''': Exportpfad aller Temperatur bezogener [[NCPOLO]] Ausgaben.
*#* 4 = '''NF90_64BIT_OFFSET''' (NetCDF-Datei mit 64Bit, kein HDF - keine Online-Kompression);
*# '''EXPORTDIR_TU''': Exportpfad aller Schwebstoff bezogener [[NCPOLO]] Ausgaben.
*#* 5 = '''NF90_CLASSIC_MODEL''' (HDF-Datei ohne Nutzung der erweiterten HDF-Möglichkeiten - mit Online-Kompression).
*# '''EXPORTDIR_SW''': Exportpfad aller sig. Wellenhöhe bezogener [[NCPOLO]] Ausgaben.
* Block '''Data_Files''': Dateien
*# '''EXPORTDIR_PP''': Exportpfad aller Peak Wellenperiode bezogener [[NCPOLO]] Ausgaben.
*# '''Reference_File''': Datei (NETCDF) mit '''Referenz'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
*# '''EXPORTDIR_MP''': Exportpfad aller mittl. Wellenperiode bezogener [[NCPOLO]] Ausgaben.
*# '''Variant_File''': Datei (NETCDF) mit '''Varianten'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
 
*# '''Result_File''': Datei (NETCDF) für '''Ergebnis'''-Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]);
* '''Block 4 Eingangsparameter''': Festlegen relevanter Parameter
*# (optional) '''Reference_Period''': Start- und Enddatum der Vergleichsperiode für die Referenz-Daten (nur für synoptische Daten);
*# '''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.
*# (optional) '''Variant_Period''': Start- und Enddatum der Vergleichsperiode für die Varianten-Daten (nur für synoptische Daten);
*# '''maxDIST''': Gibt in Metern an, wie weit die Messung maximal von der nächsten Edge bzw. dem nächsten Face entfernt sein darf.
* (optional) Block '''Data_Operations''': Datenoperationen
*# '''WLBOUNDS''': Unteres und oberes Limit für die Darstellung von Wasserstand. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Ordinary_Differences''': Gewöhnliche Differenzen (falls möglich) berechnen (.true.) oder nicht berechnen (.false.);
*# '''CUBOUNDS''': Unteres und oberes Limit für die Darstellung von Strömung. Die Angabe von AUTO wählt die Bounds automatisch.
*# (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;
*# '''SABOUNDS''': Unteres und oberes Limit für die Darstellung von Salzgehalt. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Median''': Median (>=32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# '''TEBOUNDS''': Unteres und oberes Limit für die Darstellung von Temperatur. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Percentiles_05_95''': Perzentile Q05, Q95 (>= 32 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# '''TUBOUNDS''': Unteres und oberes Limit für die Darstellung von Schwebstoff. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Percentiles_01_99''': Perzentile Q01, Q99 (>= 51 Ereignisse) berechnen (.true.) oder nicht berechnen (.false.);
*# '''SWBOUNDS''': Unteres und oberes Limit für die Darstellung von sig. Wellenhöhe. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Skill_Murphy_1988''': Skill nach Murphy (1988) Gleichung 4;
*# '''PPBOUNDS''': Unteres und oberes Limit für die Darstellung von Peak Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
*# (optional) '''With_Original_Data''': Kopie der für die Berechnung der gewöhnlichen Differenzen benutzten Eingangsdaten.
*# '''MPBOUNDS''': Unteres und oberes Limit für die Darstellung von mit. Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
* (optional) Block '''Exclude_Variable_From_NCDELTA''': Liste der auszuschließenden Variablen.
*# '''WLTOL''': Messungenauigkeit des Wasserstands zur Berechnung von ARMAE und ARRMSE.
*# '''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.
*# '''CUTOL''': Messungenauigkeit der Strömung zur Berechnung von ARMAE und ARRMSE.
* (optional) Block '''Include_Only_Variable_for_NCDELTA''': Liste der exklusiv zu bearbeitenden Variablen.
*# '''SATOL''': Messungenauigkeit des Salzgehalts zur Berechnung von ARMAE und ARRMSE.
*# '''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.
*# '''TETOL''': Messungenauigkeit der Temperatur zur Berechnung von ARMAE und ARRMSE.
* (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.
*# '''TUTOL''': Messungenauigkeit des Schwebstoffgehalts zur Berechnung von ARMAE und ARRMSE.
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
*# '''SWTOL''': Messungenauigkeit der sig. Wellenhöhe zur Berechnung von ARMAE und ARRMSE.
* (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.
*# '''PPTOL''': Messungenauigkeit der Peak Wellenperiode zur Berechnung von ARMAE und ARRMSE.
*# '''Variable''': Name einer Variablen aus dem ''Variant-File'' oder dem ''Reference_File''. Key kann mehrfach angegeben werden.
*# '''MPTOL''': Messungenauigkeit der mit. Wellenperiode zur Berechnung von ARMAE und ARRMSE.
* (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.
*# '''Variant_Label_KV''': Name einer Label-Koordinatenvariable aus ''Variant_File'' oder ''NONE''.
*# '''Reference_Label_KV''': Name einer Label-Koordinatenvariable aus ''Reference_File'' oder ''NONE''.
*# '''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.


===Anmerkungen===
===Anmerkungen===

Version vom 2. Mai 2019, 04:59 Uhr

Basisinformationen

Datei-Typ

ncpolo.dat

Datei-Form

FORMATTED

Version

Mai 2019

Beschreibung

Mai 2019

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NCPOLO

Datei-Inhalt

Eingabesteuerdaten

  • Block 2 Modelldaten: Eingabewerte Modellergebnisse
    1. MOD_ARE: Gechunkte (siehe NCCHUNKIE), flächige, 2D UNTRIM2007 oder UNTRIM2 Ergebnisdatei
    2. MOD_UNK: Gechunkte (siehe NCCHUNKIE), flächige, 2D UNK Ergebnisdatei
  • Block 3 Exportverzeichnis: Festlegen der Exportverzeichnisse
    1. EXPORTDIR_WL: Exportpfad aller Wasserstands bezogener NCPOLO Ausgaben.
    2. EXPORTDIR_CU: Exportpfad aller Strömungs bezogener NCPOLO Ausgaben.
    3. EXPORTDIR_SA: Exportpfad aller Salzgehalts bezogener NCPOLO Ausgaben.
    4. EXPORTDIR_TE: Exportpfad aller Temperatur bezogener NCPOLO Ausgaben.
    5. EXPORTDIR_TU: Exportpfad aller Schwebstoff bezogener NCPOLO Ausgaben.
    6. EXPORTDIR_SW: Exportpfad aller sig. Wellenhöhe bezogener NCPOLO Ausgaben.
    7. EXPORTDIR_PP: Exportpfad aller Peak Wellenperiode bezogener NCPOLO Ausgaben.
    8. EXPORTDIR_MP: Exportpfad aller mittl. Wellenperiode bezogener NCPOLO Ausgaben.
  • Block 4 Eingangsparameter: Festlegen relevanter Parameter
    1. 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.
    2. maxDIST: Gibt in Metern an, wie weit die Messung maximal von der nächsten Edge bzw. dem nächsten Face entfernt sein darf.
    3. WLBOUNDS: Unteres und oberes Limit für die Darstellung von Wasserstand. Die Angabe von AUTO wählt die Bounds automatisch.
    4. CUBOUNDS: Unteres und oberes Limit für die Darstellung von Strömung. Die Angabe von AUTO wählt die Bounds automatisch.
    5. SABOUNDS: Unteres und oberes Limit für die Darstellung von Salzgehalt. Die Angabe von AUTO wählt die Bounds automatisch.
    6. TEBOUNDS: Unteres und oberes Limit für die Darstellung von Temperatur. Die Angabe von AUTO wählt die Bounds automatisch.
    7. TUBOUNDS: Unteres und oberes Limit für die Darstellung von Schwebstoff. Die Angabe von AUTO wählt die Bounds automatisch.
    8. SWBOUNDS: Unteres und oberes Limit für die Darstellung von sig. Wellenhöhe. Die Angabe von AUTO wählt die Bounds automatisch.
    9. PPBOUNDS: Unteres und oberes Limit für die Darstellung von Peak Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
    10. MPBOUNDS: Unteres und oberes Limit für die Darstellung von mit. Wellenperiode. Die Angabe von AUTO wählt die Bounds automatisch.
    11. WLTOL: Messungenauigkeit des Wasserstands zur Berechnung von ARMAE und ARRMSE.
    12. CUTOL: Messungenauigkeit der Strömung zur Berechnung von ARMAE und ARRMSE.
    13. SATOL: Messungenauigkeit des Salzgehalts zur Berechnung von ARMAE und ARRMSE.
    14. TETOL: Messungenauigkeit der Temperatur zur Berechnung von ARMAE und ARRMSE.
    15. TUTOL: Messungenauigkeit des Schwebstoffgehalts zur Berechnung von ARMAE und ARRMSE.
    16. SWTOL: Messungenauigkeit der sig. Wellenhöhe zur Berechnung von ARMAE und ARRMSE.
    17. PPTOL: Messungenauigkeit der Peak Wellenperiode zur Berechnung von ARMAE und ARRMSE.
    18. MPTOL: Messungenauigkeit der mit. Wellenperiode zur Berechnung von ARMAE und ARRMSE.

Anmerkungen

  1. Benutzte Dictionary-Dateien aus dem Verzeichnis $PROGHOME/dic/:
    • ncdelta_dico.dat.
  2. 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.
  3. Allgemeine Anforderungen:
    • synoptische Daten:
      • 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 CF Metadaten Konvention).
  4. 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.

Programme, welche diesen Datei-Typ benutzen

NCDELTA

Beispiel-Datei

$PROGHOME/examples/ncdelta/ncdelta.dat


zurück zu: Dateikennblätter


Strukturübersicht