UPD-Datei: Unterschied zwischen den Versionen
(Seite von der Übersetzung entfernt) Markierung: Zurückgesetzt |
(Änderung 13641 von Froehlich (Diskussion) rückgängig gemacht.) Markierung: Rückgängigmachung |
||
Zeile 1: | Zeile 1: | ||
<languages/> | |||
<translate> | |||
<!--T:1--> | |||
{{ASCII-Datensatz}} | {{ASCII-Datensatz}} | ||
<!--T:2--> | |||
__TOC__ | __TOC__ | ||
<!--T:12--> | |||
Die UPD-Datei gibt vor, welche Parameter durch [[Special:MyLanguage/Variationen|Variationen]] verändert werden sollen. Die dabei möglichen Parameter sind im Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code> definiert. | Die UPD-Datei gibt vor, welche Parameter durch [[Special:MyLanguage/Variationen|Variationen]] verändert werden sollen. Die dabei möglichen Parameter sind im Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code> definiert. | ||
==Beispiel== | ==Beispiel== <!--T:3--> | ||
<!--T:4--> | |||
<pre> | <pre> | ||
#Variation/Update-Konfiguration: | #Variation/Update-Konfiguration: | ||
Zeile 15: | Zeile 21: | ||
[ATTRIBUTES] | [ATTRIBUTES] | ||
CountAttributes=6 | CountAttributes=6 | ||
#ID;Active;Identifier;Type;KENSYS;IDObj;IDDatabase;ParKey;ParName;ParType;Input-File;PrePostCalc;Beschreibung | #ID;Active;Identifier;Type;KENSYS;IDObj;IDDatabase;ParKey;ParName;ParType;Input-File;PrePostCalc;Multiline;Beschreibung | ||
1;1;Simulationsbeginn;SYS;;;;SIM;SIMSTART;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsbeginn TT MM JJJJ hh mm | 1;1;Simulationsbeginn;SYS;;;;SIM;SIMSTART;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsbeginn TT MM JJJJ hh mm | ||
2;1;Simulationsende;SYS;;;;SIM;SIMEND;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsende TT MM JJJJ hh mm | 2;1;Simulationsende;SYS;;;;SIM;SIMEND;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsende TT MM JJJJ hh mm | ||
Zeile 23: | Zeile 29: | ||
6;1;AD27_QBA;;AD27;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2] | 6;1;AD27_QBA;;AD27;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2] | ||
<!--T:13--> | |||
[SimulationVariants] | [SimulationVariants] | ||
0=defaultSim;1;Standard-Simulation | 0=defaultSim;1;Standard-Simulation | ||
Zeile 28: | Zeile 35: | ||
</pre> | </pre> | ||
==Erläuterungen== | ==Erläuterungen== <!--T:5--> | ||
===<code>[SETTINGS]</code>=== | ===<code>[SETTINGS]</code>=== <!--T:6--> | ||
<!--T:7--> | |||
* <code>VERSION</code>: Versionsnummer des Dateiformats | * <code>VERSION</code>: Versionsnummer des Dateiformats | ||
* <code>IsActive</code>: Gibt an, ob Variationen/Updates angewendet werden sollen (<code>1</code>) oder nicht (<code>0</code>) | * <code>IsActive</code>: Gibt an, ob Variationen/Updates angewendet werden sollen (<code>1</code>) oder nicht (<code>0</code>) | ||
===<code>[ATTRIBUTES]</code>=== | ===<code>[ATTRIBUTES]</code>=== <!--T:8--> | ||
<!--T:9--> | |||
* <code>CountAttributes</code>: Anzahl der Parameter | * <code>CountAttributes</code>: Anzahl der Parameter | ||
Es folgt die Liste der zu variierenden Parameter im CSV-Format mit folgenden Spalten: | Es folgt die Liste der zu variierenden Parameter im CSV-Format mit folgenden Spalten: | ||
Zeile 50: | Zeile 59: | ||
** <code>ParType</code>: siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code> | ** <code>ParType</code>: siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code> | ||
** <code>Input-File</code>: Dateiname der [[Special:MyLanguage/VAR-Datei|VAR-Datei]], welche die Parameterwerte enthält | ** <code>Input-File</code>: Dateiname der [[Special:MyLanguage/VAR-Datei|VAR-Datei]], welche die Parameterwerte enthält | ||
** <code>PrePostCalc</code>: Zeitpunkt, zu dem der Parameterwert gesetzt werden soll: | ** <code>PrePostCalc</code>: Zeitpunkt, zu dem der Parameterwert gesetzt werden soll. Mögliche Werte: | ||
*** <code>PRE</code>: Vor der Systeminitialisierung. Dies ist z.B. für übergeordnete Parameter wie <code>SIMSTART</code>, <code>SIMEND</code>, etc. geeignet. | |||
*** <code>PRES</code>: PRESTART <span style="color:red;">???</span> | |||
*** <code>POST</code>: Nach der Systeminitialisierung, dem Setzen der Anfangsbedingungen und dem eventuellen Einlesen von State-Dateien (siehe [[Special:MyLanguage/ABZ-Datei|ABZ-Datei]]). Dies ist z.B. für Parameter wie <code>BF0</code>, <code>SNOWSCALING</code> etc. geeignet, wenn diese alle zuvor eingelesenen Parameterwerte überschreiben sollen. | |||
** <code>Multiline</code>: <code>0</code> wenn der zugehörige Parameterwert in der [[VAR-Datei]] aus nur einem Wert pro Variation besteht, <code>1</code> wenn er pro Variation aus mehreren Werten in multiplen Zeilen besteht. | |||
** <code>Beschreibung</code>: Freitext | ** <code>Beschreibung</code>: Freitext | ||
===<code>[SimulationVariants]</code>=== | ===<code>[SimulationVariants]</code>=== <!--T:10--> | ||
<!--T:11--> | |||
Liste der Variationen im CSV-Format mit folgenden Spalten: | Liste der Variationen im CSV-Format mit folgenden Spalten: | ||
* 1. Spalte: Variation-ID und Name im Format <code><ID>=<NAME></code> | * 1. Spalte: Variation-ID und Name im Format <code><ID>=<NAME></code> | ||
* 2. Spalte: <span style="color:red">?</span> | * 2. Spalte: <span style="color:red">?</span> | ||
* 3. Spalte: Freitext | * 3. Spalte: Freitext | ||
</translate> | |||
===Hinweise=== | |||
====Übersteuern einer Talsperre==== | |||
Zum Übersteuern einer Talsperrenabgabe mit einer Abgabensequenz, z.B. im Kontext von einer FEWS-Implementierung, kann man wie folgt vorgehen: | |||
In der TAL-Datei eine Abgabe für die Abgabesequenz definieren, die mittels interner Abhängigkeit mit <code>HardOnOff=1</code> andere Abgaben deaktiviert. | |||
TAL-Datei: | |||
<pre> | |||
4| |------ STEUER / RELEASE - FUNCTIONS -----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|------|-| | |||
*| | | | | Grz|A |(3,4) | (1) | (2) | | | Werte Aenderung / Update intervall | | | | |||
*| | Function |outd KTR | Fun | S Z F Con| Key |HYA J W T | QM |File | | Axis labels |Key|Intervall Bezugsdatum |con. Pattern| Elev |E| | |||
*| | |flow ID | Key | Y/N ID | 1-4 |ID GG GG GG| m3/s | No. | y-Pos | X-Axis Y-Axis |0-3|Typ Factor Reference date |JGG WGG TGG | masl | | | |||
*| |<------------------>|<-->-<-->|-<->-|-+-+-+-<->|+<->-|<->-<-><-><->|<---->|-<->-|-<-------->-|<-------------><------------->|<->|<->-<---->-DD.MM.YYYY HH:mm|<->-<->-<->-|<---->|+| | |||
| |Abgabensequenz |S352 | QA1 | J N 3 |J 0 | | 1| | 3798.652 | | 0| 4 1|01.01.1990 | | 0|J| | |||
| |HW - Klappen l+r obe|S352 | QH5 | J N 3 |J 1 | | 1| | 795.27 | | 0| 4 1|01.01.1990 | | 0|J| | |||
| |Mindestabgabe |S352 y118| QM1 | N N 3 |J 1 | | 1| | 3028.143 | | 0| 4 1|01.01.1990 | | 0|J| | |||
| |NWA-Kluserbr |S352 y100| QN1 | N N 3 |J 1 | | 1| | 2340.657 | | 0| 4 1|01.01.1990 | | 0|J| | |||
| |HSR f(Qzu) |S352 y116| QS1 | J N 3 |J 1 | | 1| | 1641.519 | | 0| 4 1|01.01.1990 | | 0|J| | |||
*| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|------|-| | |||
5| |-------- INTERNE ABHAENGIGKEITEN / INTERNAL DEPENDENCIES ----------|------|-----|------------|------------------------------|--------------------------------------------| | |||
*| | | | | | | | | |||
*| | Fun | QM JGG WGG TGG | Storage JGG WGG | Fun Fun Fun Fun | |Hard | | | | | |||
*| | Key | cbm/s | Tsd.cbm | Nam Nam Nam Nam |Rank |OnOff| | | | | |||
*| |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|<->---|-----|------------|------------------------------|--------------------------------------------| | |||
| | QA1 |>= 0 |<= 28968 | QM1 QN1 QS1 | 1 | 1 | | | | | |||
*|------|-----|---------------------|---------------------|-----------------|------|-----|------------|------------------------------|--------------------------------------------| | |||
</pre> | |||
Diese Abgabe muss schon vornherein '''aktiviert''' sein und kann dann aber über ein Update wie unten gezeigt bei Bedarf deaktiviert werden. (Anders herum ist es derzeit nicht möglich!) | |||
UPD-Datei: | |||
<pre> | |||
367;1;TWUP_QA1;;TWUP;;;QACTIVE;QA1;BOOL;Wupper_parameters.var;POST;0;Aktivierung Speicherabgabesequenz [J/N] | |||
368;1;TWUP_QA1;;TWUP;;;QAB;QA1;SNGL;Wupper_QA1.var;POST;1;Abgabensequenz aus der Wupper-Talsperre [m3/s] | |||
</pre> | |||
<code>Wupper_parameters.var</code>: | |||
<source lang="xml"> | |||
<?xml version="1.0" ?> | |||
<variation_para> | |||
<section name="TWUP_QA1"> | |||
Values=1 | |||
1 0 | |||
</section> | |||
</variation_para> | |||
</source> | |||
<code>Wupper_QA1.var</code>: | |||
<source lang="xml"> | |||
<?xml version="1.0" ?> | |||
<variation_para> | |||
<section name="TWUP_QA1"> | |||
Values=10 | |||
1 4.0 | |||
1 5.0 | |||
1 6.0 | |||
1 5.0 | |||
1 4.0 | |||
1 4.0 | |||
1 4.0 | |||
1 4.0 | |||
1 4.0 | |||
1 4.0 | |||
</section> | |||
</variation_para> | |||
</source> |
Aktuelle Version vom 26. April 2024, 10:57 Uhr
Die UPD-Datei gibt vor, welche Parameter durch Variationen verändert werden sollen. Die dabei möglichen Parameter sind im Abschnitt VariationOption
der sydrodomain.ini
definiert.
Beispiel
#Variation/Update-Konfiguration: [SETTINGS] VERSION=1.2 IsActive=1 [ATTRIBUTES] CountAttributes=6 #ID;Active;Identifier;Type;KENSYS;IDObj;IDDatabase;ParKey;ParName;ParType;Input-File;PrePostCalc;Multiline;Beschreibung 1;1;Simulationsbeginn;SYS;;;;SIM;SIMSTART;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsbeginn TT MM JJJJ hh mm 2;1;Simulationsende;SYS;;;;SIM;SIMEND;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsende TT MM JJJJ hh mm 3;1;AD31_BOF;;AD31;;;BF0;;SNGL;dhuennNA_BOF.var;POST;0;Anfangsbodenfeuchte in [% von FK] 4;1;AD32_BOF;;AD32;;;BF0;;SNGL;dhuennNA_BOF.var;POST;0;Anfangsbodenfeuchte in [% von FK] 5;1;AD22_QBA;;AD22;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2] 6;1;AD27_QBA;;AD27;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2] [SimulationVariants] 0=defaultSim;1;Standard-Simulation 1=Variante_1;1;Simulation mit neuen Einstellungen
Erläuterungen
[SETTINGS]
VERSION
: Versionsnummer des DateiformatsIsActive
: Gibt an, ob Variationen/Updates angewendet werden sollen (1
) oder nicht (0
)
[ATTRIBUTES]
CountAttributes
: Anzahl der Parameter
Es folgt die Liste der zu variierenden Parameter im CSV-Format mit folgenden Spalten:
ID
: Fortlaufende NummerierungActive
: Gibt an, ob die Variation dieses Parameters aktiv ist (1
) oder nicht (0
)Identifier
: Eindeutiger Schlüssel zur Identifizierung des Parameters, muss mit dem Attributname
in der VAR-Datei übereinstimmenType
: Typ des Parameters (siehe AbschnittVariationOption
dersydrodomain.ini
)KENSYS
: Systemkennung des Elements, dessen Parameter variiert werden soll (falls zutreffend)IDObj
: siehe AbschnittVariationOption
dersydrodomain.ini
IDDatabase
: siehe AbschnittVariationOption
dersydrodomain.ini
ParKey
: siehe AbschnittVariationOption
dersydrodomain.ini
ParName
: siehe AbschnittVariationOption
dersydrodomain.ini
ParType
: siehe AbschnittVariationOption
dersydrodomain.ini
Input-File
: Dateiname der VAR-Datei, welche die Parameterwerte enthältPrePostCalc
: Zeitpunkt, zu dem der Parameterwert gesetzt werden soll. Mögliche Werte:PRE
: Vor der Systeminitialisierung. Dies ist z.B. für übergeordnete Parameter wieSIMSTART
,SIMEND
, etc. geeignet.PRES
: PRESTART ???POST
: Nach der Systeminitialisierung, dem Setzen der Anfangsbedingungen und dem eventuellen Einlesen von State-Dateien (siehe ABZ-Datei). Dies ist z.B. für Parameter wieBF0
,SNOWSCALING
etc. geeignet, wenn diese alle zuvor eingelesenen Parameterwerte überschreiben sollen.
Multiline
:0
wenn der zugehörige Parameterwert in der VAR-Datei aus nur einem Wert pro Variation besteht,1
wenn er pro Variation aus mehreren Werten in multiplen Zeilen besteht.Beschreibung
: Freitext
[SimulationVariants]
Liste der Variationen im CSV-Format mit folgenden Spalten:
- 1. Spalte: Variation-ID und Name im Format
<ID>=<NAME>
- 2. Spalte: ?
- 3. Spalte: Freitext
Hinweise
Übersteuern einer Talsperre
Zum Übersteuern einer Talsperrenabgabe mit einer Abgabensequenz, z.B. im Kontext von einer FEWS-Implementierung, kann man wie folgt vorgehen:
In der TAL-Datei eine Abgabe für die Abgabesequenz definieren, die mittels interner Abhängigkeit mit HardOnOff=1
andere Abgaben deaktiviert.
TAL-Datei:
4| |------ STEUER / RELEASE - FUNCTIONS -----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|------|-| *| | | | | Grz|A |(3,4) | (1) | (2) | | | Werte Aenderung / Update intervall | | | *| | Function |outd KTR | Fun | S Z F Con| Key |HYA J W T | QM |File | | Axis labels |Key|Intervall Bezugsdatum |con. Pattern| Elev |E| *| | |flow ID | Key | Y/N ID | 1-4 |ID GG GG GG| m3/s | No. | y-Pos | X-Axis Y-Axis |0-3|Typ Factor Reference date |JGG WGG TGG | masl | | *| |<------------------>|<-->-<-->|-<->-|-+-+-+-<->|+<->-|<->-<-><-><->|<---->|-<->-|-<-------->-|<-------------><------------->|<->|<->-<---->-DD.MM.YYYY HH:mm|<->-<->-<->-|<---->|+| | |Abgabensequenz |S352 | QA1 | J N 3 |J 0 | | 1| | 3798.652 | | 0| 4 1|01.01.1990 | | 0|J| | |HW - Klappen l+r obe|S352 | QH5 | J N 3 |J 1 | | 1| | 795.27 | | 0| 4 1|01.01.1990 | | 0|J| | |Mindestabgabe |S352 y118| QM1 | N N 3 |J 1 | | 1| | 3028.143 | | 0| 4 1|01.01.1990 | | 0|J| | |NWA-Kluserbr |S352 y100| QN1 | N N 3 |J 1 | | 1| | 2340.657 | | 0| 4 1|01.01.1990 | | 0|J| | |HSR f(Qzu) |S352 y116| QS1 | J N 3 |J 1 | | 1| | 1641.519 | | 0| 4 1|01.01.1990 | | 0|J| *| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|------|-| 5| |-------- INTERNE ABHAENGIGKEITEN / INTERNAL DEPENDENCIES ----------|------|-----|------------|------------------------------|--------------------------------------------| *| | | | | | | | *| | Fun | QM JGG WGG TGG | Storage JGG WGG | Fun Fun Fun Fun | |Hard | | | | *| | Key | cbm/s | Tsd.cbm | Nam Nam Nam Nam |Rank |OnOff| | | | *| |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|<->---|-----|------------|------------------------------|--------------------------------------------| | | QA1 |>= 0 |<= 28968 | QM1 QN1 QS1 | 1 | 1 | | | | *|------|-----|---------------------|---------------------|-----------------|------|-----|------------|------------------------------|--------------------------------------------|
Diese Abgabe muss schon vornherein aktiviert sein und kann dann aber über ein Update wie unten gezeigt bei Bedarf deaktiviert werden. (Anders herum ist es derzeit nicht möglich!)
UPD-Datei:
367;1;TWUP_QA1;;TWUP;;;QACTIVE;QA1;BOOL;Wupper_parameters.var;POST;0;Aktivierung Speicherabgabesequenz [J/N] 368;1;TWUP_QA1;;TWUP;;;QAB;QA1;SNGL;Wupper_QA1.var;POST;1;Abgabensequenz aus der Wupper-Talsperre [m3/s]
Wupper_parameters.var
:
<?xml version="1.0" ?> <variation_para> <section name="TWUP_QA1"> Values=1 1 0 </section> </variation_para>
Wupper_QA1.var
:
<?xml version="1.0" ?> <variation_para> <section name="TWUP_QA1"> Values=10 1 4.0 1 5.0 1 6.0 1 5.0 1 4.0 1 4.0 1 4.0 1 4.0 1 4.0 1 4.0 </section> </variation_para>