EXT-Datei: Unterschied zwischen den Versionen

Aktuelle Version vom 26. April 2024, 10:30 Uhr

Versionen:

v1.5: aktuell
v1.4

Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen.

Beispiel

*Input-Zeitreihen (*.EXT)
*========================
[SETTINGS]
VERSION=1.5
PATHNet=
PATHLocal=Z:\data\Projekte\000780-18_K+S_Vorhersage\4_Data\Phase_3_Umsetzung\OP\Simtimeseries\00000000\
*|---|--------|-----|------------|-------|----------|-----|--------------------------------------------|------|-------------
*| A |   No   |Intp | Unit       | NoInp | Elev     | Err | File                                       | Flag | Description
*|-+-|-<---->-|-+---|-<-------->-|-+-----|-<------>-|-+---|--------------------------------------------|-<-->-|-------------
 | 1 |      2 | 2   | mm/d       | 0     |          | 3   | 00407331.bin                               |      |
 | 1 |      3 | 2   | mm/d       | 0     |          | 3   | sqlite.db                                  | 2    |
 | 1 |      4 | 2   | mm/d       | 0     |          | 3   | othertimeseries.bin                        |      |
 | 1 |      5 | 2   | mm/d       | 0     |          | 3   | subfolder/series.bin                       |      |

Die Spaltenbreite kann nach Bedarf angepasst werden, alle Trennzeichen (|) müssen jedoch erhalten bleiben. Zeilen, die mit * beginnen, werden ignoriert.

Erläuterungen

`[SETTINGS]`

VERSION: Versionsnummer des Dateiformats
PATHNet: Netzwerkpfad zum Verzeichnis mit den Zeitreihen
PATHLocal: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen

Die für PATHNet und PATHLocal angegebenen Pfade müssen mit einem \ enden!

Zeitreihenattribute

A (Aktiv): Gibt an, ob die Zeitreihe aktiv (1) oder nicht (0) ist. Nur aktive Zeitreihen werden eingelesen.
ID: Zeitreihen-Nummer zur Referenzierung in anderen Eingabedateien (z.B. EZG-Datei). Zeitreihen-Nummern müssen fortlaufend und aufsteigend sein.

Interpretation von Zeitreihen

