EXT-Datei/de: Unterschied zwischen den Versionen

Aus TALSIM Docs
(Übernehme Bearbeitung einer neuen Version der Quellseite)
 
(Übernehme Bearbeitung einer neuen Version der Quellseite)
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3: Zeile 3:
{{ASCII-Datensatz}}
{{ASCII-Datensatz}}


<div class="versionen">
Versionen:
* v1.5: '''aktuell''' (ab Talsim v3.1.3.0)
* [http://www.talsim.de/docs/index.php?title=EXT-Datei&oldid=2072 v1.4: bis Talsim v3.1.2.1]
</div>
__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==
==Beispiel==
Zeile 19: Zeile 13:
[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>




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==
==Erläuterungen==


===<code>[SETTINGS]</code>===
===<code>[SETTINGS]</code>===
Zeile 43: Zeile 35:
* <code>PATHLocal</code>: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen
* <code>PATHLocal</code>: Lokaler (optional relativer) Pfad zum Verzeichnis mit den Zeitreihen


<div class="achtung">Die für <code>PATHNet</code> und <code>PATHLocal</code> angegebenen Pfade müssen mit einem <code>\</code> enden!</div>


===Zeitreihenattribute===
===Zeitreihenattribute===


* <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.
[[Special:MyLanguage/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 58: Zeile 51:
* <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).
* <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>
* <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!)

Aktuelle Version vom 6. Juli 2023, 16:48 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
Abgerufen von „https://www.talsim.de/docs/index.php?title=EXT-Datei/de&oldid=13424“