EXT-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
K (Bezeichnung der Interpretations-Codes aktualisiert)
Markierung: Zurückgesetzt
(Zurücksetzen auf Dateiformat 1.4)
Markierung: Manuelle Zurücksetzung
Zeile 1: Zeile 1:
<languages/>
<translate>
<!--T:1-->
{{ASCII-Datensatz}}
{{ASCII-Datensatz}}
<!--T:2-->
<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== <!--T:3-->
 
<!--T:4-->
<pre class="brush:plain">
<pre class="brush:plain">
*Input-Zeitreihen (*.EXT)
*Input-Zeitreihen (*.EXT)
*========================
*========================
[SETTINGS]
[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>
</pre>




<!--T:5-->
==Erläuterungen==
Die Spaltenbreite kann nach Bedarf angepasst werden, alle Trennzeichen (<code>|</code>) müssen jedoch erhalten bleiben. Zeilen, die mit <code>*</code> beginnen, werden ignoriert.
===<code>[SETTINGS]</code>===
 
 
==Erläuterungen== <!--T:6-->
 
 
===<code>[SETTINGS]</code>=== <!--T:7-->
 
<!--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


 
===Zeitreihenattribute===
===Zeitreihenattribute=== <!--T:9-->
* <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>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>).
<!--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>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>).
[[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>C</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_(Wert_links)
** <code>3</code>: BlockLinks
** <code>3</code>: BlockLinks_(Wert_rechts)
** <code>4</code>: Summenlinie
** <code>4</code>: Summenlinie
** <code>5</code>: SummeProZeitschritt
** <code>5</code>: SummeProZeitschritt
** <code>99</code>: Undefiniert
** <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).
* <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 72: Zeile 74:
** <code>3</code>: Fehlwert interpolieren
** <code>3</code>: Fehlwert interpolieren
** <code>4</code>: Bei Fehlwert abbrechen
** <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
</translate>

Version vom 20. September 2021, 16:00 Uhr

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

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. 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.
  • B (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(?).
Interpretation von Zeitreihen
  • C (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
  • 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).
  • 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