Intp (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
- 1: Momentaner_Wert_(Lineare_Interpolation)
- 2: BlockRechts
- 3: BlockLinks
- 4: Summenlinie
- 5: SummeProZeitschritt
- 99: Undefiniert
Unit:
NoInp (NoInput): Gibt an, ob die Zeitreihe als normaler Input dienen soll (0) oder nicht (1). Wenn nicht, wird die Zeitreihe nur für die Anfangsbedingungen verwendet.
Elev (Elevation): Geländehöhe der zugehörigen Station (wird für die Anpassung von Temperaturzeitreihen an unterschiedliche Höhen von Einzugsgebieten verwendet.

Die Temperatur im Einzugsgebiet wird abhängig von der Höhendifferenz folgendermaßen angepasst:
je 100 m Höhenzunahme von Stationshöhe zu Einzugsgebietshöhe wird die Temperatur der Zeitreihe um 0.6 K abgesenkt, um die angepasste Temperatur im Einzugsgebiet zu erhalten und umgekehrt

Wenn keine höhenabhängige Temperaturanpassung erfolgen soll, muss hier ein Fehlwert (-777, -9999, -9999.999) eingetragen werden. Keine Angabe oder ein Wert von 0 werden ebenfalls als Fehlwert interpretiert.

Err (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
- 0: Originalwert verwenden (bei BIN-Zeitreihen ist das der Wert -9999.999!)
- 1: Fehlwert ignorieren
- 2: Fehlwert ersetzen (mit 0.0)
- 3: Fehlwert interpolieren
- 4: Bei Fehlwert abbrechen

Die Fehlwertbehandlung wird vor einer etwaigen Umrechnung der Zeitreihe in den Simulationszeitschritt durchgeführt. Bei Optionen 0 (Originalwert verwenden) und 2 (Fehlwert ersetzen) findet die Umrechnung dann mit den ersetzten Werten (-9999.999 oder 0.0) statt und kann zu unerwarteten Ergebnissen führen!

File: Dateiname der Zeitreihendatei. Kann optional noch den Pfad von Unterzeichnissen enthalten. Unterstützte Dateiformate/Dateierweiterungen:
- BIN: Zeitreihe im Sydro-Binärformat
- DB: Zeitreihe im Sydro SQLite-Format

Hinweis: Zeitreihen im SQlite-Format werden automatisch zu Simulationsbeginn in einem Unterordner "converted" zum BIN-Format konvertiert.

Flag: Nur bei Zeitreihen im Sydro SQLite-Format der Klasse FlaggedTimeseries relevant: Flag der zur verwendenden Zeitreihe. Wenn nicht angegeben, wird 0 angenommen.
Description: optionale freie Bezeichnung der Zeitreihe

@@ Zeile 65: / Zeile 65: @@
 * <code>Unit</code>:
 * <code>NoInp</code> (NoInput): Gibt an, ob die Zeitreihe als normaler Input dienen soll (<code>0</code>) oder nicht (<code>1</code>). Wenn nicht, wird die Zeitreihe nur für die Anfangsbedingungen verwendet.
-* <code>Elev</code> (Elevation): Geländehöhe der zugehörigen Station (wird für die Anpassung von Temperaturzeitreihen an unterschiedliche Höhen von Einzugsgebieten verwendet).
+* <code>Elev</code> (Elevation): Geländehöhe der zugehörigen Station (wird für die Anpassung von Temperaturzeitreihen an unterschiedliche Höhen von Einzugsgebieten verwendet.
-<div class="achtung">Wenn keine höhenabhängige Temperaturanpassung erfolgen soll, muss hier ein Fehlwert (<code>-777</code>, <code>-9999</code>, <code>-9999.999</code>) eingetragen werden. Keine Angabe oder ein Wert von <code>0</code> werden ebenfalls als Fehlwert interpretiert.</div>
+<div class="info">Die Temperatur im Einzugsgebiet wird abhängig von der Höhendifferenz folgendermaßen angepasst: </br>je 100 m Höhenzunahme von Stationshöhe zu Einzugsgebietshöhe wird die Temperatur der Zeitreihe um 0.6 K abgesenkt, um die angepasste Temperatur im Einzugsgebiet zu erhalten und umgekehrt</div>
+<div class="info">Wenn keine höhenabhängige Temperaturanpassung erfolgen soll, muss hier ein Fehlwert (<code>-777</code>, <code>-9999</code>, <code>-9999.999</code>) eingetragen werden. Keine Angabe oder ein Wert von <code>0</code> werden ebenfalls als Fehlwert interpretiert.</div>
 * <code>Err</code> (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
 ** <code>0</code>: Originalwert verwenden (bei BIN-Zeitreihen ist das der Wert -9999.999!)
 ** <code>1</code>: Fehlwert ignorieren
-** <code>2</code>: Fehlwert ersetzen (standardmäßig mit <code>0.0</code>)
+** <code>2</code>: Fehlwert ersetzen (mit <code>0.0</code>)
 ** <code>3</code>: Fehlwert interpolieren
 ** <code>4</code>: Bei Fehlwert abbrechen
+<div class="info">Die Fehlwertbehandlung wird '''vor''' einer etwaigen Umrechnung der Zeitreihe in den Simulationszeitschritt durchgeführt. Bei Optionen 0 (Originalwert verwenden) und 2 (Fehlwert ersetzen) findet die Umrechnung dann mit den ersetzten Werten (-9999.999 oder 0.0) statt und kann zu unerwarteten Ergebnissen führen!</div>
 * <code>File</code>: Dateiname der Zeitreihendatei. Kann optional noch den Pfad von Unterzeichnissen enthalten. Unterstützte Dateiformate/Dateierweiterungen:
 ** <code>BIN</code>: Zeitreihe im Sydro-Binärformat