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 1: / Zeile 1: @@
 <languages/>
 <translate>
-</translate>
+<!--T:1-->
 {{ASCII-Datensatz}}
-<translate>
+<div class="versionen">
+Versionen:
+* v1.5: '''aktuell'''
+* [http://www.talsim.de/docs/index.php?title=EXT-Datei&oldid=13417 v1.4]
+</div>
 <!--T:11-->
@@ Zeile 9: / Zeile 15: @@
 Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen.
-<!--T:12-->
+==Beispiel== <!--T:3-->
-<div class="info">Für das neuere Dateiformat v1.5 siehe [[Special:MyLanguage/EXT-Datei 1.5|EXT-Datei 1.5]]</div>
-==Beispiel== <!--T:13-->
+<!--T:4-->
 <pre class="brush:plain">
 *Input-Zeitreihen (*.EXT)
 *========================
 [SETTINGS]
-VERSION=1.4
+VERSION=1.5
 PATHNet=
-PATHLocal=..\..\Datensaetze\LTV\ZRE\
+PATHLocal=Z:\data\Projekte\000780-18_K+S_Vorhersage\4_Data\Phase_3_Umsetzung\OP\Simtimeseries\00000000\
-*|--------|------------|-----------------------------------------|
+*|---|--------|-----|------------|-------|----------|-----|--------------------------------------------|------|-------------
-*|   ID   | Einh       |  ObjID    ZreID     DBID     Hoehe  Err |Bezeichnung
+*| A |   No   |Intp | Unit       | NoInp | Elev     | Err | File                                       | Flag | Description
-*|-<---->-|+<-------->+|-<------>-<------>-<------>-<------>--+--|
+*|-+-|-<---->-|-+---|-<-------->-|-+-----|-<------>-|-+---|--------------------------------------------|-<-->-|-------------
-*|A   B   |C    D     E|     F       G        H         I     J  |K
+  | 1 |      2 | 2   | mm/d       | 0     |          | 3   | 00407331.bin                               |      |
-  |1  1    |5mm        0| 2013     2136     100      0         3  |ETpen.Lehnmuehle.mm/d.2136
+  | 1 |      3 | 2   | mm/d       | 0     |          | 3   | sqlite.db                                  | 2    |
- |1  2    |5mm        0| 2014     2137     100      0         3  |ETpen.Klingenberg.mm/d.2137
+  | 1 |      4 | 2   | mm/d       | 0     |          | 3   | othertimeseries.bin                        |      |
- |1  3    |5mm        0| 2016     2218     100      0         3  |ETpen.5779Zinnwald-Georgenfeld.mm.Tag.2218
+  | 1 |      5 | 2   | mm/d       | 0     |          | 3   | subfolder/series.bin                       |      |
- |1  4    |5mm        0| 2017     2100     122      0         3  |NS.2571Altenberg-Kipsdorf.mm.Tag.2100
- |1  5    |5mm        0| 2018     2099     122      0         3  |NS.2317Rechenberg-Bienenmühle-Holzhau.mm.Tag.2099
-  |1  6    |5mm        0| 2019     2101     122      0         3  |NS.2633Klingenberg Talsperre.mm.Tag.2101
- |1  7    |1oC        0| 2020     2114     122      877       3  |Tmitt.5779Zinnwald-Georgenfeld.C.Tag.2114
- |1  8    |5mm        0| 2021     2105     122      0         3  |NS.5779Zinnwald-Georgenfeld.mm.Tag.2105
- |1  9    |1oC        0| 2022     2127     122      365       3  |Tmitt.991Dippoldiswalde.C.Tag.2127
- |1  10   |1oC        0| 2023     2111     122      615       3  |Tmitt.833Neuhausen/Erzgeb.C.Tag.2111
- |1  11   |5mm        0| 2024     2103     122      0         3  |NS.4432Altenberg-Schellerhau.mm.Tag.2103
- |1  12   |5mm        0| 2025     2100     122      0         3  |NS.2571Altenberg-Kipsdorf.mm.Tag.2100
- |1  13   |5mm        0| 2026     2101     122      0         3  |NS.2633Klingenberg Talsperre.mm.Tag.2101
- |1  14   |5mm        0| 2027     2099     122      0         3  |NS.2317Rechenberg-Bienenmühle-Holzhau.mm.Tag.2099
-  |1  15   |1m3/s      0| 2028     1987     122      0         3  |Q.Rauschenbach 2.m3/s.Tag.1987
- |1  16   |1m3/s      0| 2029     1979     122      0         3  |Q.Lehnmuehle.m3/s.Tag.1979
- |1  17   |1m3/s      0| 2030     2035     122      0         3  |Q.TS_Klingenberg.m3/s.Tag.2035
- |1  18   |1m3/s      0| 2031     2058     122      0         3  |Q.Lehnmuehle_Wildbettabgabe.m3/s.Tag.2058
- |1  19   |1m3/s      0| 2032     2060     122      0         3  |Q.Klingenberg_Wildbettabgabe.m3/s.Tag.2060
- |1  20   |1m3/s      0| 2033     2059     122      0         3  |Q.UeberleitungLichtenbergnachKlingenberg.m3/s.Tag.2059
-  |1  21   |1m3/s      0| 2034     2057     122      0         3  |Q.Rauschenbach_RWA Abgabe.m3/s.Tag.2057
- |1  22   |1m3/s      0| 2035     2134     122      0         3  |Q.Rauschenbach3-Rauschenbach2.m3/s.Tag.2134
- |1  23   |5mm        0| 2039     2099     122      0         3  |NS.2317Rechenberg-Bienenmühle-Holzhau.mm.Tag.2099
- |1  24   |1oC        0| 2040     2111     122      615       3  |Tmitt.833Neuhausen/Erzgeb.C.Tag.2111
- |1  25   |5mm        0| 2124     2233     100      0         3  |ETpencorr.Rauschenbach.mm/d.2233
- |1  26   |5mm        0| 2125     2232     100      0         3  |ETpen_corr2.Klingenberg.mm/d.2232
-*|--------|------------|-----------------------------------------|
 </pre>
+<!--T:5-->
+Die Spaltenbreite kann nach Bedarf angepasst werden, alle Trennzeichen (<code>|</code>) müssen jedoch erhalten bleiben. Zeilen, die mit <code>*</code> beginnen, werden ignoriert.
-==Erläuterungen== <!--T:14-->
+==Erläuterungen== <!--T:6-->
-===<code>[SETTINGS]</code>=== <!--T:15-->
+===<code>[SETTINGS]</code>=== <!--T:7-->
-<!--T:16-->
+<!--T:8-->
 * <code>VERSION</code>: Versionsnummer des Dateiformats
 * <code>PATHNet</code>: Netzwerkpfad zum Verzeichnis mit den Zeitreihen
 * <code>PATHLocal</code>: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen
+<!--T:21-->
+<div class="achtung">Die für <code>PATHNet</code> und <code>PATHLocal</code> angegebenen Pfade müssen mit einem <code>\</code> enden!</div>
-===Zeitreihenattribute=== <!--T:17-->
+===Zeitreihenattribute=== <!--T:9-->
-<!--T:18-->
+<!--T:10-->
-* <code>A</code> ('''Aktiv'''): Gibt an, ob die Zeitreihe aktiv (<code>1</code>) oder nicht (<code>0</code>) ist.
+* <code>A</code> (Aktiv): Gibt an, ob die Zeitreihe aktiv (<code>1</code>) oder nicht (<code>0</code>) ist. Nur aktive Zeitreihen werden eingelesen.
-<div class="achtung">
+* <code>ID</code>: Zeitreihen-Nummer zur Referenzierung in anderen Eingabedateien (z.B. [[Special:MyLanguage/EZG-Datei|EZG-Datei]]). Zeitreihen-Nummern müssen fortlaufend und aufsteigend sein.
-Ab Talsim-NG.Engine v3.1.7 werden alle Zeitreihen als aktiv behandelt, unabhängig von der Eingabe hier!
-<!--T:19-->
-In Versionen vor 3.1.7 wurden als inaktiv gekennzeichnete Zeitreihen nicht eingelesen und der Wert <code>0</code> für alle Zeitschritte verwendet!</div>
-</div>
-* <code>B</code> ('''ID'''): Zeitreihen-Nummer zur Referenzierung in anderen EIngabedateien (z.B. [[Special:MyLanguage/EZG-Datei|EZG-Datei]]). Zeitreihen-Nummern müssen fortlaufend und aufsteigend sein.
 [[Datei:00036.png|thumb|Interpretation von Zeitreihen]]
-* <code>C</code> ('''Interpretation'''): Interpretation der Zeitreihe. Mögliche Werte:
+* <code>Intp</code> (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
 ** <code>1</code>: Momentaner_Wert_(Lineare_Interpolation)
 ** <code>2</code>: BlockRechts
@@ Zeile 85: / Zeile 63: @@
 ** <code>5</code>: SummeProZeitschritt
 ** <code>99</code>: Undefiniert
-* <code>D</code> ('''Einheit'''):
+* <code>Unit</code>:
-* <code>E</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>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>F</code> ('''Objekt-ID'''): irrelevante Nummer (kann weggelassen werden)
+* <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>G</code> ('''ZreID'''): Zeitreihen-ID. Aus dieser ID wird der Dateiname der Zeitreihendatei hergeleitet (z.B. ZreID <code>2136</code> &rarr; Datei <code>00002136.bin</code>)
+<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>
-* <code>H</code> ('''DBID'''): irrelevante Nummer (kann weggelassen werden)
+<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>I</code> ('''Hoehe'''): Geländehöhe der zugehörigen Station (wird für die Anpassung von Temperaturzeitreihen an unterschiedliche Höhen von Einzugsgebieten verwendet).
+* <code>Err</code> (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
-<div class="achtung">Wenn keine höhenabhängige Temperaturanpassung erfolgen soll, muss hier <code>-777</code> eingetragen werden, ansonsten wird eine Höhe von <code>0</code> angenommen!</div>
-* <code>J</code> ('''Err'''): 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
-* <code>K</code> ('''Bezeichnung'''): optionale freie Bezeichnung der Zeitreihe
+<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
+** <code>DB</code>: Zeitreihe im Sydro SQLite-Format
+::'''Hinweis''': Zeitreihen im SQlite-Format werden automatisch zu Simulationsbeginn in einem Unterordner "converted" zum BIN-Format konvertiert.
+* <code>Flag</code>: Nur bei Zeitreihen im Sydro SQLite-Format der Klasse ''FlaggedTimeseries'' relevant: Flag der zur verwendenden Zeitreihe. Wenn nicht angegeben, wird <code>0</code> angenommen.
+* <code>Description</code>: optionale freie Bezeichnung der Zeitreihe
 </translate>