Quelltext der Seite NCDVAR.DAT

{{Dateikennblatt
|name_en=NCDVAR.DAT
|dateityp=ncdvar.dat 
|version=April 2020
|version_beschr=August 2020
|bedeutung=enthält allgemeine Eingabedaten für das Programm [[NCDVAR]]
|dateiinhalt=
'''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 [[CF-NETCDF.NC|netcdf.nc]])
:::- Datei muss vorhanden sein
* Block '''Output_File''': Output-Datei
*# '''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'')
*# '''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
*# '''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.
    
|nutzerprogramme=[[NCDVAR]]
|programmiersprache=Fortran95
|dateiform=FORMATTED
|dateizugriff=SEQUENTIAL
|dateiendung=.dat
|schreibmodule=interaktive Erstellung, Editor 
|lesemodule=$PROGHOME/fortran/prg/ncdvar/*/mod_m_ncdvar_steer.f90
|kontakt_original=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang], [mailto:susanne.spohr@baw.de S. Spohr]
|beispieldatei=$PROGHOME/examples/ncdvar/ncdvar.dat  
}}