Aktionen

NCDVAR.DAT: Unterschied zwischen den Versionen

Aus BAWiki

Günther Lang (Diskussion | Beiträge)
Block Mesh_Variables_Action wurde präzisiert
Susanne Spohr (Diskussion | Beiträge)
neue Version April 2026: Modify_Classification
 
(3 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
|name_en=NCDVAR.DAT
|name_en=NCDVAR.DAT
|dateityp=ncdvar.dat  
|dateityp=ncdvar.dat  
|version=April 2020
|version=April 2026
|version_beschr=August 2020
|version_beschr=Mai 2026
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]]
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]]
|dateiinhalt=
|dateiinhalt=
Zeile 36: Zeile 36:
:::- Zeile darf mehrfach angegeben werden.  
:::- Zeile darf mehrfach angegeben werden.  
* (optional) Block '''Single_Variable_Action''': Aktionen für individuelle Variablen
* (optional) Block '''Single_Variable_Action''': Aktionen für individuelle Variablen
*# '''Action''': Name der ''Variable'' und Aktion (''COPY'', ''DELETE''), die für diese Variable durchgeführt werden soll.
*# '''Action''': Name der ''Variable'' und Aktion ('''COPY''', '''DELETE'''), die für diese Variable durchgeführt werden soll.
:::- Zeile darf mehrfach angegeben werden;
:::- Zeile darf mehrfach angegeben werden;
:::- Übersteuert ggf. die globale ''Action'' in Block '''Mesh_Variables_Action'''.  
:::- Übersteuert ggf. die globale ''Action'' in Block '''Mesh_Variables_Action''';
:::- Der Anwender darf nur von ihm ''beeinflussbare'' Variablen aufzählen. Diese werden auch als geophysikalische Variablen bezeichnet. Koordinatenvariablen, Gewichtsvariablen, etc. dürfen vom Anwender ''nicht'' angegeben werden.  
* (optional) Block '''Time_Coordinate_Thinning''': Ausdünnen von äquidsitanten Zeit-Koordinaten
* (optional) Block '''Time_Coordinate_Thinning''': Ausdünnen von äquidsitanten Zeit-Koordinaten
*# '''Time_KV_Name''': Name der Zeit-Koordinatenvariable
*# '''Time_KV_Name''': Name der Zeit-Koordinatenvariable
Zeile 46: Zeile 47:
:::- Funktioniert nur für zeitlich äquidistante Eingangsdaten;
:::- Funktioniert nur für zeitlich äquidistante Eingangsdaten;
:::- Anfangs- und Ende-Zeitpunkt müssen in den Eingangsdaten vorhanden sein;
:::- Anfangs- und Ende-Zeitpunkt müssen in den Eingangsdaten vorhanden sein;
:::- Zeitschritt muss ein ganzzahliges Vielfaches der Eingangsdaten sein.
:::- Zeitschritt muss ein ganzzahliges Vielfaches der Eingangsdaten sein. Das Lesen mit Stride /= 1 ist allerdings in der NetCDF-Library ineffizient umgesetzt und führt deshalb zu langen Programmlaufzeiten.
* (optional) Block '''Modify_Classification''': Umstrukturierung von Variablen entlang Label-Dimension
*# '''Dimension''': Name der Dimension, entlang der die betroffenen Variablen neu strukturiert werden sollen.
*# '''MOD_Class''': Zuordnung alter Klassen zu neuer Klasse
:::- Zu der Dimension muss eine Label-Variable existieren;
:::- Das Bilden von Summen-Klassen ist NUR für bestimmte Variablen erlaubt.


===Anmerkungen===
===Anmerkungen===
Zeile 56: Zeile 62:
#* Fall 3: Löschen/Kopieren ausgewählter Variablen;
#* Fall 3: Löschen/Kopieren ausgewählter Variablen;
#* Fall 4: Löschen/Kopieren ausgewählter Termine in Zeitrichtung äquidsitanten Daten.
#* Fall 4: Löschen/Kopieren ausgewählter Termine in Zeitrichtung äquidsitanten Daten.
#* Fall 5: Löschen/Kopieren ausgewählter Klassen einer Label-Dimension.
#* Fall 6: Bilden von Summen-Klassen für Label-Dimension.
      
      
|nutzerprogramme=[[NCDVAR]]
|nutzerprogramme=[[NCDVAR]]

Aktuelle Version vom 11. Mai 2026, 13:17 Uhr

Basisinformationen

Datei-Typ

ncdvar.dat

Datei-Form

FORMATTED

Version

April 2026

Beschreibung

Mai 2026

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm NCDVAR

Datei-Inhalt

