EXT-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
(Höhenkorrektur seit v3.2.7)
(Update auf EXT-Datei Format 1.5)
Zeile 1: Zeile 1:
<languages/>
<languages/>
<translate>
<translate>
</translate>
 
<!--T:1-->
{{ASCII-Datensatz}}
{{ASCII-Datensatz}}
<translate>


<!--T:11-->
<!--T:11-->
Zeile 9: Zeile 9:
Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen.
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">
<pre class="brush:plain">
*Input-Zeitreihen (*.EXT)
*Input-Zeitreihen (*.EXT)
*========================
*========================
[SETTINGS]
[SETTINGS]
VERSION=1.4
VERSION=1.5
PATHNet=
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 | | 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       |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>
</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>VERSION</code>: Versionsnummer des Dateiformats
* <code>PATHNet</code>: Netzwerkpfad zum Verzeichnis mit den Zeitreihen
* <code>PATHNet</code>: Netzwerkpfad zum Verzeichnis mit den Zeitreihen
* <code>PATHLocal</code>: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen
* <code>PATHLocal</code>: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen


<!--T:20-->
<div class="achtung">Die für <code>PATHNet</code> und <code>PATHLocal</code> angegebenen Pfade müssen mit einem <code>\</code> enden!</div>
<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. Nur aktive Zeitreihen werden eingelesen.  
* <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>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.
* <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]]
[[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>1</code>: Momentaner_Wert_(Lineare_Interpolation)
** <code>2</code>: BlockRechts
** <code>2</code>: BlockRechts
Zeile 81: Zeile 56:
** <code>5</code>: SummeProZeitschritt
** <code>5</code>: SummeProZeitschritt
** <code>99</code>: Undefiniert
** <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>)
* <code>H</code> ('''DBID'''): irrelevante Nummer (kann weggelassen werden)
* <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).
<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="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>
* <code>J</code> ('''Err'''): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
* <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>0</code>: Originalwert verwenden (bei BIN-Zeitreihen ist das der Wert -9999.999!)
** <code>1</code>: Fehlwert ignorieren
** <code>1</code>: Fehlwert ignorieren
Zeile 94: Zeile 66:
** <code>3</code>: Fehlwert interpolieren
** <code>3</code>: Fehlwert interpolieren
** <code>4</code>: Bei Fehlwert abbrechen
** <code>4</code>: Bei Fehlwert abbrechen
* <code>K</code> ('''Bezeichnung'''): optionale freie Bezeichnung der Zeitreihe
* <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>
</translate>

Version vom 6. Juli 2023, 17:46 Uhr


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).
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 (standardmäßig mit 0.0)
    • 3: Fehlwert interpolieren
    • 4: Bei Fehlwert abbrechen
  • 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