Aktionen

NCANALYSE.DAT: Unterschied zwischen den Versionen

Aus BAWiki

(neuer Key Gap_Fill)
K (update Version)
 
(6 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 2: Zeile 2:
|name_en=NCANALYSE.DAT
|name_en=NCANALYSE.DAT
|dateityp=ncanalyse.dat  
|dateityp=ncanalyse.dat  
|version=Februar 2020
|version=März 2023
|version_beschr=Februar 2020
|version_beschr=Oktober 2021
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCANALYSE]]
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCANALYSE]]
|dateiinhalt=
|dateiinhalt=
Zeile 32: Zeile 32:
*#: 1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
*#: 1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
*# (optional) '''Location_XY_EPSG''': EPSG-Code der in den Blöcken '''Location''' angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block '''Input_Files''') verwendet.
*# (optional) '''Location_XY_EPSG''': EPSG-Code der in den Blöcken '''Location''' angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block '''Input_Files''') verwendet.
*# (optional) '''Gap_Fill''': Steuerparameter für das Auffüllen von Datenlücken durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
*# (optional) '''Gap_Fill''': Steuerparameter für das Auffüllen von Datenlücken an Referenzpositionen durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
*#: 0 = Datenlücken werden nicht aufgefüllt (Default)
*#: 0 = Datenlücken werden nicht aufgefüllt (Default)
*#: 1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
*#: 1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
Zeile 39: Zeile 39:
*# '''End_Time''': Ende des Analysezeitraums.
*# '''End_Time''': Ende des Analysezeitraums.
* Block '''Input_Files''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
* Block '''Input_Files''': [[NetCDF|CF NetCDF]] Datei mit Eingangsdaten
*# '''Data_File''': Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]).
*# '''Data_File''': Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp [[CF-NETCDF.NC|cf-netcdf.nc]]). Optional kann als dritter Parameter auch noch angegeben werden, ob die Datei mit MPI COLLECTIVE I/O oder MPI INDEPENDENT I/O gelesen werden soll (relevant nur für die MPI-Version des Programms).
* Block '''Location''': Referenzpositionen (je Position ein Block).
* Block '''Location''': Referenzpositionen (je Position ein Block).
*# '''Name''': Name der Referenzposition.
*# '''Name''': Name der Referenzposition.
Zeile 70: Zeile 70:
*#* '''TDKB''' = [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*#* '''TDKB''' = [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
*#* '''TDKG''' = [[Tidekennwerte des Geschiebetransports]];
*#* '''TDKG''' = [[Tidekennwerte des Geschiebetransports]];
*#* '''TDKA''' = [[Tidekennwerte der Anomalie der Potentiellen Energie]];
*#* '''FRQW''' = [[Harmonische Analyse des Wasserstands|Harmonische Analyse des Wasserstands (Partialtiden)]];
*#* '''FRQW''' = [[Harmonische Analyse des Wasserstands|Harmonische Analyse des Wasserstands (Partialtiden)]];
*#* '''FRQV''' = [[Harmonische Analyse der Strömung|Harmonische Analyse der Strömung (Partialtiden)]];
*#* '''FRQV''' = [[Harmonische Analyse der Strömung|Harmonische Analyse der Strömung (Partialtiden)]];
Zeile 82: Zeile 83:
*#* '''LZKG''' = [[Tideunabhängige Kennwerte des Geschiebetransports]];
*#* '''LZKG''' = [[Tideunabhängige Kennwerte des Geschiebetransports]];
*#* '''LZKB''' = [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*#* '''LZKB''' = [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
*#* '''LZKA''' = [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
*#* '''LZXF''' = [[Tideunabhängige Kennwerte des Wassertransports]];
*#* '''LZXF''' = [[Tideunabhängige Kennwerte des Wassertransports]];
*#* '''LZXS''' = [[Tideunabhängige Kennwerte des Salztransports]];
*#* '''LZXS''' = [[Tideunabhängige Kennwerte des Salztransports]];
Zeile 115: Zeile 117:
** Optional für '''TDKB''':
** Optional für '''TDKB''':
*** Block '''TDKB_Quantiles''': Definition der Quantile.
*** Block '''TDKB_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''TDKA''':
*** Block '''TDKA_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Optional für '''FRQW''' und '''FRQV''':
** Optional für '''FRQW''' und '''FRQV''':
Zeile 170: Zeile 175:
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''Bedfriction_Quantiles''': Definition der Quantile.
*** Block '''Bedfriction_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZKA''':
*** Block '''PE_Anomaly_Bounds''': Definition der Klassen für die PEA.
***# '''Interval''': untere und obere Grenze der Klassen (Intervalle).
*** Block '''PE_Anomaly_Quantiles''': Definition der Quantile.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
***# '''Value''': Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
** Erforderlich für '''LZMW''':
** Erforderlich für '''LZMW''':
Zeile 199: Zeile 209:
#* '''TDKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
#* '''TDKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Wirkung der effektiven Bodenschubspannung|Tidekennwerte der effektiven Bodenschubspannung]];
#* '''TDKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Geschiebetransports]];
#* '''TDKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte des Geschiebetransports]];
#* '''TDKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tidekennwerte der Anomalie der Potentiellen Energie]];
#* '''FRQW_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse des Wasserstands|Partialtiden des Wasserstands]];
#* '''FRQW_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse des Wasserstands|Partialtiden des Wasserstands]];
#* '''FRQV_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse der Strömung|Partialtiden der Strömung]];
#* '''FRQV_ncanalyse_cfg.dat''': Datei mit Definition der [[Harmonische Analyse der Strömung|Partialtiden der Strömung]];
Zeile 211: Zeile 222:
#* '''LZKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Geschiebetransports]];
#* '''LZKG_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Geschiebetransports]];
#* '''LZKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
#* '''LZKB_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der effektiven Bodenschubspannung]];
#* '''LZKA_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte der Anomalie der Potentiellen Energie]];
#* '''LZXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wassertransports]];
#* '''LZXF_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Wassertransports]];
#* '''LZXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salztransports]];
#* '''LZXS_ncanalyse_cfg.dat''': Datei mit Definition der [[Tideunabhängige Kennwerte des Salztransports]];

