NC2TABLE.DAT

Basic Information

File-Type

nc2table.dat

File-Form

FORMATTED

Version

July 2017

Description-Date

July 2016

Significance of the File

contains general steering data for the program NC2TABLE.

File-Contents (in Catchwords)

steering data

• Block Program_Parameters: general steering data
  1. ASCII_Output_Format: format for output file(s)
     1. csv : nc2table.csv, store results in CSV format
  2. Max_Read_Storage: maximum number of data values stored in one READ cycle.
  3. (optional) Create_Missing_Variables: enable automatic creation of missing variables, e. g. for D-Flow FM result files.
     1. 0 : disabled (Default);
     2. 1 : enabled.
  4. (optional) Fortran_Format: Fortran-Format, e.g. F10.3.
     1. In case this key is specified, this value will be used as default for all output variables.
     2. In case this key is not specified, program default G15.8 will be used.
     3. Only valid formats defined in nc2table_dico.dat are allowed to be used.
  5. (optional) Min_Water_Depth: minimum water coverage in [m], up to which data values are considered being valid.
     1. In case this key is specified, this value will be used as default for all output variables.
     2. In case this key is not specified, program default 0.0 will be applied.
     3. Works only for variables which have an auxiliary variable of type total water depth.
  6. (optional) NOBS_Filter: description of filter type and filter value.
     1. filter type:
        1. EQ : results will be only shown as long as the number of observations are identical to a prescribed value.
        2. LE : results will be only shown when the number of observations is less or equal to a prescribed value.
        3. GE : results will be only shown when the number of observations is greater or equal to a prescribed value.
     2. filter value:
        1. N : 0 := maximum number of observations; N := number of observations N; -M := maximum number of observations minus M.
     3. In case this key is specified, this filter will be used as default for all output variables..
     4. In case this key is not specified, program default no filter will be used.
     5. Works only for variables which have an auxiliary variable of type number of observations.
  7. (optional) Undefined_String
     1. In case this key is specified, this value will be used as default for all output variables.
     2. In case this key is not specified, program default --undefined- will be used.
  8. (optional) Date_Time_Format: string definition for date and time output format.
     1. In case this key is not specified, program default ISO8601 (see ISO 8601) will be used.
     2. In case this key is specified, the following components may be used

        YYYY : year

        MM : month

        DD : day

        hh : hour

        mm : minute

        ss : second

        n : parts of a second, from "n" (1/10 sec) to "nnnnnnn" (1/100000000 sec)

        ZZZZ : time zone (as text)

        zzzz : time zone as integer number

        Further characters ".", ":", "-" or " ".

        examples: YYYY-MM-DD hh:mm:ss ; YYYY-MM-DD hh:mm:ss.nnn ZZZZ.

• 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.
  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 unterstuetzt, 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-Bloecken 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
     1. : : alle Werte (in dieser Koordinaten-Richtung).
     2. <startindex>:<endindex>:<schrittweite> : äquidistante Auswahl.
     3. indices=<index1>,<index2>,<index3>,...,<indexN> : Liste
• 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.

General Remarks

1. Dictionary file used from directory $PROGHOME/dic/:
   • nc2table_dico.dat.

Programs using this Type of File

NC2TABLE

Example-File

$PROGHOME/examples/nc2table/nc2table.dat

---

back to: File Descriptions

---

Overview