NCDVAR.DAT: Unterschied zwischen den Versionen
Aus BAWiki
(Erstversion) |
K (update version) |
||
(5 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt) | |||
Zeile 2: | Zeile 2: | ||
|name_en=NCDVAR.DAT | |name_en=NCDVAR.DAT | ||
|dateityp=ncdvar.dat | |dateityp=ncdvar.dat | ||
|version= | |version=Mai 2023 | ||
|version_beschr=August 2020 | |version_beschr=August 2020 | ||
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]] | |bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]] | ||
Zeile 9: | Zeile 9: | ||
* Block '''Program_Parameters''': Allgemeine Steuerdaten | * Block '''Program_Parameters''': Allgemeine Steuerdaten | ||
*# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. | *# '''Max_Read_Storage''': maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000. | ||
*# (optional) '''Create_Missing_Variables''' | *# (optional) '''Create_Missing_Variables''': Erzeugen zusätzlicher Variablen | ||
*# (optional) '''NC_Deflate_Level''' | *#* 0 = keine zusätzlichen Variablen erzeugen (Default) | ||
*# (optional) '''END_After_Define''' | *#* 1 = zusätzliche Variablen erzeugen (in Kombination mit DFlow FM) | ||
*# (optional) '''Delete_Coordinate_Variables''' | *# (optional) '''NC_Deflate_Level''': Kompression der Ergebnisdaten | ||
*# ( | *#* 0 = keine Kompression | ||
*#* 1 ... 8 = Kompression (Default = 3) | |||
*#* 9 = maximale Kompression | |||
*# (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) | |||
*# (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 | * Block '''Input_File''': Input-Datei | ||
*# '''Data_File''' Name und Typ der Input-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]]) | *# '''Data_File''' Name und Typ der Input-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]]) | ||
:::- Datei muss vorhanden sein | |||
* Block '''Output_File''': Output-Datei | * Block '''Output_File''': Output-Datei | ||
*# '''Data_File''' Name und Typ der Output-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]]) | *# '''Data_File''' Name und Typ der Output-Datei (Datei des Typs [[CF-NETCDF.NC|netcdf.nc]]) | ||
:::- Datei darf nicht vorhanden sein | |||
* (optional) Block '''Mesh_Variables_Action''': Aktionen auf allen Variablen eines Gitters (''Mesh'') | * (optional) Block '''Mesh_Variables_Action''': Aktionen auf allen Variablen eines Gitters (''Mesh'') | ||
*# '''Action''': Name der ''Mesh''-Variable und Aktion (''COPY'', ''DELETE''), die auf den Variablen dieses Gitters ausgeführt werden soll. | *# '''Action''': Name der ''Mesh''-Variable und Aktion ('''COPY''', '''DELETE'''), die auf den Variablen dieses Gitters ausgeführt werden soll. | ||
:::- Nicht alle [[CF-NETCDF.NC|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 | * (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; | |||
:::- Ü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 34: | Zeile 45: | ||
*# '''End_Time''': Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone | *# '''End_Time''': Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone | ||
*# '''Time_Step''': Zeitschritt im Format dddddd-hh:mm:ss.nnnnnnnnn | *# '''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. | |||
===Anmerkungen=== | ===Anmerkungen=== |
Aktuelle Version vom 17. Mai 2023, 10:10 Uhr
Basisinformationen
Datei-Typ
ncdvar.dat
Datei-Form
FORMATTED
Version
Mai 2023
Beschreibung
August 2020
Bedeutung der Datei
enthält allgemeine Eingabedaten für das Programm NCDVAR
Datei-Inhalt
Eingabesteuerdaten
- Block Program_Parameters: Allgemeine Steuerdaten
- Max_Read_Storage: maximale Anzahl der Datenwerte, die für jede Eingangsvariable in einem Kopierzyklus gelesen werden können. Default = 125000000.
- (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)
- (optional) NC_Deflate_Level: Kompression der Ergebnisdaten
- 0 = keine Kompression
- 1 ... 8 = Kompression (Default = 3)
- 9 = maximale Kompression
- (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)
- (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
- Data_File Name und Typ der Input-Datei (Datei des Typs netcdf.nc)
- - Datei muss vorhanden sein
- Block Output_File: Output-Datei
- 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)
- 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
- 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
- Time_KV_Name: Name der Zeit-Koordinatenvariable
- Start_Time: Anfangs-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
- End_Time: Ende-Zeitpunkt und Zeitzone im Format DD.MM.YYYY-hh:mm:ss.nnnnnnnnn zone
- 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.
Anmerkungen
- Benutzte Dictionary-Dateien aus dem Verzeichnis $PROGHOME/dic/:
- ncdvar_dico.dat.
- 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.
Programme, welche diesen Datei-Typ benutzen
Beispiel-Datei
$PROGHOME/examples/ncdvar/ncdvar.dat
zurück zu: Dateikennblätter