Aktionen

NC2TABLE.DAT

Aus BAWiki

Version vom 21. Mai 2024, 14:09 Uhr von Susanne Spohr (Diskussion | Beiträge) (update version)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Basisinformationen

Datei-Typ

nc2table.dat

Datei-Form

FORMATTED

Version

Mai 2024

Beschreibung

Oktober 2017

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NC2TABLE

Datei-Inhalt

Eingabesteuerdaten

  • Block Program_Parameters: Allgemeine Steuerdaten
    1. ASCII_Output_Format: Format der Ergebnisdatei(en)
      1. csv : nc2table.csv, Ergebnisse im CSV-Format
    2. Max_Read_Storage: Maximale Anzahl der vom Programm in einem READ-Zyklus gespeicherten Datenwerte.
    3. (optional) Create_Missing_Variables: Automatische Erzeugung fehlender Variablen, z. B. für D-Flow FM Ergebnisse.
      1. 0 : Es wird nicht versucht, zusätzliche Variablen zu erzeugen (Default);
      2. 1 : Es wird versucht, zusätzliche Variablen aus den vorhandenen Variablen abzuleiten.
    4. (optional) Fortran_Format: Fortran-Format, z. B. F10.3.
      1. Falls dieser Key angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
      2. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert G15.8 benutzt.
      3. Es dürfen nur in nc2table_dico.dat mit FixValue zugelassene Formate verwendet werden.
    5. (optional) Min_Water_Depth: Minimale Wasserbedeckung in [m], bis zu der Daten als gültig betrachtet werden.
      1. Falls dieser Key angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
      2. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert 0.0 benutzt.
      3. Funktioniert nur, falls den Variablen die Hilfsvariable Gesamtwassertiefe zugeordnet ist.
    6. (optional) NOBS_Filter: Bezeichnung des Filtertyps und des Filterwerts.
      1. Filtertypen:
        1. EQ : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten genau einem bestimmten Wert entspricht.
        2. LE : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten kleiner oder gleich einem bestimmten Wert ist.
        3. GE : Darstellung nur an Positionen, an denen die Anzahl der zur Berechnung benutzten Eingangsdaten größer oder gleich einem bestimmten Wert ist.
      2. Filterwert:
        1. N : 0 := maximale Anzahl; N := Anzahl N; -M := maximale Anzahl minus M.
      3. Falls dieser Key angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
      4. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert kein Filter benutzt.
      5. Funktioniert nur, falls einer Variablen eine Hilfsvariable Anzahl der Ereignisse zugeordnet ist.
    7. (optional) Undefined_String
      1. Falls dieser Key angegeben wird, wird dieser als Default-Wert für alle auszugebenden Variablen benutzt.
      2. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert--undefined- benutzt.
    8. (optional) Date_Time_Format: String zur Beschreibung des Ausgabeformats für Datum und Uhrzeit.
      1. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert ISO8601 (siehe ISO 8601) benutzt.
      2. Falls dieser Key angegeben wird, so darf er sich aus folgenden Komponenten zusammensetzen:
        YYYY : Jahr
        MM : Monat
        DD : Tag
        hh : Stunde
        mm : Minute
        ss : Sekunde
        n : Sekundenbruchteile, von "n" (1/10 Sek) bisnnnnnnn (1/100000000 Sek)
        ZZZZ : Zeitzone (als Text)
        zzzz : Zeitzone als ganze Zahl (INTEGER)
        Des weiteren die Zeichen ".", ":", "-" oder " ".
        Beispiele: YYYY-MM-DD hh:mm:ss ; YYYY-MM-DD hh:mm:ss.nnn ZZZZ.
    9. (optional) TIME_DIFF_Format: String zur Beschreibung des Ausgabeformats für Zeitdifferenzen.
      1. Falls dieser Key nicht angegeben wird, so wird der programmintern eingestellte Wert ISO8601 (siehe ISO 8601) benutzt.
      2. Falls dieser Key angegeben wird, so darf er sich aus folgenden Komponenten zusammensetzen:
        V : Vorzeichen
        D : Tage, von D bis DDDDDD
        hh : Stunde
        mm : Minute
        ss : Sekunde
        n : Sekundenbruchteile, von "n" (1/10 Sek) bis nnnnnnn (1/100000000 Sek)
        Des weiteren die Zeichen ".", ":", "-" oder " ".
        Beispiel: Vhh:mm:ss.
    10. (optional) Hor_Coord_Format: Ausgabeformat für (geografische) Koordinaten:
      1. Format XY: Ausgabe der lokalen Koordinaten als reelle Zahl.
      2. Format GEO_LON_LAT: Ausgabe der geografischen Koordinaten als reelle Zahl (in Grad).
      3. Format GEO_DEGREE: Ausgabe der geografischen Koordinaten in Grad, Minute, Sekunde (und Sekundenbruchteilen) sowie Angabe von N, S, E oder W (Default).
    11. (optional) Table_Datetime_Zone: Zeitzone bei Ausgabe von Datums- und Zeitangaben in Tabellen.
      1. UTC oder GMT: Universal Time Coordinated (Default);
      2. CET oder MEZ: Central European Time;
      3. CEST oder MESZ: Central European Summer Time.
  • Block Input_Variable_Info (IVI): Informationen zu Variablen (kann mehrfach angegeben werden)
    1. Name: Kurzbezeichnung
      1. Frei wählbare Bezeichnung, mit dem die Variable später angesprochen werden kann.
      2. Werden mehrere IVI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
      3. Bei Extraktionen mit mehreren IVIs je Tabelle wird dieser Wert zur Bezeichnung der Spalte/Zeile verwendet.
    2. File: Dateiname und Dateityp
      1. Name der Datei mit den zu extrahierenden Daten, Typ cf-netcdf.nc.
      2. Typ der Datei NETCDF.
    3. Variable: Name der in der Datei abgelegten Variable. Muss in File enthalten sein.
    4. (optional) Fortran_Format: Fortran-Format.
      1. Übersteuert den programminternen Default-Wert oder den in Block Program_Parameters angegebenen Wert. Siehe Block Program_Parameters.
      2. Für Zeitangaben darf hier auch TI angegeben werden. Dann erfolgt die Ausgabe im Date_Time_Format.
      3. Für Zeitdifferenzen darf hier auch DT angegeben werden. Dann erfolgt die Ausgabe im TIME_DIFF_FORMAT.
    5. (optional) Display_Unit: Einheit, in welcher die Variable in die Tabelle extrahiert werden soll.
      1. Muss in $PROGHOME/cfg/phydef.cfg.si.dat bekannt sein.
      2. Derzeit wird nur eine Umrechnung unter Beibehaltung der SI-Basis unterstützt, z. B. von m nach cm.
      3. Fehlt dieser Key, so wird die Variable in ihrer originalen Einheit extrahiert.
    6. Min_Water_Depth: Minimale Wasserbedeckung in [m], bis zu der Daten als gültig betrachtet werden.
      1. Übersteuert den programminternen Default-Wert oder den in Block Program_Parameters angegebenen Wert. Siehe Block Program_Parameters.
    7. (optional) NOBS_Filter: Bezeichnung des Filtertyps und des Filterwerts.
      1. Übersteuert den programminternen Default-Wert oder den in Block Program_Parameters angegebenen Wert. Siehe Block Program_Parameters.
  • Block Coordinate_Space_Info (CSI): Angaben zu Dimensionen (kann mehrfach angegeben werden)
    1. Name: Kurzbezeichnung
      1. Frei wählbare Bezeichnung, mit der die Dimension später angesprochen werden kann.
      2. Werden mehrere CSI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
    2. Dim_Name: Name der Dimension
      1. Muss eine gültige Dimension aus den in den in IVI-Blöcken referenzierten Dateien sein.
      2. Für alle in IVI-Bloecken benutzten Variablen sollten möglichst alle Dimensionen in CSI-Blöcken spezifiziert werden.
      3. Nicht näher spezifizierte, aber in Gebrauch befindliche Dimensionen, werden mit vollem Wertebereich berücksichtigt. Dies kann zu einer sehr großen Zahl extrahierter Tabellen führen.
    3. Dim_Space: Wertebereich (vier verschiedene Optionen)
      1. : : alle Werte (in dieser Koordinaten-Richtung).
      2. <startindex>:<endindex>:<schrittweite> : äquidistante Auswahl.
      3. indices=<index1>,<index2>,<index3>,...,<indexN> : Liste (ganze Zahlen).
      4. names=<name1>,<name2>,<name3>,...,<nameN> : Liste von Namen. Müssen in einer entsprechenden Label-Koordinatenvariable enthalten sein.
      5. xy=(<x1>,<y1>),(<x2>,<y2>),(<x3>,<y3>),...,(<xN>,<yN>): Liste von Koordinatenpaaren (lokale Koordinaten). Die Dimension muss in einer Koordinatenvariablen enthalten sein. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Koordinatenpaare angegeben werden.
      6. geo=(<lon1>,<lat1>),(<lon2>,<lat2>),(<lon3>,<lat3>),...,(<lonN>,<latN>): Liste von Koordinatenpaaren (geografische Koordinaten). Die Dimension muss in einer Koordinatenvariablen enthalten sein. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Koordinatenpaare angegeben werden.
      7. file=<cf-netcdf.nc>,NETCDF,<x_or_lon>,<y_or_lat>: Dateiname, Typ der Datei (derzeit nur NETCDF) sowie Namen der Variablen für die x-Koordinate oder geografische Länge und y-Koordinate oder geografische Breite. Geeignete Dateien können z. B. mit Programm GRIDCONVERT erzeugt werden. Hinweis: Falls die Koordinatenvariable mehr als eine Dimension aufweist, müssen für alle Dimensionen dieselben Angaben gemacht werden.
    4. Dim_EPSG: (optional) EPSG-Code (siehe EPSG Geodetic Parameter Registry) lokaler Koordinaten in Dim_Space. Falls nicht angegeben wird angenommen, dass die in Dim_Space angegebenen lokalen Koordinaten in demselben Koordinatensystem vorliegen wie in der Datendatei.
  • Block Table_Design_Info (TDI): Grundsätzlicher Aufbau der Tabelle (kann mehrfach angegeben werden).
    1. Name: Kurzbezeichnung.
      1. Frei wählbare Bezeichnung, mit dem das Table-Design später angesprochen werden kann.
      2. Werden mehrere TDI-Blöcke angegeben, so muss der Name eineindeutig sein.
    2. First_Column_IVI: Gültiger Name aus Block Input_Variable_Info.
      1. Wird zur Gestaltung der ersten Spalte einer Tabelle ausgewertet. Hinweis: Die erste Spalte enthält typischer Weise Informationen zu den Koordinaten in dieser Richtung.
    3. First_Row_IVI: Gültiger Name aus Block Input_Variable_Info.
      1. Wird zur Gestaltung der ersten Zeile einer Tabelle ausgewertet. Hinweis: Die erste Zeile enthält typischer Weise Informationen zu den Koordinaten in dieser Richtung.
    4. (optional) Row_CSI: Gültiger Name aus Block Coordinate_Space_Info
      1. Bezeichnet die Koordinate (Dimension) für die Zeilen der Tabelle.
    5. (optional) Column_CSI: Gültiger Name aus Block Coordinate_Space_Info
      1. Bezeichnet die Koordinate (Dimension) für die Spalten der Tabelle.
      2. Die Column_CSI darf nicht mehr als 34 Werte (= Spalten) aufweisen.
    6. (optional) Other_CSI: Gültiger Name aus Block Coordinate_Space_Info
      1. Es können mehrere CSI angegeben werden.
      2. Damit wird der Wertebereich der anderen Koordinaten (Dimensionen) festgelegt.
      3. Die Anzahl der erzeugten Tabellen entspricht typischer Weise dem Produkt der in den Other_CSI enthaltenen Schritte.
    7. Hinweise zu Row_CSI und Column_CSI
      1. Falls in dem Block Table_Contents_Info eine Tabelle nur aus einer IVI aufgebaut wird, müssen beide Dimensionen, also Column_CSI und Row_CSI spezifiziert werden.
      2. Falls in dem Block Table_Contents_Info eine Tabelle aus mehreren IVI aufgebaut wird, darf nur eine der Dimensionen, also Column_CSI oder Row_CSI spezifiziert werden.
      3. Große Dimensionen, z. B. Anzahl der Termine in einer Zeitserie, können nur als Row_CSI verarbeitet werden, da die Anzahl der Spalten begrenzt ist.
  • Block Table_Contents_Info (TCI): Aufbau und Inhalt einer (Serie von) Tabelle(n) (kann mehrfach angegeben werden).
    1. Name: Kurzbezeichnung.
      1. Frei wählbare Bezeichnung, mit welchem der Table-Contents verbunden wird.
      2. Die für diese Tabelle(n) erzeugte(n) Datei(en) lauten auf
        <tci:name>_<nnnnnn>.csv (Daten)
        <tci_name>_<nnnnnn>.txt (Metadaten)
      3. Werden mehrere TCI-Blöcke angegeben, so muss der Name ein-eindeutig sein.
      4. Namensgleiche Dateien dürfen nicht in dem Verzeichnis vorhanden sein! Vorher unbedingt verschieben oder löschen!
    2. TDI: Gültiger "Name" aus Block Table_Design_Info
      1. Wird zur Gestaltung der Tabelle ausgewertet.
    3. IVI: Gültiger Name aus Block Input_Variable_Info.
      1. Beschreibt die für die Tabelle benutzten Daten.
      2. Kann mehrfach angegeben werden. In diesem Fall dürfen bei TDI nur Row_CSI oder Column_CSI angegeben werden.

Anmerkungen

  1. Benutzte Dictionary-Datei aus dem Verzeichnis $PROGHOME/dic/:
    • nc2table_dico.dat.

Programme, welche diesen Datei-Typ benutzen

NC2TABLE

Beispiel-Datei

$PROGHOME/examples/nc2table/nc2table.dat

zurück zu: Dateikennblätter

Strukturübersicht

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