EXT-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
(→‎Zeitreihenattribute: Umgang mit Fehlwerten)
(Aktualisierung auf EXT-Format v1.5 (Talsim v3.1.3.0))
Markierung: Zurückgesetzt
Zeile 1: Zeile 1:
{{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
Zeile 8: Zeile 13:
*========================
*========================
[SETTINGS]
[SETTINGS]
VERSION=1.4
VERSION=1.5
PATHNet=
PATHNet=\\server\path\to\timeseries\
PATHLocal=..\..\Datensaetze\LTV\ZRE\
PATHLocal=D:\path\to\timeseries\
*|--------|------------|-----------------------------------------|
*|---|----|----|------|-----|------|---|------------------------|----|-------------
*|   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 |  1 | 3  | mm   |  0  |      | 3 | 00001859.bin          |    |BIN timeseries
  |1 1    |5mm        0| 2013    2136    100      0        3  |ETpen.Lehnmuehle.mm/d.2136
  | 1 |  2 | 3  | mm  |  0  |      | 3 | subfolder\00000001.db |   |SQLite Timeseries
  |1 2    |5mm        0| 2014    2137    100      0        3  |ETpen.Klingenberg.mm/d.2137
  | 1 |  3 | 3  | mm   |  0  |      | 3 | 00406420.db            | 1  |SQLite Flagged Timeseries
|1 3    |5mm        0| 2016    2218    100      0         3  |ETpen.5779Zinnwald-Georgenfeld.mm.Tag.2218
*|---|----|----|------|-----|------|---|------------------------|----|-------------
  |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>
</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.


==Erläuterungen==
==Erläuterungen==
Zeile 52: Zeile 35:


===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 ('''ID''') 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 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>B</code> ('''ID'''): 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>).
* <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>).
[[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_(Wert_links)
** <code>2</code>: BlockRechts_(Wert_links)
Zeile 62: Zeile 45:
** <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>Err</code> (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
* <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).
* <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>0</code>: Originalwert verwenden (bei BIN-Zeitreihen ist das der Wert -9999.999!)
** <code>1</code>: Fehlwert ignorieren
** <code>1</code>: Fehlwert ignorieren
Zeile 74: Zeile 54:
** <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

Version vom 14. September 2020, 15:54 Uhr

Versionen:

Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen

Beispiel

*Input-Zeitreihen (*.EXT)
*========================
[SETTINGS]
VERSION=1.5
PATHNet=\\server\path\to\timeseries\
PATHLocal=D:\path\to\timeseries\
*|---|----|----|------|-----|------|---|------------------------|----|-------------
*| A | No |Intp| Unit |NoInp| Elev |Err| File                   |Flag| Description
*|---|----|----|------|-----|------|---|------------------------|----|-------------
 | 1 |  1 | 3  | mm   |  0  |      | 3 | 00001859.bin           |    |BIN timeseries
 | 1 |  2 | 3  | mm   |  0  |      | 3 | subfolder\00000001.db  |    |SQLite Timeseries
 | 1 |  3 | 3  | mm   |  0  |      | 3 | 00406420.db            | 1  |SQLite Flagged Timeseries
*|---|----|----|------|-----|------|---|------------------------|----|-------------


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

Zeitreihenattribute

  • A (Aktiv): Gibt an, ob die Zeitreihe aktiv (1) oder nicht (0) ist. Nur aktive Zeitreihen werden eingelesen und auch verwendet. Es können mehrere Zeitreihen mit der selben Nummer (No) angegeben werden, wovon aber nur eine aktiv sein darf.
  • No: 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(?).
Interpretation von Zeitreihen
  • Intp (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
    • 1: Momentaner_Wert_(Lineare_Interpolation)
    • 2: BlockRechts_(Wert_links)
    • 3: BlockLinks_(Wert_rechts)
    • 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).
  • 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