EXT-Datei: Unterschied zwischen den Versionen
(→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. | VERSION=1.5 | ||
PATHNet= | PATHNet=\\server\path\to\timeseries\ | ||
PATHLocal= | 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 | | 1 | 2 | 3 | mm | 0 | | 3 | subfolder\00000001.db | |SQLite Timeseries | ||
| 1 | 3 | 3 | mm | 0 | | 3 | 00406420.db | 1 |SQLite Flagged Timeseries | |||
*|---|----|----|------|-----|------|---|------------------------|----|------------- | |||
| | |||
|1 | |||
| | |||
| | |||
|1 | |||
| | |||
</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> ( | * <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> | * <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> | * <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> | * <code>Unit</code>: | ||
* <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> | * <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>Err</code> (Error handling): Gibt an, wie mit Fehlwerten in Zeitreihen umgegangen werden soll. Mögliche Werte: | |||
* <code> | |||
** <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> | * <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
ASCII-Datensatz: ALL SYS EXT RFD | EIN EZG TAL TRS URB VER | FKT JGG WGG TGG OPF QAB | LNZ BOA BOD EFL HYA HYO | KTR | KAL | QUA TEM | ABZ PRO SCE UPD VAR ZIE | SIMINFO TXT
Versionen:
- v1.5: aktuell (ab Talsim v3.1.3.0)
- v1.4: bis Talsim v3.1.2.1
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 DateiformatsPATHNet
: Netzwerkpfad zum Verzeichnis mit den ZeitreihenPATHLocal
: 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(?).
Intp
(Interpretation): Interpretation der Zeitreihe. Mögliche Werte:1
: Momentaner_Wert_(Lineare_Interpolation)2
: BlockRechts_(Wert_links)3
: BlockLinks_(Wert_rechts)4
: Summenlinie5
: SummeProZeitschritt99
: 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 ignorieren2
: Fehlwert ersetzen (standardmäßig mit0.0
)3
: Fehlwert interpolieren4
: Bei Fehlwert abbrechen
File
: Dateiname der Zeitreihendatei. Kann optional noch den Pfad von Unterzeichnissen enthalten. Unterstützte Dateiformate/Dateierweiterungen:BIN
: Zeitreihe im Sydro-BinärformatDB
: 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, wird0
angenommen.Description
: optionale freie Bezeichnung der Zeitreihe