DATACONVERT: Unterschied zwischen den Versionen

← Zum vorherigen Versionsunterschied

Aktuelle Version vom 6. September 2022, 08:49 Uhr

Basisinformationen

Programm-Name

DATACONVERT

Version

August 2020

Beschreibung

September 2022

Stichworte

Konversion von Delft3D-Gitternetzen
Konversion von Delft3D-Berechnungsergebnissen
Konversion von (DWD) NetCDF-Daten
Zusammenfassen von (DWD) NetCDF-Daten in einer Datei
Konversion von BDF-Daten in CF-NetCDF-Daten
Konversion meteorologischer Daten ins Delft3D-Format METEO_DLFT
Ausdünnen von BDF-Datensätzen
Konversion von Zeitreihen im BOEWRT-Format in CF-NetCDF-Daten (optional mit Status-Flag Variable)
Konversion von CF SGRID NetCDF in CF UGRID NetCDF

Danksagung: This project took advantage of netCDF software developed by UCAR/Unidata (www.unidata.ucar.edu/software/netcdf/).

Kurzbeschreibung

Das Programm DATACONVERT dient zur Konversion von Daten:

Modus 1: Konversion der Berechnungsergebnisse des integrierten mathematischen Modellierungssystems Delft3D in BAW-spezifische Dateiformate, mit
- Konversion des Delft3D-Gitternetzes in ein Gitternetz im UnTRIM-Format,
- Konversion zwei-dimensionaler (tiefengemittelter) Delft3D-Berechnungsergebnisse in das BDF-Format (2D),
- Konversion und Tiefenmittelung drei-dimensionaler Delft3D-Berechnungsergebnisse (auf Sigma-Gitter) in das BDF-Format (2D), und
- Konversion drei-dimensionaler Delft3D-Berechnungsergebnisse (auf Sigma-Gitter) in das BDF-Format (3D, z-Schichten).

Eine dynamische Modelltopographie (Morphodynamik) wird sowohl für 2D- als auch 3D-Berechnungsergebnisse unterstützt. Liegen Delft3D-Berechnungsergebnisse mit Domain Decomposition vor, so werden diese Ergebnisse einstweilen nicht in einer Datei zusammengefasst, sondern verbleiben in verschiedenen, domain-spezifischen Dateien.
Die Konversion in folgende physikalische Ausgabegrößen wird unterstützt:

Wasserstand,
Strömungsgeschwindigkeit,
Salzgehalt,
Temperatur,
Schwebstoffgehalt (mehrere Fraktionen),
Topographie (statisch),
zeitvariable Topographie,
Tiefenerosion,
Schwebstoffgehalt (icode=7),
neu: Geschiebetransport (icode=621), ein Massentransport konvertiert aus einem Volumentransport,
neu: suspended load transport rate (icode=622), ein Massentransport konvertiert aus einem Volumentransport,
neu: Bodenschubspannung.

Modus 2: Konversion von (DWD) NetCDF-Daten in BAW-spezifische Dateiformate, mit
- Erzeugen eines Gitternetzes aus den in der NetCDF-Datei vorhandenen Punkt-Koordinaten, und
- Konversion der NetCDF-Daten in das BDF-Format.
Modus 3: Zusammenfassen von (DWD) NetCDF-Daten aus mehreren Dateien in einer NetCDF-Datei, mit
- Übertragen der Metadaten und Daten bei identischen Terminen in eine NetCDF-Datei.
Modus 4: Konversion von BDF-Daten in das CF-NetCDF-Format, für
Modus 5: Ausdünnen von BDF-Daten aus UnTrim und SediMorph für flächenhafte Daten, Zeitreihen und Profildaten.
- Auswahl einzelner Größen möglich
- Auswahl einzelner Varianten dieser Größen möglich
Modus 6: Konversion meteorologischer Daten im BDF-Format ins Delft3D-Format METEO_DLFT mit
- einer auf einem regelmäßigen Gitter basierenden Gitterdatei,
- ggf. der Erzeugung des regelmäßigen Gitters.
- Folgende physikalische Größen werden unterstützt.

Bewölkung,
Luftdruck,
Lufttemperatur,
relative Luftfeuchtigkeit und
Windgeschwindigkeit (Code=906)

Modus 7: Konversion von Zeitreihen und Metainformationen im BOEWRT-Format in eine cf-netcdf.nc Datei, die auf der feature type Vorlage für Zeitserien des NODCs beruht. Die Erzeugung einer optionalen Status-Flag Variable zur Beschreibung der Qualität einzelner Datenwerte wird unterstützt.
Modus 8: Konversion von CF SGRID NetCDF nach CF UGRID NetCDF (siehe cf-netcdf.nc), für
- Wasserstand, und
- Topografie (statisch).

