OPF-Datei: Unterschied zwischen den Versionen

Aktuelle Version vom 26. April 2024, 09:41 Uhr

Mit der OPF-Datei können parametrisierte Funktionsverläufe definiert werden. Die so definierten Funktionen ersetzen bei der Simulation die jeweilige Funktion in der FKT-Datei.

Parametrisierte Funktionsverläufe eignen sich insbesonders für eine Optimierung von Funktionsverläufen, z.B. mit BlueM.Opt.

Beispiele für mögliche Funktionsverläufe

Der Funktionsverlauf ist durch folgende Gleichungen definiert (Wachstumsfunktion nach Verhulst):

[math]\displaystyle{ y(x,t) = \frac{y_{max}}{{1 + e^{(a-b(t) \cdot x)}}} }[/math]

[math]\displaystyle{ b(t)=C1 \cdot \sin (2 \cdot \pi \cdot \frac{t}{T} - C2 ) + b_0 }[/math]

mit:

a, b₀: Entscheidungsvariablen
C1, C2: Entscheidungsvariablen
ymax: maximaler Funktionswert
T: Periode der Funktion
t: Zeitschritt, t = 0...T
x: X-Wert (z.B. Speicherinhalt, Systemzustand)
y: Funktionswert (z.B. Abgabe, Faktor)

Die mit den angegebenen Parametern generierte Funktion wird bei der Simulation als *.fkt-Datei ausgegeben, diese besitzt das gleiche Dateiformat wie die eigentliche FKT-Datei des Datensatzes, so dass sie bei Bedarf einfach in die FKT-Datei eingefügt werden kann.

Hinweis: Die Funktionalität der OPF-Datei ist nicht in der Benutzeroberfläche verfügbar. OPF-Dateien werden beim Import von Datensätzen nicht mit importiert!

Beispiel

[SETTINGS]
Version=1.0
CountStepsOperationPeriod=365 ;number of steps = period/zschr, number of time steps for one period of operation (usually, a period is one year)
Nodes=20
MinChange%=10 ;percentage of change for creating a new function

[PARAMETER]
Start=1
*|-------------------------|------------|------------|------------|------------|------------|------------|------------|------------|------------|---|---------------------|
*| ELEM Key actve time type|  Param. A  |  Param. B  |  Param. C  | Zeitpar C1 | Zeitpar C2 |   X-MIN    |   X-MAX    |   Y-MIN    |   Y-MAX    | Y |        Name         |
*|-<-->-<->---+----+----+--|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-<-------->-|-+-|<------------------->|
 | TAAB|QR1 | J |  J |  5  |      32.79 |      65.25 |    0.00000 |      47.61 |      21.53 |        0.0 |        1.0 |        0.0 |        1.0 | J |Lamellenplan_Rohw    |
 | KGRP|040 | J |  J |  5  | 0.40781721 |  62.091835 |    0.00000 |  63.135715 | 35.2380258 |        0.0 |    30000.0 |        0.0 |       25.0 | N |Lamellenplan_RohwKB
*|-------------------------|------------|------------|------------|------------|------------|------------|------------|------------|------------|---|---------------------|

Erläuterungen

`[SETTINGS]`

Version: Version des Dateiformats
CountStepsOperationPeriod: Anzahl Zeitschritte für die Periodizität der Funktion. Üblicherweise ein Jahr (also 365 Tage).
Nodes: Gewünschte Anzahl Stützstellen der Funktion
MinChange%: Erlaubte prozentuale Abweichung von der mathematischen Funktion bevor eine neue zeitliche Stützstelle eingefügt wird.

`[PARAMETER]`

Start: Erste zu verwendende Datenzeile (?)
ELEM: Systemelement dessen Funktion definiert werden soll. Mögliche Angaben sind Talsperren-Elemente (T***) oder Kontrollgruppen (KGRP)
Key: Funktionsname. Bei Talsperren ist dies der Name der Abgabefunktion. Bei Kontrollgruppen die Nummer/Kennung der Kontrollgruppe aus der KTR-Datei.
actve: Aktiviert (J / N)
time: Zeitabhängigkeit der Funktion (J / N)
type: Funktionsart (siehe Erläuterung in FKT-Datei)
Param. A: Wert des Parameters a
Param. B: Wert des Parameters b0
Param. C: Wert des Parameters C
Zeitpar. C1: Wert des Parameters C1
Zeitpar. C2: Wert des Parameters C2
X-MIN: Mindestwert X für Skalierung der X-Achse (wird bei Talsperren intern immer auf 0 gesetzt)
X-MAX: Maximalwert X für Skalierung der X-Achse (wird bei Talsperren intern immer auf 1 (max. Speicherinhalt) gesetzt)
Y-MIN: Mindestwert Y für Skalierung der Y-Achse
Y-MAX: Maximalwert Y für Skalierung der Y-Achse
Y: Skalierung der Y-Funktionswerte (J / N). Besitzt bei Kontrollgruppen keine Wirkung.
Name: Freitext für Funktionsnamen

