UPD-Datei: Unterschied zwischen den Versionen

Version vom 24. März 2021, 12:35 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;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: vor (PRE) oder nach (POST) der Initialisierung des Systems
- 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

@@ Zeile 7: / Zeile 7: @@
 <!--T:2-->
 __TOC__
-Die UPD-Datei enthält allgemeine Angaben zur Simulation
+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-->
@@ Zeile 17: / Zeile 17: @@
 [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
+;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]
 [SimulationVariants]
 =defaultSim;1;Standard-Simulation
+=Variante_1;1;Simulation mit neuen Einstellungen
 </pre>
 ==Erläuterungen== <!--T:5-->
 ===<code>[SETTINGS]</code>=== <!--T:6-->
@@ Zeile 33: / Zeile 39: @@
 <!--T:7-->
 * <code>VERSION</code>: Versionsnummer des Dateiformats
-* <code>IsActive</code>: <span style="color:red">???</span>
+* <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>: <span style="color:red">???</span>
+* <code>CountAttributes</code>: Anzahl der Parameter
-* <code>IsActive</code>: <span style="color:red">???</span>
+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: vor (<code>PRE</code>) oder nach (<code>POST</code>) der Initialisierung des Systems
+** <code>Beschreibung</code>: Freitext
 ===<code>[SimulationVariants]</code>=== <!--T:10-->
 <!--T:11-->
-* <code>defaultSim</code>: <span style="color:red">???</span>
+Liste der Variationen im CSV-Format mit folgenden Spalten:
-* <code>Standard-Simulation</code>: <span style="color:red">???</span>
+* 1. Spalte: Variation-ID und Name im Format <code><ID>=<NAME></code>
+* 2. Spalte: <span style="color:red">?</span>
+* 3. Spalte: Freitext
 </translate>