Eingabe-Dateien

Eingabesteuerdaten
Datei des Typs dataconvert.dat. In der Beschreibung dieser Datei sind umfassende Informationen zu allen Steuerdaten, Eingangs- sowie Ergebnisdateien vorhanden.
Gitternetz
- Modus 1
- delft3d.grd,
- delft3d.dep, und
- delft3d.enc.
- (optional) delft3d.dry,
- (optional) delft3d.thd,
- (optional) delft3d.lwl,
- (optional) delft3d.ext, sowie
- (optional) delft3d.bnd.
- Modus 2 - kein Gitternetz erforderlich.
- Modus 3 - kein Gitternetz erforderlich.
- Modus 4
- location_grid.dat oder cf-netcdf.nc (aus GRIDCONVERT).
- gitter05.dat und gitter05.bin oder cf-netcdf.nc (aus GRIDCONVERT).
- untrim_grid.dat oder cf-netcdf.nc (aus GRIDCONVERT).
- utrsub_grid.dat (nur mit unechtem SubGrid - ein SubPolygon/Polygon, eine SubKante/Kante).
- profil05.bin oder cf-netcdf.nc (aus GRIDCONVERT).
- Modus 5 - kein Gitternetz erforderlich.
- Modus 6
- alle mit BDF-Dateien kombinierbaren Gitterformate, z.B.GITTER05
- Modus 7 - kein Gitternetz erforderlich.
- Modus 8 - kein Gitternetz erforderlich.
(optional) Globale Metadaten

Metadaten über Shell-Skripte setzen

Die Umgebungsvariablen können für den jeweiligen Simulationslauf im Run-Skript gesetzt werden. Auftragsweit gültige Variablen können in einem Auftrags-Skript unter $PROGHOME/bin/dmqs zentral abgelegt werden. Mit diesem Vorgehen können DMQS-konforme Metadaten erzeugt werden.

nc_meta.dat

Erst wenn die genannten Umgebungsvariablen nicht vorhanden sind, wird nach der Konfigurationsdatei nc_meta.dat gesucht. Falls sie in dem Arbeitsverzeichnis vorhanden ist, so wird sie automatisch gelesen. Anderenfalls wird auf die gleichnamige Datei in dem Verzeichnis $PROGHOME/cfg zurückgegriffen.

Berechnungsergebnisse oder Daten
- Modus 1
- netcdf.cdf.
- Modus 2
- netcdf.cdf.
- Modus 3
- netcdf.cdf.
- Modus 4
- BDF-Dateien dirz.bin, dirz.bin.i und dirz.bin.r
- Modus 5
- BDF-Dateien dirz.bin, dirz.bin.i und dirz.bin.r
- Modus 6
- BDF-Dateien dirz.bin, dirz.bin.i und dirz.bin.r
- Modus 7
- boewrt.dat
- Modus 8
- netcdf.cdf (CF SGRID NetCDF).
(optional) Vertikalstruktur
- Modus 1
- vertical.dat.
- Modus 2 - keine Vertikalstruktur erforderlich.
- Modus 3 - keine Vertikalstruktur erforderlich.
- Modus 4 - keine Vertikalstruktur erforderlich.
- Modus 5 - keine Vertikalstruktur erforderlich.
- Modus 6 - keine Vertikalstruktur erforderlich.
- Modus 7 - keine Vertikalstruktur erforderlich.
- Modus 8 - keine Vertikalstruktur erforderlich.

Ausgabe-Dateien

konvertiertes Gitternetz
- Modus 1
- untrim_grid.dat.
- Modus 2
- gitter05.dat/bin:
- Modus 3
  - keine Gitternetzdatei.
- Modus 4
- (optional) cf-netcdf.nc.
- Modus 5
  - keine Gitternetzdatei.
- Modus 6
- implizites regelmäßiges Gitter.
- Modus 7
  - keine Gitternetzdatei.
- Modus 8
  - keine Gitternetzdatei.
konvertierte Berechnungsergebnisse
- Modus 1
- dirz.bin.r,
- dirz.bin.i, und
- dirz.bin.
- Modus 2
- dirz.bin.r,
- dirz.bin.i, und
- dirz.bin.
- Modus 3
- netcdf.cdf.
- Modus 4
- cf-netcdf.nc.
- Modus 5
- dirz.bin.r,
- dirz.bin.i, und
- dirz.bin.
- Modus 6
- METEO_DLFT.
- Modus 7
  - cf-netcdf.nc.
