UPD-Datei

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

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>