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): informations about variables (can be specified more than once)
  1. Name: short name.
     1. In case several IVI blocks are specified, Name must be unique.
     2. In case several IVIs are extracted to one table Name is used as column/row header.
  2. File: file name and file type
     1. name of file from which data shall be extracted, type cf-netcdf.nc.
     2. file type NETCDF.
  3. Variable: name of variable to be extracted. Must be contained in File.
  4. (optional) Fortran_Format: Fortran format.
     1. Overrides program default or value specified in Block Program_Parameters . See block Program_Parameters.
  5. (optional) Display_Unit: physical unit to be used during data extraction.
     1. Must be known in $PROGHOME/cfg/phydef.cfg.si.dat.
     2. Actually transformation is only supported in case the SI base doesn't change, e.g. from m to cm.
     3. In case this key is missing, original variable units are used.
  6. Min_Water_Depth: minimum water coverage in [m], up to which data values are considered being valid.
     1. Overrides program default or value specified in block Program_Parameters. See block Program_Parameters.
  7. (optional) NOBS_Filter: description of filter type and filter value.
     1. Overrides program default or value specified in block Program_Parameters. See block Program_Parameters.
• Block Coordinate_Space_Info (CSI): informations about coordinate dimensions (can be specified more than once)
  1. Name: short name.
     1. In case several CSI blocks are specified, Name must be unique.
  2. Dim_Name: name of coordinate dimension.
     1. Must be a valid dimension of variables referenced in IVI blocks.
     2. For all the variables listed in IVI blocks all of their used dimensions should be specified in CSI blocks.
     3. Dimensions not specified but in use are considered being used with full dimension. This can result in a rather large number of tables to be extracted.
  3. Dim_Space: range of (coordinate) values
     1. : : all values.
     2. <startindex>:<endindex>:<schrittweite> : equidistant selection.
     3. indices=<index1>,<index2>,<index3>,...,<indexN> : list of individual coordinate values.
• 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