UPD-Datei: Unterschied zwischen den Versionen

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 Dateiformats
IsActive: 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 Nummerierung
- Active: Gibt an, ob die Variation dieses Parameters aktiv ist (1) oder nicht (0)
- Identifier: Eindeutiger Schlüssel zur Identifizierung des Parameters, muss mit dem Attribut name in der VAR-Datei übereinstimmen
- Type: Typ des Parameters (siehe Abschnitt VariationOption der sydrodomain.ini)
- KENSYS: Systemkennung des Elements, dessen Parameter variiert werden soll (falls zutreffend)
- IDObj: siehe Abschnitt VariationOption der sydrodomain.ini
- IDDatabase: siehe Abschnitt VariationOption der sydrodomain.ini
- ParKey: siehe Abschnitt VariationOption der sydrodomain.ini
- ParName: siehe Abschnitt VariationOption der sydrodomain.ini
- ParType: siehe Abschnitt VariationOption der sydrodomain.ini
- Input-File: Dateiname der VAR-Datei, welche die Parameterwerte enthält
- PrePostCalc: Zeitpunkt, zu dem der Parameterwert gesetzt werden soll. Mögliche Werte:
  - PRE: Vor der Systeminitialisierung. Dies ist z.B. für übergeordnete Parameter wie SIMSTART, 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 wie BF0, 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>

@@ Zeile 1: / Zeile 1: @@
+<languages/>
+<translate>
+<!--T:1-->
 {{ASCII-Datensatz}}
+<!--T:2-->
 __TOC__
-Die UPD-Datei enthält allgemeine Angaben zur Simulation
-==Beispiel==
+<!--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.
+==Beispiel== <!--T:3-->
+<!--T:4-->
 <pre>
 #Variation/Update-Konfiguration:
 [SETTINGS]
 VERSION=1.2
-IsActive=0
+IsActive=1
 [ATTRIBUTES]
-CountAttributes=0
+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;Simulationsbeginn;SYS;;;;SIM;SIMSTART;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsbeginn TT MM JJJJ hh mm
+;1;Simulationsende;SYS;;;;SIM;SIMEND;DATE;Simulation_Einstellungen.var;PRE;0;Simulationsende TT MM JJJJ hh mm
+;1;AD31_BOF;;AD31;;;BF0;;SNGL;dhuennNA_BOF.var;POST;0;Anfangsbodenfeuchte in [% von FK]
+;1;AD32_BOF;;AD32;;;BF0;;SNGL;dhuennNA_BOF.var;POST;0;Anfangsbodenfeuchte in [% von FK]
+;1;AD22_QBA;;AD22;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2]
+;1;AD27_QBA;;AD27;;;QBASIS;;SNGL;dhuennNA_QBA.var;POST;0;Anfangsbasisabfluss in [l/s*km2]
+<!--T:13-->
 [SimulationVariants]
 =defaultSim;1;Standard-Simulation
+=Variante_1;1;Simulation mit neuen Einstellungen
 </pre>
-==Erläuterungen==
+==Erläuterungen== <!--T:5-->
-===<code>[SETTINGS]</code>===
+===<code>[SETTINGS]</code>=== <!--T:6-->
+<!--T:7-->
 * <code>VERSION</code>: Versionsnummer des Dateiformats
-* <code>IsActive</code>: Versionsnummer des Dateiformats
+* <code>IsActive</code>: Gibt an, ob Variationen/Updates angewendet werden sollen (<code>1</code>) oder nicht (<code>0</code>)
+===<code>[ATTRIBUTES]</code>=== <!--T:8-->
+<!--T:9-->
+* <code>CountAttributes</code>: Anzahl der Parameter
+Es folgt die Liste der zu variierenden Parameter im CSV-Format mit folgenden Spalten:
+** <code>ID</code>: Fortlaufende Nummerierung
+** <code>Active</code>: Gibt an, ob die Variation dieses Parameters aktiv ist (<code>1</code>) oder nicht (<code>0</code>)
+** <code>Identifier</code>: Eindeutiger Schlüssel zur Identifizierung des Parameters, muss mit dem Attribut <code>name</code> in der [[Special:MyLanguage/VAR-Datei|VAR-Datei]] übereinstimmen
+** <code>Type</code>: Typ des Parameters (siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code>)
+** <code>KENSYS</code>: Systemkennung des Elements, dessen Parameter variiert werden soll (falls zutreffend)
+** <code>IDObj</code>: siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code>
+** <code>IDDatabase</code>: siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code>
+** <code>ParKey</code>: siehe Abschnitt <code>VariationOption</code> der <code>[[Special:MyLanguage/sydrodomain.ini|sydrodomain.ini]]</code>
+** <code>ParName</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>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>[SimulationVariants]</code>=== <!--T:10-->
+<!--T:11-->
+Liste der Variationen im CSV-Format mit folgenden Spalten:
+* 1. Spalte: Variation-ID und Name im Format <code><ID>=<NAME></code>
+* 2. Spalte: <span style="color:red">?</span>
+* 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>
+|      |------ 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|
+*|      |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|------|-|
+|      |-------- 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>
+;1;TWUP_QA1;;TWUP;;;QACTIVE;QA1;BOOL;Wupper_parameters.var;POST;0;Aktivierung Speicherabgabesequenz [J/N]
+;1;TWUP_QA1;;TWUP;;;QAB;QA1;SNGL;Wupper_QA1.var;POST;1;Abgabensequenz aus der Wupper-Talsperre [m3/s]
+</pre>
-===<code>[ATTRIBUTES]</code>===
+<code>Wupper_parameters.var</code>:
-* <code>CountAttributes</code>: Versionsnummer des Dateiformats
+<source lang="xml">
-* <code>IsActive</code>: Versionsnummer des Dateiformats
+<?xml version="1.0" ?>
+<variation_para>
+<section name="TWUP_QA1">
+Values=1
+	                   0
+</section>
+</variation_para>
+</source>
-===<code>[SimulationVariants]</code>===
+<code>Wupper_QA1.var</code>:
+<source lang="xml">
+<?xml version="1.0" ?>
+<variation_para>
+<section name="TWUP_QA1">
+Values=10
+	                 4.0
+	                 5.0
+	                 6.0
+	                 5.0
+	                 4.0
+	                 4.0
+	                 4.0
+	                 4.0
+	                 4.0
+	                 4.0
+</section>
+</variation_para>
+</source>