EXT-Datei/de: Unterschied zwischen den Versionen

Version vom 20. September 2021, 18:39 Uhr

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

Für das neuere Dateiformat v1.5 siehe EXT-Datei 1.5

Beispiel

*Input-Zeitreihen (*.EXT)
*========================
[SETTINGS]
VERSION=1.4
PATHNet=
PATHLocal=..\..\Datensaetze\LTV\ZRE\
*|--------|------------|-----------------------------------------|
*|   ID   | Einh       |  ObjID    ZreID     DBID     Hoehe  Err |Bezeichnung
*|-<---->-|+<-------->+|-<------>-<------>-<------>-<------>--+--|
*|A   B   |C    D     E|     F       G        H         I     J  |K
 |1  1    |5mm        0| 2013     2136     100      0         3  |ETpen.Lehnmuehle.mm/d.2136
 |1  2    |5mm        0| 2014     2137     100      0         3  |ETpen.Klingenberg.mm/d.2137
 |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
*|--------|------------|-----------------------------------------|

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.

Ab Talsim-NG.Engine v3.1.7 werden alle Zeitreihen als aktiv behandelt, unabhängig von der Eingabe hier!

In Versionen vor 3.1.7 wurden als inaktiv gekennzeichnete Zeitreihen nicht eingelesen und der Wert 0 für alle Zeitschritte verwendet!

B (ID): Zeitreihen-Nummer zur Referenzierung in anderen EIngabedateien (z.B. EZG-Datei). Zeitreihen-Nummern müssen fortlaufend und aufsteigend sein.

Interpretation von Zeitreihen

C (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
- 1: Momentaner_Wert_(Lineare_Interpolation)
- 2: BlockRechts
- 3: BlockLinks
- 4: Summenlinie
- 5: SummeProZeitschritt
- 99: Undefiniert
D (Einheit):
E (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.
F (Objekt-ID): irrelevante Nummer (kann weggelassen werden)
G (ZreID): Zeitreihen-ID. Aus dieser ID wird der Dateiname der Zeitreihendatei hergeleitet (z.B. ZreID 2136 → Datei 00002136.bin)
H (DBID): irrelevante Nummer (kann weggelassen werden)
I (Hoehe): 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 -777 eingetragen werden, ansonsten wird eine Höhe von 0 angenommen!

J (Err): 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
K (Bezeichnung): optionale freie Bezeichnung der Zeitreihe

@@ Zeile 3: / Zeile 3: @@
 {{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__
-Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen
+Die EXT-Datei enthält Angaben zu den Inputdaten der Zeitreihen.
+<div class="info">Für das neuere Dateiformat v1.5 siehe [[Special:MyLanguage/EXT-Datei 1.5|EXT-Datei 1.5]]</div>
 ==Beispiel==
 <pre class="brush:plain">
 *Input-Zeitreihen (*.EXT)
 *========================
 [SETTINGS]
-VERSION=1.5
+VERSION=1.4
-PATHNet=\\server\path\to\timeseries\
+PATHNet=
-PATHLocal=D:\path\to\timeseries\
+PATHLocal=..\..\Datensaetze\LTV\ZRE\
-*|---|----|----|------|-----|------|---|------------------------|----|-------------
+*|--------|------------|-----------------------------------------|
-*| A | No |Intp| Unit |NoInp| Elev |Err| File                   |Flag| Description
+*|   ID   | Einh       |  ObjID    ZreID     DBID     Hoehe  Err |Bezeichnung
-*|---|----|----|------|-----|------|---|------------------------|----|-------------
+*|-<---->-|+<-------->+|-<------>-<------>-<------>-<------>--+--|
-  | 1 |  1 | 3  | mm   |  0  |      | 3 | 00001859.bin           |    |BIN timeseries
+*|A   B   |C    D     E|     F       G        H         I     J  |K
-  | 1 |  2 | 3  | mm   |  0  |      | 3 | subfolder\00000001.db  |    |SQLite Timeseries
+  |1  1    |5mm        0| 2013     2136     100      0         3  |ETpen.Lehnmuehle.mm/d.2136
-  | 1 |  3 | 3  | mm   |  0  |      | 3 | 00406420.db            | 1  |SQLite Flagged Timeseries
+  |1  2    |5mm        0| 2014     2137     100      0         3  |ETpen.Klingenberg.mm/d.2137
-*|---|----|----|------|-----|------|---|------------------------|----|-------------
+ |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>
-Die Spaltenbreite kann nach Bedarf angepasst werden, alle Trennzeichen (<code>|</code>) müssen jedoch erhalten bleiben. Zeilen, die mit <code>*</code> beginnen, werden ignoriert.
@@ Zeile 46: / Zeile 63: @@
 ===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.
-* <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>).
+<div class="achtung">
+Ab Talsim-NG.Engine v3.1.7 werden alle Zeitreihen als aktiv behandelt, unabhängig von der Eingabe hier!
+In Versionen vor 3.1.7 wurden als inaktiv gekennzeichnete Zeitreihen nicht eingelesen und der Wert <code>0</code> für alle Zeitschritte verwendet!</div>
+</div>
+* <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.
 [[Datei:00036.png|thumb|Interpretation von Zeitreihen]]
-* <code>Intp</code> (Interpretation): Interpretation der Zeitreihe. Mögliche Werte:
+* <code>C</code> ('''Interpretation'''): Interpretation der Zeitreihe. Mögliche Werte:
 ** <code>1</code>: Momentaner_Wert_(Lineare_Interpolation)
 ** <code>2</code>: BlockRechts
@@ Zeile 56: / Zeile 78: @@
 ** <code>5</code>: SummeProZeitschritt
 ** <code>99</code>: Undefiniert
-* <code>Unit</code>:
+* <code>D</code> ('''Einheit'''):
-* <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>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>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>F</code> ('''Objekt-ID'''): irrelevante Nummer (kann weggelassen werden)
-* <code>Err</code> (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte:
+* <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 <code>-777</code> eingetragen werden, ansonsten wird eine Höhe von <code>0</code> angenommen!</div>
+* <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>1</code>: Fehlwert ignorieren
@@ Zeile 65: / Zeile 91: @@
 ** <code>3</code>: Fehlwert interpolieren
 ** <code>4</code>: Bei Fehlwert abbrechen
-* <code>File</code>: Dateiname der Zeitreihendatei. Kann optional noch den Pfad von Unterzeichnissen enthalten. Unterstützte Dateiformate/Dateierweiterungen:
+* <code>K</code> ('''Bezeichnung'''): optionale freie Bezeichnung der Zeitreihe
-** <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