- Modus 8
  - cf-netcdf.nc (CF UGRID NetCDF).
Druckerprotokolldatei
- dataconvert.sdr.
(optional) Tracedatei
- dataconvert.trc.

Methode

Die Gitterinformationen werden teilweise mit Hilfe der in den Softwarepaketen H_GRID und L_GRID zur Verfügung stehenden Methoden konvertiert. Zur Konversion der Berechnungsergebnisse werden teilweise Methoden des Paketes H_IP benutzt. Lesen und Schreiben der verschiedenen Formate mit den Berechnungsergebnissen erfolgt mit i. W. mit Methoden des Paketes IO_DATASET, bzw. in Modus 6 IO_DELFT.

Vorlauf-Programme

DELFT3D, GETDATA, GRIDCONVERT, UNTRIM2007, UNTRIM2, XTRLQ2.

Nachlauf-Programme

ABDF, ADCP2PROFILE, ArcGIS-Anwendungen, BOE2NC, DAVIT, DELFT3D, DIDAMERGE, DIDARENAME, DIDASPLIT, ENERF, GVIEW2D, HVIEW2D, IO_VOLUME, METDIDA, NCANALYSE, NCAUTO, NCCHUNKIE, NCDELTA, NCDVAR, NCMERGE, NCPLOT, NCPOLO, NCRCATMAT, NCVIEW2D, NC2TABLE, NetCDF Operators, PARTRACE, PGCALC, PLOTTS, PLOTPROFILZEIT, QUICKPLOT, UNK, UNS, VTDK, XTRDATA, XTRLQ2, ZEITR.

Weitere Informationen

Programmiersprache

Fortran90

zusätzliche Software

-

Originalversion

G. Lang, P. Schade

Programmpflege

Arbeitsgruppe POS

Dokumentation/Literatur

unter $PROGHOME/examples/dataconvert

zurück zu Programmkennblätter

Strukturübersicht

@@ Zeile 2: / Zeile 2: @@
 |name_en=DATACONVERT
 |name=DATACONVERT
-|version=V. 11.3, April 2013
+|version=August 2020
-|version_beschr=April 2013
+|version_beschr=September 2022
 |stichworte=
 Konversion von Delft3D-Gitternetzen<br />
@@ Zeile 11: / Zeile 11: @@
 Konversion von BDF-Daten in CF-NetCDF-Daten<br />
 Konversion meteorologischer Daten ins Delft3D-Format METEO_DLFT<br />