Aktuelle Version vom 29. März 2023, 13:15 Uhr

Basisinformationen

Datei-Typ

ncanalyse.dat

Datei-Form

FORMATTED

Version

März 2023

Beschreibung

Oktober 2021

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NCANALYSE

Datei-Inhalt

Eingabesteuerdaten

  • Block Program_Parameters: Allgemeine Steuerdaten
    1. Max_Read_Storage: maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Analysezyklus gelesen, gespeichert und verarbeitet werden können.
    2. Min_Water_Depth: minimale Wasserbedeckung bis zu der Analysen durchgeführt werden.
    3. (optional) Create_Missing_Variables: zusätzliche (virtuelle) Variable erzeugen
      0 = nicht erzeugen (Default);
      1 = erzeugen (derzeit nur "magnitude_of_sea_water_velocity" für DFlow FM UGRID CF NetCDF).
    4. (optional) NC_Deflate_Level: Niveau (0 bis 9) der Online-Kompression beim Schreiben der Ergebnisdatei
      0 = keine Kompression (Default);
      5 = gute Kompression (Empfehlung);
      9 = höchste Stufe der Kompression.
    5. (optional) FRQ_use_j_v_correction: Korrektur der Nodaltide bei der Berechnung der Partialtiden
      .true. = Einfluss der Nodaltide korrigieren (Default)
      .false. = Einfluss der Nodaltide nicht korrigieren
    6. (optional) END_after_hrp: Beende den Programmlauf unmittelbar im Anschluss an die Analyse für die Referenzpositionen, vor dem Beginn der (eigentlichen) flächenhaften Analyse
      .true. = Programmlauf vorzeitig beenden
      .false. = Programmlauf vollständig durchführen (Default)
    7. (optional) CU_Zero_Slack: Grenzwert für Strömungsgeschwindigkeit in [m s-1] unterhalb der ein Richtungswechsel der Strömung (Kenterung) nicht ausgewertet wird. Typischer Weise werden Werte von 1 cm s-1 verwendet (diese sind in den Konfigurationsdateien für die verschiedenen Analysen voreingestellt). Als Kenterung wird eine Situation erkannt, falls die Geschwindigkeit größer als der Grenzwert ist und ein Richtungswechsel stattgefunden hat.
    8. (optional) Compute_FE_Ratio: Berechne Flut(strom):Ebbe(strom) Kenngrößen, falls solche mit <OPT:COMPUTE_FE_RATIO> in der Konfigurationsdatei markiert sind
      .true. = F:E-Kenngrößen berechnen
      .false. = F:E-Kenngrößen nicht berechnen (Default)
    9. (optional) CFG_Level: Einige Konfigurationsdateien enthalten Anweisungen der Art <OPT:CFG_Level_number> zur flexiblen Verwendung derselben Konfigurationsdatei für verschiedene Fragestellungen.
      0 = aktiviere Zeilen mit <OPT:CFG_Level_0> (Default)
      1 = aktiviere Zeilen mit <OPT:CFG_Level_1>
    10. (optional) Location_XY_EPSG: EPSG-Code der in den Blöcken Location angegebenen X- und Y-Koordinaten. Wird dieser Key nicht angegeben, so wird der EPSG-Code der Input-Daten (Block Input_Files) verwendet.
    11. (optional) Gap_Fill: Steuerparameter für das Auffüllen von Datenlücken an Referenzpositionen durch Interpolation. Wird dieser Key nicht angegeben, so werden Datenlücken (Wasserstand, Strömung) nicht automatisch aufgefüllt.
      0 = Datenlücken werden nicht aufgefüllt (Default)
      1 = Datenlücken werden durch Spline-Interpolation aufgefüllt
  • Block Data_Analysis_Period: Analysezeitraum
    1. Start_Time: Beginn des Analysezeitraums.
    2. End_Time: Ende des Analysezeitraums.
  • Block Input_Files: CF NetCDF Datei mit Eingangsdaten
    1. Data_File: Name und Typ (NETCDF) der Datei mit den zu analysierenden Daten (Dateityp cf-netcdf.nc). Optional kann als dritter Parameter auch noch angegeben werden, ob die Datei mit MPI COLLECTIVE I/O oder MPI INDEPENDENT I/O gelesen werden soll (relevant nur für die MPI-Version des Programms).
  • Block Location: Referenzpositionen (je Position ein Block).
    1. Name: Name der Referenzposition.
    2. Type: Typ der Referenzposition:
      • 0 = Referenzposition Tide (muss einmal angegeben werden);
      • 1 = Referenzposition Phase (muss einmal angegeben werden);
      • 2 = Hilfsposition (kann angegeben werden).
    3. X: x-Koordinate der Position (entweder X und Y oder LON und LAT angeben).
    4. Y: y-Koordinate der Position (entweder X und Y oder LON und LAT angeben).
    5. LON: geografische Länge der Position (entweder X und Y oder LON und LAT angeben).
    6. LAT: geografische Breite der Position (entweder X und Y oder LON und LAT angeben).
    7. Z: z-Koordinate der Position (nach Unten positiv).
    8. Rank: Rang der Position (nicht für Referenzposition Phase).
    9. Previous_Rank: Verweis auf den Rang der vorangehenden Position (nicht für Referenzposition Tide und Referenzposition Phase).
  • Block Input_Variables: Name(n) der zu analysierenden Variablen.
    1. Name: Name der zu analysierenden Variable (ist ein gültiger CF NetCDF Variablenname der Datei mit den Eingangsdaten).
  • Block Data_Analysis: Art der Analyse sowie CF NetCDF Datei für Analyseergebnisse
    1. Type: Typ der durchzuführenden Analyse:
    2. Result_File: Name und Typ (NETCDF) der Datei für die Analyseergebnisse (Dateityp cf-netcdf.nc).
  • Optionale Blöcke für verschiedene Analysen
    • Optional für TDKW:
      • Block TDKW_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKV:
      • Block TDKV_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKS oder TDWS
      • Block TDKS_Quantiles oder TDWS_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKT:
      • Block TDKT_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKC:
      • Block TDKC_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKP:
      • Block TDKP_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKG:
      • Block TDKG_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKB:
      • Block TDKB_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für TDKA:
      • Block TDKA_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Optional für FRQW und FRQV:
      • Block Tidal_Constituents: Liste der zu berechnenden Partialtiden.
        1. Value: Code der Partialtide, z. B. Mm, Mf, K_1, O_1, S_2, M_2, M_4, M_6, M_8.
  • Optional erforderliche Blöcke für verschiedene Analysen
    Um die Bounds, also die jeweiligen Intervallgrenzen für die Häufigkeitsverteilung optimal angeben zu können, sollte vorab der Wertebereich der physikalischen Größe ermittelt werden, z. B. mit dem Programm NCAUTO.
    • Erforderlich für LZKW:
      • Block Water_Level_Bounds: Definition der Wasserstandsklassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Water_Level_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKV:
      • Block Current_Velocity_Bounds: Definition der Strömungsklassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Current_Velocity_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKS:
      • Block Salinity_Bounds: Definition der Salzgehaltsklassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Salinity_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKT:
      • Block Temperature_Bounds: Definition der Temperaturklassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Temperature_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKC:
      • Block Suspended_Sediment_Bounds: Definition der Klassen für den Schwebstoffgehalt.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Suspended_Sediment_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKP:
      • Block Tracer_Bounds: Definition der Klassen für den Tracergehalt.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Tracer_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKO:
      • Block Oxygen_Bounds: Definition der Klassen für den Sauerstoffgehalt.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Oxygen_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKM:
      • Block Bathymetry_Bounds: Definition der Sohltiefenklassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Bathymetry_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKG:
      • Block Bedload_Bounds: Definition der Geschiebetransport-Klassen.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Bedload_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKB:
      • Block Bedfriction_Bounds: Definition der Klassen für die eff. Bodenschubspannung.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Bedfriction_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZKA:
      • Block PE_Anomaly_Bounds: Definition der Klassen für die PEA.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block PE_Anomaly_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZMW:
      • Block Wind_Bounds: Definition der Klassen für die Windgeschwindigkeit.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Wind_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.
    • Erforderlich für LZSS:
      • Block Sig_Wave_Bounds: Definition der Klassen für die signifikante Wellenhöhe.
        1. Interval: untere und obere Grenze der Klassen (Intervalle).
      • Block Sig_Wave_Quantiles: Definition der Quantile.
        1. Value: Quantil aus ] 0.0, 1.0 [; Sonderfall Median, mit Value = 0.5.

Anmerkungen

  1. Benutzte Dictionary-Dateien aus dem Verzeichnis $PROGHOME/dic/:
    • ncanalyse_dico.dat und
    • ncanalyse_config_dico.dat.
  2. Benutzte Standard-Konfigurationsdateien aus dem Verzeichnis $PROGHOME/cfg/:

Programme, welche diesen Datei-Typ benutzen

NCANALYSE

Beispiel-Datei

$PROGHOME/examples/ncanalyse/ncanalyse.dat

zurück zu: Dateikennblätter

Strukturübersicht

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