Eingabesteuerdaten

  • Block Program_Parameters: Allgemeine Steuerdaten
    1. Max_Read_Storage: maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000.
    2. (optional) Create_Missing_Variables: Erzeugen zusätzlicher Variablen
      • 0 = keine zusätzlichen Variablen erzeugen (Default)
      • 1 = zusätzliche Variablen erzeugen (in Kombination mit DFlow FM)
    3. (optional) NC_Deflate_Level: Kompression der Ergebnisdaten
      • 0 = keine Kompression
      • 1 ... 8 = Kompression (Default = 3)
      • 9 = maximale Kompression
    4. (optional) END_After_Define: Abbruch nach Erzeugen der Metadaten der Output-Datei
      • .false. = Programm läuft bis zum Ende durch (Default)
      • .true. = Programm endet nach Definition der Ergebnisdatei (Metadaten)
    5. (optional) Delete_Coordinate_Variables: Löschen von Koordinatenvariablen bestimmten Typs
      • X-Y = alle x- und y-Koordinatenvariablen (projizierte Koordinaten) werden nicht transferiert
      • LON-LAT = alle lon- und lat-Koordinaten (geografische Koordinaten) werden nicht transferiert
      • Wir dieser Key nicht angegeben, so werden alle Koordinatenvariablen transferiert
  • Block Input_File: Input-Datei
    1. Data_File Name und Typ der Input-Datei (Datei des Typs netcdf.nc)
- Datei muss vorhanden sein
  • Block Output_File: Output-Datei
    1. Data_File Name und Typ der Output-Datei (Datei des Typs netcdf.nc)
- Datei darf nicht vorhanden sein
  • (optional) Block Mesh_Variables_Action: Aktionen auf allen Variablen eines Gitters (Mesh)
    1. Action: Name der Mesh-Variable und Aktion (COPY, DELETE), die auf den Variablen dieses Gitters ausgeführt werden soll.
- Nicht alle netcdf.nc-Dateien verfügen über Mesh-Variablen;
- Wird für Mesh ALL angegeben, so werden alle Variablen auf die entsprechende Aktion gesetzt;
- Zeile darf mehrfach angegeben werden.
  • (optional) Block Single_Variable_Action: Aktionen für individuelle Variablen
    1. Action: Name der Variable und Aktion (COPY, DELETE), die für diese Variable durchgeführt werden soll.
- Zeile darf mehrfach angegeben werden;
- Übersteuert ggf. die globale Action in Block Mesh_Variables_Action;
- Der Anwender darf nur von ihm beeinflussbare Variablen aufzählen. Diese werden auch als geophysikalische Variablen bezeichnet. Koordinatenvariablen, Gewichtsvariablen, etc. dürfen vom Anwender nicht angegeben werden.
  • (optional) Block Time_Coordinate_Thinning: Ausdünnen von äquidsitanten Zeit-Koordinaten
    1. Time_KV_Name: Name der Zeit-Koordinatenvariable
    2. Start_Time: Anfangs-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
    3. End_Time: Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
    4. Time_Step: Zeitschritt im Format dddddd-hh:mm:ss.nnnnnnnnn
- Funktioniert nur für zeitlich äquidistante Eingangsdaten;
- Anfangs- und Ende-Zeitpunkt müssen in den Eingangsdaten vorhanden sein;
- Zeitschritt muss ein ganzzahliges Vielfaches der Eingangsdaten sein. Das Lesen mit Stride /= 1 ist allerdings in der NetCDF-Library ineffizient umgesetzt und führt deshalb zu langen Programmlaufzeiten.
  • (optional) Block Modify_Classification: Umstrukturierung von Variablen entlang Label-Dimension
    1. Dimension: Name der Dimension, entlang der die betroffenen Variablen neu strukturiert werden sollen.
    2. MOD_Class: Zuordnung alter Klassen zu neuer Klasse
- Zu der Dimension muss eine Label-Variable existieren;
- Das Bilden von Summen-Klassen ist NUR für bestimmte Variablen erlaubt.

Anmerkungen

  1. Benutzte Dictionary-Dateien aus dem Verzeichnis $PROGHOME/dic/:
    • ncdvar_dico.dat.
  2. Anwendungsmöglichkeiten:
    • Fall 1: Löschen von Koordinatenvariablen eines bestimmten Typs;
    • Fall 2: Löschen/Kopieren von auf einem bestimmten Gitter vorliegenden Variablen;
    • Fall 3: Löschen/Kopieren ausgewählter Variablen;
    • Fall 4: Löschen/Kopieren ausgewählter Termine in Zeitrichtung äquidsitanten Daten.
    • Fall 5: Löschen/Kopieren ausgewählter Klassen einer Label-Dimension.
    • Fall 6: Bilden von Summen-Klassen für Label-Dimension.

Programme, welche diesen Datei-Typ benutzen

NCDVAR

Beispiel-Datei

$PROGHOME/examples/ncdvar/ncdvar.dat


zurück zu: Dateikennblätter


Strukturübersicht