Quelltext der Seite BOE2NC

{{Programmkennblatt
|name_en=BOE2NC
|name=BOE2NC
|version=Februar 2021
|version_beschr=September 2022
|stichworte=Preprozessor<br />
Wandlung<br />
[[BOEWRT.DAT]]<br />
[[CF-NETCDF.NC|cf-netcdf.nc]]

|kurzbeschreibung=
[[BOE2NC]] (siehe auch [[BOE2NC.DAT]]) wird angewendet um eine beliebige Menge von Messdaten vom [[BOEWRT.DAT]] in eine zusammengefasste [[CF-NETCDF.NC|cf-netcdf.nc]] zu überführen. 

# Alle Messdaten müssen in einem Ordner vorliegen
# Erlaubte physikalische Größen sind zur Zeit: Wasserstand, Salzgehalt, Temperatur, Strömungsgeschwindigkeit
# Zur Strömungsgeschwindigkeit muss eine Magnitude und eine Richtung vorliegen
# Die [[BOEWRT.DAT]] Header müssen zwingend enthalten (Zeitzone, Koordinatensystem, Koordinaten, ID)
# Die Messdaten sollten geprüft sein. Eine Prüfung des Wertebereichs wird nicht vorgenommen. Die Wandlung ist zudem recht zeitintensiv - und bei fehlerhaften Daten muss neu gestartet werden.
# Es ist möglich den Messstationen eine Reihenfolge in einem Textfile vorzugeben. Dafür bitte die Stationsnamen in der gewünschten Reihenfolge in einer Text-Datei hinterlegen. Dieser Textfile muss bei den Messdaten liegen.
# [[BOEWRT.DAT]] Messdaten werden in Wasserstände und nicht-Wasserstände unterschieden.
# Nicht-Wasserstände werden anhand anhand des Stationsnamens der [[BOEWRT.DAT]] einem Wasserstand zugeordnet.
# Messdaten die keine Wasserstände sind, müssen einen Wasserstand zugeordnet bekommen. Vorschlag hierfür: Kopieren eines nahegelegenen Wasserstandspegels und ändern des Stationsnamen auf den Namen der Nicht-Wasserstandgröße.
# Ist eine physikalische Größe für einen Pegel nicht vorhanden werden Fill_Values zugeordnet.
# Es ist möglich nicht alle physikalischen Größen zu verwenden. Dies spart massiv Rechenzeit, da keine Dummys erstellt, gewandelt und angehängt werden müssen.

|Mögliche Fehlerquellen:=
# Einer oder mehrere [[BOEWRT.DAT]] Header sind fehlerhaft.
# Die Stationsnamen stimmt nicht überein.
# Ein nicht-Wasserstand hat keinen Wasserstand zugeordnet.

|Anmerkungen=
# Die [[BOEWRT.DAT]] Eingangsdaten müssen zwingend die Endung *.boewrt.dat aufweisen!
# Die Wandlung selbst nimmt den Großteil der Programmlaufzeit in Anspruch. 100 Jahreszeitreihen ~70min
# Die Anwendung kann sich bei schwankender Messdatenqualität recht mühsam gestalten, da keine Möglichkeit besteht gewandelte [[CF-NETCDF.NC|cf-netcdf.nc]] zu bearbeiten. Entsprechend wird empfohlen sich alle Daten vor dem Wandeln anzugucken.
# Sind mehrere Tiefen für eine Station vorhanden sollte der Stationsname geändert werden. Liegen zum Beispiel für RSS Messungen in 2 und 8m Wassertiefe vor, sollten die Stationsnamen RSS_020 und RSS_080 heißen. Für jeder der beiden Daten muss dann eine Wasserstandszeitreihe vorgegeben werden.

|eingabedateien=
# req: Steuerdatei [[BOE2NC.dat]]
# opt: Reihenfolgedatei z.B. reihenfolge.txt

|ausgabedateien=  
# Datei mit Informationen zum Programmablauf (Dateityp *.sdr)
# Datei mit Warnungen und Fehlern (Dateityp *.err)
# Ordner mit den Originaldaten ./boewrt
# Ordner mit den [[ZEITRIO]] prozessierten Daten ./boe
# Ordner mit den [[ZEITRIO]] prozessierten Daten, [[DATACONVERT]] gewandelten und ncks zusammengefassten Daten ./nc
# Ordner mit den zusammengefassten ./nc Daten via ncrcat ./nc_cat

|methode=
Das Programm wurde mit MATLAB erstellt und mit PROGHOME Methoden ergänzt. Der Programmablauf wird nachfolgend skizziert:

# Lesen der Steuerdatei des Anwenders.
# Prüfen der Steuerdatei auf req. und opt Angaben
# Auswerten der [[BOEWRT.DAT]] Headerinformationen
# Auswerten der nutzerdef. Angaben der Dateiliste
# Wandlung I: Vorgegebene [[BOEWRT.DAT]] Daten
## Starten von [[ZEITRIO]] mit den Angaben aus der Steuerdatei [[BOE2NC.DAT]]
## Check: Haben alle Wandlungen mit [[ZEITRIO]] funktioniert? (nur mit Reihenfolge)
## Starten von [[DATACONVERT]] mit den Angaben aus der Steuerdatei [[BOE2NC.DAT]]
## Check: Haben alle Wandlungen mit [[DATACONVERT]] funktioniert?
# Nun wird für jede Wasserstands-Station gecheckt, ob alle angeforderten physikalischen Größen vorhanden sind.
## Check: Soll die physikalische Größe erzeugt werden?
## Check: Existieren hier schon "echte" Daten?
## Falls ja, werden die Daten an die Station angehängt.
## Falls nein, wird ein Array mit Fill_Values erzeugt, welcher nach [[BOEWRT.DAT]] gespeichert wird.
## Diese [[BOEWRT.DAT]] wird mit [[DATACONVERT]] nach [[CF-NETCDF.NC|cf-netcdf.nc]] überführt und dann an den entsprechenden Wasserstand angehängt.
## Dies wird für alle angeforderten physikalischen Werte wiederholt.
# Anschließend werden alle [[CF-NETCDF.NC|cf-netcdf.nc]] Messdaten mit ncrcat -h ([[NetCDF Operators]]) zusammengeführt
# Abschließend werden alle temporären Dateien gelöscht und alle Wandlungsprodukte in entsprechende Ordner verschoben.

|preprozessor=[[ZEITRIO]], [[DATACONVERT]]
|postprozessor=[[NCDELTA]], [[NCANALYSE]], [[NCDVAR]], [[NCMERGE]], [[NCPOLO]], [[NCPLOT]], [[NCVIEW2D]], [[NetCDF Operators]]
|programmiersprache=MATLAB r2018b
|zus_software= [[ZEITRIO]]
|kontakt_original=[mailto:robert.hagen@baw.de R. Hagen]
|kontakt_pflege=[mailto:robert.hagen@baw.de R. Hagen], [mailto:anna.wuensche@baw.de A. Wünsche]
|dokumentation=
* Musterdateien:
** Musterdateien finden sich in '''$PROGHOME/examples/boe2nc/'''
}}