BOEWRT.DAT
Aus BAWiki
Basisinformationen
Datei-Typ
boewrt.dat
Datei-Form
FORMATTED
Version
May 2014, classic version September 2001
Beschreibung
May 2014
Bedeutung der Datei
enthält Zeitserien gemessener oder berechneter Daten als ASCII für die Benutzung in verschiedenen Programmen.
Allgemeines
Die Datei hat einen Header in dem Metadaten anhand ihrer Position in der Datei identifiziert werden, die erste Datenzeile beginnt bspw. mit der Knotennummer. Dies ist eine klassiche boewrt.dat Datei, die mit den Methoden der io-Library verarbeitet werden kann. Seit Mai 2014 kann der neue boewrt.dat Header Key-Value Paare mit zusätzlichen Metadaten enthalten, der Key Fill_Value wird z.B. mit einer reellen Zahl als Value verbunden. Die zusätzlichen Metainformationen werden nur vom neuen BAW-Software-Package io_dataset ausgewertet.
Programme, die die io- oder die io_dataset-Library benutzen, können sowohl die klassische als auch die neue Version von boewrt.dat lesen. Der eigentliche Datenteil zeichnet sich durch flexible Datums- und Zeitangaben aus. Zweistellige Jahreszahlen sollten allerdings nicht weiter verwendet werden. Ein Semikolon empfiehlt sich zum Trennen von Datum- und Zeitangaben von den Werten der physikalischen Größen.
Gerade die Metadaten werden von den beiden Libraries unterschiedlich interpretiert.
Das Format der Datei ist ziemlich flexibel:
in den Datenzeilen wird jedes der BAW-eigenen Zeit-Formate akzeptiert.
Benutze zur Trennung von den physikalischen Werten ein ";"-Zeichen.
Das Zeitformat mit 2-stelliger Jahreszahl sollte jedoch nicht mehr verwendet werden.
Falls es benutzt wird, wird das ab $BAWCENTURY einschließlich folgende Jahrhundert implizit angenommen. Der Nutzer sollte $BAWCENTURY innerhalb seiner Umgebung spezifizieren (DEFAULT: 1900).
Die Zeitzone wird nur interpretiert, wenn das gewünschte Anfangs- oder Enddatum eine definierte Zeitzone besitzt.
Besitzt die Datei in diesem Fall eine undefinierte Zeitzone, so wird MEZ angenommen!
Die Leseroutine unterstützt das Koordinatenreferenzsystem (CRS) wie folgt:
Ist die Umgebungsvariable $BAWCRS auf einen sinnvollen Wert gesetzt, so wird die enthaltene Koordinate von dem in der Datei enthaltenen CRS in das durch $BAWCRS gesetzte System konvertiert. Enthält die Datei kein sinnvolles CRS, so wird die Koordinate nicht transformiert. Der Nutzer sollte daher beim Aufruf der untenstehenden Programme immer die Variable BAWCRS gezielt setzen!
Dateien des Typs boewrt.dat können drei Kommentare enthalten, die den minimalen und den maximalen Zeitschritt sowie das FORTRAN-Format der Datenzeilen enthalten. Diese Zeilen dienen der Beschleunigung des Lesevorgangs, d.h. eine Überprüfung der Zeitreihe auf Monotonie in der Zeit entfällt und eine einheitliche Formatierung der Datenzeilen wird vorausgesetzt. Sollte das Lesen einer Datei fehlschlagen, sollten diese Zeilen sicherheitshalber entfernt werden. Werden Dateien per Editor manipuliert, so sollten diese Zeilen immer entfernt werden!
Datei-Inhalt
- Punktnummer und (optional) Kürzel für Zeitzone und Koordinatenreferenzsystem. Diese Zeile ist FORMATIERT im FORTRAN-Format "(I10,1X,A4,1X,A5)" zu schreiben. Vorzugsweise sollten für Zeitzonen die bekannten Kürzel ("MEZ ", "MESZ", "UTC ") und für das Koordinatensystem die in der BAW gebräuchlichen EPSG-Codes (siehe z.B. bei GEOTRANSFORMER) verwendet werden.
- Ortsbezeichnung (im FORTRAN-Format "(A)").
- Räumliche Position, gegeben durch Rechtswert, Hochwert und Tiefe (unformatiert, getrennt mit Leerzeichen).
- Anzahl n der abgespeicherten Größen und deren physikalische Code-Kennungen (FORTRAN-Format "(I10,nI8)"
- Datum, Uhrzeit und Daten für jeden gespeicherten Zeitpunkt. Vorzugsweise sollte der Datums-String mit einem Semikolon ";" von den physikalischen Werten getrennt werden.
Programme, welche diesen Datei-Typ benutzen
EVENTFILTER, EXCELENZ, EXKNO, FD2MET, FRQ2ZEITR, FRQWF, GEOTRANSFORMER, GVIEW2D, HVIEW2D, MESKOR, ROSE, TIDKEN, TSCALC, UNTRIM2007MONITOR, UTRRND, VVIEW2D, XTRDATA, ZEITRIO
Beispiel-Datei
$PROGHOME/examples/zeitrio/boewrt.new.dat
$PROGHOME/examples/zeitrio/boewrt.dat
zurück zu: Dateikennblätter