@@ Zeile 1: / Zeile 1: @@
-<languages/>
-<translate>
-<!--T:1-->
 {{ASCII-Datensatz}}
 __TOC__
 Mit der OPF-Datei können parametrisierte Funktionsverläufe definiert werden. Die so definierten Funktionen ersetzen bei der Simulation die jeweilige Funktion in der [[Special:MyLanguage/FKT-Datei|FKT-Datei]].
-<!--T:2-->
 Parametrisierte Funktionsverläufe eignen sich insbesonders für eine Optimierung von Funktionsverläufen, z.B. mit [[Special:MyLanguage/BlueM.Opt|BlueM.Opt]].
-<!--T:3-->
 [[Datei:Wachstumsfunktion Verhulst.png|gerahmt|rechts|Beispiele für mögliche Funktionsverläufe]]
 Der Funktionsverlauf ist durch folgende Gleichungen definiert (Wachstumsfunktion nach Verhulst):
-<!--T:4-->
 <math>y(x,t) = \frac{y_{max}}{{1 + e^{(a-b(t) \cdot x)}}}</math>
-<!--T:5-->
 <math>b(t)=C1 \cdot \sin (2 \cdot \pi \cdot \frac{t}{T} - C2 ) + b_0</math>
-<!--T:6-->
 mit:
 * <code>a</code>, <code>b<sub>0</sub></code>: Entscheidungsvariablen
@@ Zeile 30: / Zeile 22: @@
-<!--T:7-->
 Die mit den angegebenen Parametern generierte Funktion wird bei der Simulation als <code>*.fkt</code>-Datei ausgegeben, diese besitzt das gleiche Dateiformat wie die eigentliche [[Special:MyLanguage/FKT-Datei|FKT-Datei]] des Datensatzes, so dass sie bei Bedarf einfach in die FKT-Datei eingefügt werden kann.
-<!--T:8-->
 ;Hinweis: Die Funktionalität der OPF-Datei ist nicht in der Benutzeroberfläche verfügbar. OPF-Dateien werden beim Import von Datensätzen nicht mit importiert!
-==Beispiel== <!--T:9-->
+==Beispiel==
-<!--T:10-->
 <pre>
 [SETTINGS]
@@ Zeile 47: / Zeile 36: @@
 MinChange%=10 ;percentage of change for creating a new function
-<!--T:11-->
 [PARAMETER]
 Start=1
@@ Zeile 59: / Zeile 47: @@
-==Erläuterungen== <!--T:12-->
+==Erläuterungen==
-===<code>[SETTINGS]</code>=== <!--T:13-->
+===<code>[SETTINGS]</code>===
-<!--T:14-->
 * <code>Version</code>: Version des Dateiformats
 * <code>CountStepsOperationPeriod</code>: Anzahl Zeitschritte für die Periodizität der Funktion. Üblicherweise ein Jahr (also 365 Tage).
@@ Zeile 71: / Zeile 58: @@
-===<code>[PARAMETER]</code>=== <!--T:15-->
+===<code>[PARAMETER]</code>===
-<!--T:16-->
 * <code>Start</code>: Erste zu verwendende Datenzeile (?)
 * <code>ELEM</code>: Systemelement dessen Funktion definiert werden soll. Mögliche Angaben sind Talsperren-Elemente (<code>T***</code>) oder Kontrollgruppen (<code>KGRP</code>)
@@ Zeile 91: / Zeile 77: @@
 * <code>Y</code>: Skalierung der Y-Funktionswerte (<code>J</code> / <code>N</code>). Besitzt bei Kontrollgruppen keine Wirkung.
 * <code>Name</code>: Freitext für Funktionsnamen
-</translate>