UPD-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
(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: vor (<code>PRE</code>) oder nach (<code>POST</code>) der Initialisierung des Systems
** <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 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>