BOE2NC

Basisinformationen

Programm-Name

BOE2NC

Version

Juni 2019

Beschreibung

Juni 2019

Stichworte

Preprozessor
Wandlung einer Menge von BOEWRT.DAT in cf-netcdf.nc

Kurzbeschreibung

BOE2NC (siehe auch boe2nc.dat) wird angewendet um eine beliebige Menge von Messdaten vom BOEWRT.DAT in cf-netcdf.nc zu überführen. Hierbei gilt es zu beachten:

1. Alle Messdaten müssen in einem Ordner vorliegen
2. Erlaubte physikalische Größen sind zur Zeit: Wasserstand, Salzgehalt, Temperatur, Strömungsgeschwindigkeit
3. Zur Strömungsgeschwindigkeit muss eine Magnitude und eine Richtung vorliegen
4. Die BOEWRT.DAT Header müssen zwingend enthalten (Zeitzone, Koordinatensystem, Koordinaten, ID)
5. Die Messdaten sollten geprüft sein. Eine Prüfung des Wertebereichs wird nicht vorgenommen.
6. Es ist möglich den Messstationen eine Reihenfolge in einem Textfile vorzugeben. Dafür bitte die Stationsnamen in der gewünschten Reihenfolge in der Datei hinterlegen.
7. Nicht-Wasserstände werden anhand des Stationsnames einander zugeordnet.
8. Ist eine physikalische Größe für einen Pegel nicht vorhanden werden Fill_Values zugeordnet.
9. 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.

Mögliche Fehlerquellen:

1. Einer oder mehrere BOEWRT.DAT Header sind fehlerhaft.
2. Die Stationsnamen stimmt nicht überein.

Anmerkungen

1. Der Messstationsname wird aus der BOEWRT.DAT Datei für alle Outputs verwendet. Es ist also von Vorteil diesen kurz zu wählen.
2. Für die Statistikausgabe werden MAE, RMSE, bzw. RMAE und RRMSE empfohlen.
3. Da es möglich ist mehrsprachig (deutsch, englisch) mit mehreren Ausgabeformaten (.png, .fig, .eps, .pdf) zu arbeiten, ergibt sich sehr schnell eine extrem große Menge an Bildern (>1.000). Der Nutzer sollte sich entsprechend vorher überlegen, welche Darstellungen überhaupt in welchen Formaten benötigt werden.

Eingabe-Dateien

1. allgemeine Eingabedaten (Dateityp ncpolo.dat);
2. Modelldaten, aus UNTRIM2007, UNTRIM2 und UNK (Dateityp cf-netcdf.nc);
3. Messdaten, z. B. Wasserstand (Dateityp cf-netcdf.nc);

Ausgabe-Dateien

1. Datei mit Informationen zum Programmablauf (Dateityp ncpolo.sdr)
2. (optional) Zeitreihen (Dateityp PNG, FIG, EPS, FIG)
3. (optional) Scatterplot (Dateityp PNG, FIG, EPS, FIG)
4. (optional) Hodograph (Dateityp PNG, FIG, EPS, FIG)
5. (optional) Boxplotverteilung (Dateityp PNG, FIG, EPS, FIG)
6. (optional) Statistikverteilung (Dateityp PNG, FIG, EPS, FIG)
7. (optional) Statistische Kennwerte (Dateityp DAT, CSV, LATEX)
8. (optional) Zeitlich und örtlich korrelierte Daten (Dateityp DAT, CSV, BOEWRT.DAT, MAT)

Methode

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

1. Lesen der Steuerdatei des Anwenders.
2. Festlegen der zu bearbeitenden physikalischen Größen.
3. Äußere Schleife (parallelisiert): Je physikalischer Größe:
   1. Check: Existieren Messdaten für diese physikalische Größe?
   2. Check: Sollen Plots erstellt werden und wenn ja welche?
   3. Check: Sollen Daten exportiert werden und wenn ja welche?
   4. Wenn 1 und 2 und/oder 3 zutreffend sind: Einladen der Messdaten der physikalischen Größe.
      1. Innere Schleife: Je Messposition (seriell):
      2. Korrelation von punktuell vorliegenden Messdaten auf die flächige 2D Ergebnisdatei
      3. Check: Liegt die Position innerhalb des vorgegeben, maximalen Abstands maxDist?
      4. Falls ja, wird das flächige Modellergebnis am räumlich nächsten Index (Face oder Edge) ausgelesen.
      5. Check: Fällt die ausgelesene nächste Position trocken?
      6. Falls ja, Auslesen der nächstnäheren Position, bis minPoints erreicht ist, oder der Punkt nicht mehr trockenfällt.
      7. Check: Existieren gemeinsame Zeitpunkte innerhalb der Zeittoleranz ttol?
      8. Falls ja, werden alle gemeinsamen Zeitpunkte für diese Position ermittelt und gespeichert.
      9. Aus diesen Zeitpunkten wird die NCPOLO Statistik berechnet.
      10. Alle eben ermittelten Werte werden abgespeichert -danach wird die nächste Position analog bearbeitet.
4. Alle vom Nutzer gewünschten Grafiken werden erzeugt (parallelisiert).
5. Die Grafiken werden im nutzerdefinierten Format abgespeichert und in einer Verzeichnisstruktur im nutzerdefinierten Export Directory abgelegt.
6. Alle vom Nutzer gewünschten Möglichkeiten zum Datenexport und Statistikexport werden erzeugt.
7. Die Daten werden im nutzerdefinierten Format abgespeichert und in einer Verzeichnisstruktur im nutzerdefinierten Export Pfad abgelegt.

Vorlauf-Programme

ZEITRIO,DATACONVERT

Nachlauf-Programme

NCDELTA, NCANALYSE, NCPOLO

Weitere Informationen

Programmiersprache

MATLAB r2018b

zusätzliche Software

keine

Originalversion

R. Hagen,M. Jurke

Programmpflege

R. Hagen

Dokumentation/Literatur

• Musterdateien:
  • Musterdateien finden sich in $PROGHOME/examples/boe2nc/

---

zurück zu Programmkennblätter

---

Strukturübersicht