-Ausdünnen von BDF-Datensätzen.
+Ausdünnen von BDF-Datensätzen<br />
+Konversion von Zeitreihen im BOEWRT-Format in CF-NetCDF-Daten (optional mit [[BOEWRT.DAT#Status-Flag_Variable|Status-Flag Variable]])<br />
+Konversion von CF SGRID NetCDF in CF UGRID NetCDF<br />
+ Danksagung: ''This project took advantage of netCDF software developed by UCAR/Unidata ([http://www.unidata.ucar.edu/software/netcdf/ www.unidata.ucar.edu/software/netcdf/]).''
 |kurzbeschreibung=Das Programm DATACONVERT dient zur Konversion von Daten:<br />
 * '''Modus 1''': Konversion der Berechnungsergebnisse des integrierten mathematischen Modellierungssystems Delft3D in BAW-spezifische Dateiformate, mit<br />
@@ Zeile 26: / Zeile 31: @@
 # Schwebstoffgehalt (mehrere Fraktionen),
 # Topographie (statisch),
-# zeitvariable Topographie, und
+# zeitvariable Topographie,
 # Tiefenerosion,
-# ''neu in 11.3.:'' Schwebstoffkonzentration (icode=618),
+# Schwebstoffgehalt (icode=7),
 # ''neu'': Geschiebetransport (icode=621), ein Massentransport konvertiert aus einem Volumentransport,
 # ''neu'': suspended load transport rate (icode=622), ein Massentransport konvertiert aus einem Volumentransport,
@@ Zeile 57: / Zeile 62: @@
 # relative Luftfeuchtigkeit und
 # Windgeschwindigkeit (Code=906)
+* '''Modus 7''': Konversion von Zeitreihen und Metainformationen im [[BOEWRT.DAT|BOEWRT-Format]] in eine [[CF-NETCDF.NC|cf-netcdf.nc]] Datei, die auf der [http://www.nodc.noaa.gov/data/formats/netcdf/#templatesexamples feature type Vorlage für Zeitserien] des NODCs beruht. Die Erzeugung einer optionalen [[BOEWRT.DAT#Status-Flag_Variable|Status-Flag Variable]] zur Beschreibung der Qualität einzelner Datenwerte wird unterstützt.
+* '''Modus 8''': Konversion von CF SGRID NetCDF nach CF UGRID NetCDF (siehe [[CF-NETCDF.NC|cf-netcdf.nc]]), für
+** Wasserstand, und
+** Topografie (statisch).
+<br />
 |eingabedateien=
 # '''Eingabesteuerdaten'''<br/>Datei des Typs [[DATACONVERT.DAT|dataconvert.dat]]. In der Beschreibung dieser Datei sind umfassende Informationen zu allen Steuerdaten, Eingangs- sowie Ergebnisdateien vorhanden.
@@ Zeile 76: / Zeile 85: @@
 #:* [[GITTER05.DAT und GITTER05.BIN|gitter05.dat und gitter05.bin]] oder [[CF-NETCDF.NC|cf-netcdf.nc]] (aus [[GRIDCONVERT]]).
 #:* [[UNTRIM_GRID.DAT|untrim_grid.dat]] oder [[CF-NETCDF.NC|cf-netcdf.nc]] (aus [[GRIDCONVERT]]).
+#:* [[UTRSUB_GRID.DAT|utrsub_grid.dat]] (nur mit ''unechtem'' SubGrid - ein SubPolygon/Polygon, eine SubKante/Kante).
 #:* [[PROFIL05.BIN|profil05.bin]] oder [[CF-NETCDF.NC|cf-netcdf.nc]] (aus [[GRIDCONVERT]]).
 #* '''Modus 5''' - kein Gitternetz erforderlich.
 #* '''Modus 6'''
 #:* alle mit BDF-Dateien kombinierbaren Gitterformate, z.B.[[GITTER05.DAT_und_GITTER05.BIN|GITTER05]]
+#* '''Modus 7''' - kein Gitternetz erforderlich.
+#* '''Modus 8''' - kein Gitternetz erforderlich.
 # '''(optional) Globale Metadaten'''
-#:* [[NC_META.DAT|nc_meta.dat]].
+* '''[[Metadaten von Modellergebnissen im Küstenwasserbau|Metadaten über Shell-Skripte setzen]]'''
-Falls die Datei ''nc_meta.dat'' in dem Arbeitsverzeichnis vorhanden ist, so wird sie automatisch gelesen. Anderenfalls wird auf die gleichnamige Datei in dem Verzeichnis $PROGHOME/cfg zurückgegriffen.
+Die Umgebungsvariablen können für den jeweiligen Simulationslauf im Run-Skript gesetzt werden. Auftragsweit gültige Variablen können in einem Auftrags-Skript unter $PROGHOME/bin/dmqs zentral abgelegt werden. Mit diesem Vorgehen können DMQS-konforme Metadaten erzeugt werden.
+* '''[[NC_META.DAT|nc_meta.dat]]'''
+Erst wenn die genannten Umgebungsvariablen nicht vorhanden sind, wird nach der Konfigurationsdatei nc_meta.dat gesucht. Falls sie in dem Arbeitsverzeichnis vorhanden ist, so wird sie automatisch gelesen. Anderenfalls wird auf die gleichnamige Datei in dem Verzeichnis $PROGHOME/cfg zurückgegriffen.
 # '''Berechnungsergebnisse oder Daten'''<br/>
 #* '''Modus 1'''<br/>
@@ Zeile 96: / Zeile 110: @@
 #* '''Modus 6'''
 #:* BDF-Dateien [[DIRZ.BIN|dirz.bin]], [[DIRZ.BIN.I|dirz.bin.i]] und [[DIRZ.BIN.R|dirz.bin.r]]
+#* '''Modus 7'''
+#:* [[BOEWRT.DAT|boewrt.dat]]
+#* '''Modus 8'''<br/>
+#:* [[NETCDF.CDF|netcdf.cdf]] (CF SGRID NetCDF).
 # (optional) '''Vertikalstruktur'''<br/>
 #* '''Modus 1'''<br/>
@@ Zeile 104: / Zeile 122: @@
 #* '''Modus 5''' - keine Vertikalstruktur erforderlich.
 #* '''Modus 6''' - keine Vertikalstruktur erforderlich.
+#* '''Modus 7''' - keine Vertikalstruktur erforderlich.
+#* '''Modus 8''' - keine Vertikalstruktur erforderlich.
 |ausgabedateien=
 #'''konvertiertes Gitternetz'''
@@ Zeile 116: / Zeile 136: @@
 #* '''Modus 6'''<br/>
 #:* implizites regelmäßiges Gitter.
+#* '''Modus 7'''<br/> - keine Gitternetzdatei.
+#* '''Modus 8'''<br/> - keine Gitternetzdatei.
 #'''konvertierte Berechnungsergebnisse'''
 #* '''Modus 1'''<br/>
@@ Zeile 135: / Zeile 157: @@
 #* '''Modus 6'''<br/>
 #:* [[METEO_DLFT]].
+#* '''Modus 7'''<br/>
+#** [[CF-NETCDF.NC|cf-netcdf.nc]].
+#* '''Modus 8'''<br/>
+#** [[CF-NETCDF.NC|cf-netcdf.nc]] (CF UGRID NetCDF).
 #'''Druckerprotokolldatei'''
 #:* dataconvert.sdr.
@@ Zeile 140: / Zeile 166: @@
 #:* dataconvert.trc.
 |methode=Die Gitterinformationen werden teilweise mit Hilfe der in den Softwarepaketen H_GRID und L_GRID zur Verfügung stehenden Methoden konvertiert. Zur Konversion der Berechnungsergebnisse werden teilweise Methoden des Paketes H_IP benutzt. Lesen und Schreiben der verschiedenen Formate mit den Berechnungsergebnissen erfolgt mit i. W. mit Methoden des Paketes IO_DATASET, bzw. in Modus 6 IO_DELFT.
-|preprozessor=[http://www.baw.de/methoden/index.php5/Mathematisches_Verfahren_DELFT3D DELFT3D], [[GETDATA]], [[GRIDCONVERT]], [[UNTRIM2007]].
+|preprozessor=[http://www.baw.de/methoden/index.php5/Mathematisches_Verfahren_DELFT3D DELFT3D], [[GETDATA]], [[GRIDCONVERT]], [[UNTRIM2007]], [[UNTRIM2]], [[XTRLQ2]].
-|postprozessor=[[ABDF]], [[ADCP2PROFILE]], [[ArcGIS-Anwendungen]], [[Mathematisches_Verfahren_DELFT3D | DELFT3D]], [[DIDAMERGE]], [[DIDARENAME]], [[DIDASPLIT]], [[ENERF]], [[GVIEW2D]], [[HVIEW2D]], [[IO_VOLUME]], [[METDIDA]], [[NCANALYSE]], [[NCPLOT]], [[PARTRACE]], [[PARTRACE-3D]], [[PGCALC]], [[UNK]], [[UNS]], [[VTDK]], [[XTRDATA]], [[XTRLQ2]], [[ZEITR]].
+|postprozessor=[[ABDF]], [[ADCP2PROFILE]], [[ArcGIS-Anwendungen]], [[BOE2NC]], [[DAVIT]], [[Mathematisches_Verfahren_DELFT3D | DELFT3D]], [[DIDAMERGE]], [[DIDARENAME]], [[DIDASPLIT]], [[ENERF]], [[GVIEW2D]], [[HVIEW2D]], [[IO_VOLUME]], [[METDIDA]], [[NCANALYSE]], [[NCAUTO]], [[NCCHUNKIE]], [[NCDELTA]], [[NCDVAR]], [[NCMERGE]], [[NCPLOT]], [[NCPOLO]], [[NCRCATMAT]], [[NCVIEW2D]], [[NC2TABLE]], [[NetCDF Operators]], [[PARTRACE]], [[PGCALC]], [[PLOTTS]], [[PLOTPROFILZEIT]], [[QUICKPLOT]], [[UNK]], [[UNS]], [[VTDK]], [[XTRDATA]], [[XTRLQ2]], [[ZEITR]].
 |programmiersprache=Fortran90
 |zus_software= -
-|kontakt_original=[mailto:guenther.lang@baw.de G. Lang]
+|kontakt_original=G. Lang, P. Schade
-|kontakt_pflege=[mailto:guenther.lang@baw.de G. Lang,], [mailto:susanne.spohr@baw.de S. Spohr]
+|kontakt_pflege=[mailto:pos.proghome@baw.de Arbeitsgruppe POS]
 |dokumentation=unter $PROGHOME/examples/dataconvert}}