EXT-Datei: Unterschied zwischen den Versionen

Version vom 14. November 2023, 13:17 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>
+<!--T:1-->
 {{ASCII-Datensatz}}
 <div class="versionen">
 Versionen:
-* v1.5: '''aktuell''' (ab Talsim v3.1.3.0)
+* v1.5: '''aktuell'''
-* [http://www.talsim.de/docs/index.php?title=EXT-Datei&oldid=2072 v1.4: bis Talsim v3.1.2.1]
+* [http://www.talsim.de/docs/index.php?title=EXT-Datei&oldid=13417 v1.4]
 </div>
+<!--T:11-->
 __TOC__
-Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen
+Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen.
+==Beispiel== <!--T:3-->
-==Beispiel==
+<!--T:4-->
 <pre class="brush:plain">
 *Input-Zeitreihen (*.EXT)
@@ Zeile 14: / Zeile 23: @@
 [SETTINGS]
 VERSION=1.5
-PATHNet=\\server\path\to\timeseries\
+PATHNet=
-PATHLocal=D:\path\to\timeseries\
+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
+*| A |   No   |Intp | Unit       | NoInp | Elev     | Err | File                                       | Flag | Description
-*|---|----|----|------|-----|------|---|------------------------|----|-------------
+*|-+-|-<---->-|-+---|-<-------->-|-+-----|-<------>-|-+---|--------------------------------------------|-<-->-|-------------
-  | 1 |  1 | 3  | mm   |  0  |      | 3 | 00001859.bin           |    |BIN timeseries
+  | 1 |      2 | 2   | mm/d       | 0     |          | 3   | 00407331.bin                               |      |
-  | 1 |  2 | 3  | mm   |  0  |      | 3 | subfolder\00000001.db  |    |SQLite Timeseries
+  | 1 |      3 | 2   | mm/d       | 0     |          | 3   | sqlite.db                                  | 2    |
-  | 1 |  3 | 3  | mm   |  0  |      | 3 | 00406420.db            | 1  |SQLite Flagged Timeseries
+  | 1 |      4 | 2   | mm/d       | 0     |          | 3   | othertimeseries.bin                        |      |
-*|---|----|----|------|-----|------|---|------------------------|----|-------------
+ | 1 |      5 | 2   | mm/d       | 0     |          | 3   | subfolder/series.bin                       |      |
 </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==
+==Erläuterungen== <!--T:6-->
-===<code>[SETTINGS]</code>===
+===<code>[SETTINGS]</code>=== <!--T:7-->
+<!--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
-===Zeitreihenattribute===
+<!--T:21-->
-* <code>A</code> (Aktiv): Gibt an, ob die Zeitreihe aktiv (<code>1</code>) oder nicht (<code>0</code>) ist. Nur aktive Zeitreihen werden eingelesen und auch verwendet. Es können mehrere Zeitreihen mit der selben Nummer (<code>No</code>) angegeben werden, wovon aber nur eine aktiv sein darf.
+<div class="achtung">Die für <code>PATHNet</code> und <code>PATHLocal</code> angegebenen Pfade müssen mit einem <code>\</code> enden!</div>
-* <code>No</code>: Zeitreihen-Nummer zur Referenzierung in anderen EIngabedateien (z.B. [[EZG-Datei]]). Es können mehrere Zeitreihen mit der selben Nummer angegeben werden, wovon aber nur eine aktiv sein darf. Zeitreihen-Nummern müssen fortlaufend und aufsteigend sein(<span style="color:red">?</span>).
+===Zeitreihenattribute=== <!--T:9-->
+<!--T:10-->
+* <code>A</code> (Aktiv): Gibt an, ob die Zeitreihe aktiv (<code>1</code>) oder nicht (<code>0</code>) ist. Nur aktive Zeitreihen werden eingelesen.
+* <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.
 [[Datei:00036.png|thumb|Interpretation von Zeitreihen]]
 * <code>Intp</code> (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
 ** <code>1</code>: Momentaner_Wert_(Lineare_Interpolation)
-** <code>2</code>: BlockRechts_(Wert_links)
+** <code>2</code>: BlockRechts
-** <code>3</code>: BlockLinks_(Wert_rechts)
+** <code>3</code>: BlockLinks
 ** <code>4</code>: Summenlinie
 ** <code>5</code>: SummeProZeitschritt
@@ Zeile 47: / 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="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
@@ Zeile 60: / Zeile 81: @@
 * <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>