EXT-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
(höhenabhängige Temperaturanpassung)
Markierung: Zurückgesetzt
Keine Bearbeitungszusammenfassung
(16 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 5: Zeile 5:
{{ASCII-Datensatz}}
{{ASCII-Datensatz}}


<!--T:2-->
<div class="versionen">
<div class="versionen">
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>
</div>
<!--T:11-->
__TOC__
__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:3-->
Zeile 23: Zeile 23:
[SETTINGS]
[SETTINGS]
VERSION=1.5
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>
</pre>


Zeile 37: Zeile 37:
<!--T:5-->
<!--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.
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:6-->
==Erläuterungen== <!--T:6-->


===<code>[SETTINGS]</code>=== <!--T:7-->
===<code>[SETTINGS]</code>=== <!--T:7-->
Zeile 49: Zeile 47:
* <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: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:9-->
===Zeitreihenattribute=== <!--T:9-->


<!--T:10-->
<!--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 und auch verwendet. Es können mehrere Zeitreihen mit der selben Nummer (<code>No</code>) angegeben werden, wovon aber nur eine aktiv sein darf.  
* <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>No</code>: Zeitreihen-Nummer zur Referenzierung in anderen EIngabedateien (z.B. [[Special:MyLanguage/EZG-Datei|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>).
* <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>Intp</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_(Wert_links)
** <code>2</code>: BlockRechts
** <code>3</code>: BlockLinks_(Wert_rechts)
** <code>3</code>: BlockLinks
** <code>4</code>: Summenlinie
** <code>4</code>: Summenlinie
** <code>5</code>: SummeProZeitschritt
** <code>5</code>: SummeProZeitschritt
Zeile 65: Zeile 65:
* <code>Unit</code>:
* <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>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). Wenn keine höhenabhängige Temperaturanpassung erfolgen soll, muss hier <code>-777</code> eingetragen 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.  
<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>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
** <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>3</code>: Fehlwert interpolieren
** <code>4</code>: Bei Fehlwert abbrechen
** <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>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>BIN</code>: Zeitreihe im Sydro-Binärformat

Version vom 14. November 2023, 13:17 Uhr


Versionen:

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
Abgerufen von „https://www.talsim.de/docs/index.php?title=EXT-Datei&oldid=13467“