OBF-file: Difference between revisions
Jump to navigation
Jump to search
m (Umbenennung EVO.NET -> BlueM.Opt) |
(Neues ZIE-Format (v1.4)) |
||
Line 2: | Line 2: | ||
<div class="info_versionen"> | <div class="info_versionen"> | ||
'''Versionen:''' | '''Versionen:''' | ||
* '''aktuell''' v1.3 (ab r1436) | * '''aktuell''' v1.4 (ab ) | ||
* [{{SERVER}}/ | * [{{SERVER}}/bluem/wiki/index.php?title=ZIE-Datei&oldid=6096 v1.3] (ab r1436) | ||
* [{{SERVER}}/bluem/wiki/index.php?title=ZIE-Datei&oldid=5843 v1.2.x] | |||
</div> | </div> | ||
Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion. | Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion. | ||
Line 9: | Line 10: | ||
Die Datei muss den gleichen Namen wie der Simulations-Datensatz haben, aber mit der Endung '''.ZIE''', und muss sich im Simulations-Arbeitsverzeichnis befinden. | Die Datei muss den gleichen Namen wie der Simulations-Datensatz haben, aber mit der Endung '''.ZIE''', und muss sich im Simulations-Arbeitsverzeichnis befinden. | ||
'' | The file is divided into several blocks, each of which is optional. Each block is identified by its heading: | ||
< | * '''Reihenvergleich''': This block defines objective functions that are based on a comparison of simulation time series with a reference time series. | ||
* '''Wertevergleich''': This block defines objective functions that are based on a comparison of simulation result values with a reference value. | |||
* '''Reihenwertevergleich''': This block defines objective functions that are based on a comparison of values that are computed from simulation time series with reference values. | |||
* '''IHA-Analyse''': Indicators of Hydrologic Alteration | |||
* '''SKos''': Damages and Costs | |||
* '''Aggregierte Ziele''': Aggregate objective functions | |||
<bluem> | |||
*Optimierungsziele | *Optimierungsziele | ||
*================= | *================= | ||
* | * | ||
*|-----|---------------|--------|---|---|---------|-------|----------|----------|--------------|-------------------|--------------------------|---------| | *Reihenvergleich | ||
*| Opt | Bezeichnung | Gruppe | R | | *--------------- | ||
*| | | | * | ||
*|-----|---------------|--------|---|---|---------|-------|----------|----------|-------|------|---------|---------|----------|---------------|---------| | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------------------------------------|---------| | ||
| P | | *| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | EvalZeitraum | Referenzreihe | IstWert | | ||
| P | | *| | | | | | | | | Start | Ende | RefGröße | Datei | | | ||
| | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------|-----------------------------|---------| | ||
*|-----|---------------|--------|---|---|---------|-------|----------|----------|-------|------|---------|---------|----------|---------------|---------| | | P | NashSutcliffe | | - | | WEL | B401 | NashSutt| | | | Zeitreihe.zre | | | ||
*|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------|-----------------------------|---------| | |||
* | |||
*Wertevergleich | |||
*-------------- | |||
* | * | ||
* | *|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| | ||
*| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | Zielgröße | OptGröße | | IstWert | | |||
*| | | | | | | | | (Block) | (Spalte) | RefWert | | | |||
*|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| | |||
| P | OutfallLoad | | - | | RPT | | Diff | OutfallNode | AvgFlow | 0 | | | |||
| S | Speicher | Becken | - | + | BLZ | B401 | | Speicher | maxVolume | | | | |||
| S | Speicher | Becken | - | + | BLZ | B701 | | Speicher | maxVolume | | | | |||
*|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| | |||
* | |||
*Reihenwertevergleich | |||
*-------------------- | |||
* | |||
*|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|-------------------|---------| | |||
*| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | EvalZeitraum | Referenzwert | IstWert | | |||
*| | | | | | | | | Start | Ende | WertTyp | RefWert | | | |||
*|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|---------|---------|---------| | |||
| P | OutfallLoad | | - | | WEL | B401_2AB | Diff | | | | | | | |||
*|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|---------|---------|---------| | |||
* | |||
*IHA-Analyse | |||
*----------- | |||
* | |||
*|-----|---------------|---------|---|-------|-------|------------|-----------|-------------------------------|----------| | |||
*| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | Referenzreihe | IstWert | | |||
*| | | | | | | | | RefGröße | Datei | | | |||
*|-----|---------------|---------|---|-------|-------|------------|-----------|----------|--------------------|----------| | |||
| P | IHAGesamt | | | | WEL | S09 _1ZU | | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
| S | IHAQuantity | | | | WEL | S09 _1ZU | Quantity | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
| S | IHAExtremes | | | | WEL | S09 _1ZU | Extremes | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
| S | IHATiming | | | | WEL | S09 _1ZU | Timing | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
| S | IHAFrequency | | | | WEL | S09 _1ZU | Frequency | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
| S | IHARate | | | | WEL | S09 _1ZU | Rate | TOLF_1ZU | ZRE\Olef_orig.wel | | | |||
*|-----|---------------|---------|---|-------|-------|------------|-----------|----------|--------------------|----------| | |||
* | |||
*SKos | |||
*---- | |||
* | |||
*|-----|---------------|---------|---|-------| | |||
*| Opt | Bezeichnung | Gruppe | R | OpFak | | |||
*| | | | | | | |||
*|-----|---------------|---------|---|-------| | |||
| P | Baukosten | | | | | |||
*|-----|---------------|---------|---|-------| | |||
* | |||
*Aggregierte Ziele | |||
*----------------- | |||
* | * | ||
*|-----|---------------| | *|-----|---------------|---------|---| | ||
*| Opt | Bezeichnung | | *| Opt | Bezeichnung | Gruppe | R | | ||
*| | *|-----|---------------|---------|---| | ||
| P | Beckengesamt | Becken | | | |||
| P | | *|-----|---------------|---------|---| | ||
</bluem> | |||
| | |||
*|-----|---------------|------ | |||
</ | |||
===Spaltenbeschreibung=== | ===Spaltenbeschreibung=== | ||
Line 46: | Line 94: | ||
! width="150" | Parameter !! width="500" | Beschreibung | ! width="150" | Parameter !! width="500" | Beschreibung | ||
|- | |- | ||
| '''Opt''' || Angabe, ob es sich um ein ''Primärziel'' handelt (<code>P</code>) oder nicht (<code>N</code>). Wenn nicht, handelt es sich um ein '' | | '''Opt''' || Angabe, ob es sich um ein ''Primärziel'' handelt (<code>P</code>) oder nicht (<code>N</code>). Wenn nicht, handelt es sich um ein ''Sekundärziel'', die zwar immer ausgewertet wird, aber nicht für die Optimierung herangezogen wird. | ||
|- | |- | ||
| '''Bezeichnung''' || Bezeichnung des Ziels (beliebig) | | '''Bezeichnung''' || Bezeichnung des Ziels (beliebig) | ||
|- | |- | ||
| '''Gruppe''' || | | '''Gruppe''' || Group name for aggregated objective functions | ||
|- | |- | ||
| '''R'''ichtung | | '''R'''ichtung | ||
Line 62: | Line 110: | ||
*<code>-</code>: Der Zielwert wird von der Gruppe subtrahiert | *<code>-</code>: Der Zielwert wird von der Gruppe subtrahiert | ||
*<code>2; 0.5; -10</code>: Ein Faktor, mit dem der Zielwert multipliziert und dann zur Gruppe addiert wird. | *<code>2; 0.5; -10</code>: Ein Faktor, mit dem der Zielwert multipliziert und dann zur Gruppe addiert wird. | ||
|- | |- | ||
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, KWL, ASC, <del>BIL, PRB</del> (Bug 220)] | | '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, KWL, ASC, <del>BIL, PRB</del> (Bug 220)] | ||
Line 91: | Line 134: | ||
Wenn nicht angegeben, wird der Simulationszeitraum verwendet. | Wenn nicht angegeben, wird der Simulationszeitraum verwendet. | ||
|- | |- | ||
| '''WertTyp''' | | '''WertTyp''' || Gibt an wie der Wert, der mit dem Referenzwert verglichen werden soll, aus dem Simulationsergebnis berechnet werden soll. | ||
* <code>MaxWert</code>: Maximaler Wert des Simulationsergebnisses | * <code>MaxWert</code>: Maximaler Wert des Simulationsergebnisses | ||
* <code>MinWert</code>: Minimaler Wert des Simulationsergebnisses | * <code>MinWert</code>: Minimaler Wert des Simulationsergebnisses | ||
Line 99: | Line 142: | ||
* <code>Summe</code>: Summe des Simulationsergebnisses | * <code>Summe</code>: Summe des Simulationsergebnisses | ||
|- | |- | ||
| '''RefWert''' | | '''RefWert''' || Der zu vergleichende Referenzwert | ||
|- | |- | ||
| '''RefGröße'''<br/>(nur bei Referenzreihen und . | | '''RefGröße'''<br/>(nur bei Referenzreihen und .WEL als Referenzdatei) || Gibt an welche Spalte der .WEL Referenzdatei zum Vergleich herangezogen werden soll. | ||
|- | |- | ||
| ''' | | '''RefDatei''' || Der Dateiname der Referenzreihe ([[ZRE-Format|.zre]] oder [[WEL-Format|.wel]])<br/><span style="color:red">'''Achtung:''' Die Zeitschrittweite der Referenzreihe muss mit dem Zeitschritt der Simulation übereinstimmen! (siehe Bug 218)</span> | ||
|- | |- | ||
| '''IstWert'''<br/>(optional) || Ein Wert, der in den Diagrammen als Vergleichswert angezeigt wird. | | '''IstWert'''<br/>(optional) || Ein Wert, der in den Diagrammen als Vergleichswert angezeigt wird. |
Revision as of 01:06, 6 May 2009
BlueM.Opt | Download | Usage | Development
BlueM.Opt input files: MOD · OPT · OBF · CON
Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion.
Die Datei muss den gleichen Namen wie der Simulations-Datensatz haben, aber mit der Endung .ZIE, und muss sich im Simulations-Arbeitsverzeichnis befinden.
The file is divided into several blocks, each of which is optional. Each block is identified by its heading:
- Reihenvergleich: This block defines objective functions that are based on a comparison of simulation time series with a reference time series.
- Wertevergleich: This block defines objective functions that are based on a comparison of simulation result values with a reference value.
- Reihenwertevergleich: This block defines objective functions that are based on a comparison of values that are computed from simulation time series with reference values.
- IHA-Analyse: Indicators of Hydrologic Alteration
- SKos: Damages and Costs
- Aggregierte Ziele: Aggregate objective functions
*Optimierungsziele *================= * *Reihenvergleich *--------------- * *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------------------------------------|---------| *| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | EvalZeitraum | Referenzreihe | IstWert | *| | | | | | | | | Start | Ende | RefGröße | Datei | | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------|-----------------------------|---------| | P | NashSutcliffe | | - | | WEL | B401 | NashSutt| | | | Zeitreihe.zre | | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|----------|-----------------------------|---------| * *Wertevergleich *-------------- * *|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| *| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | Zielgröße | OptGröße | | IstWert | *| | | | | | | | | (Block) | (Spalte) | RefWert | | *|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| | P | OutfallLoad | | - | | RPT | | Diff | OutfallNode | AvgFlow | 0 | | | S | Speicher | Becken | - | + | BLZ | B401 | | Speicher | maxVolume | | | | S | Speicher | Becken | - | + | BLZ | B701 | | Speicher | maxVolume | | | *|-----|---------------|---------|---|-------|-------|------------|---------|------------------|----------------|---------|---------| * *Reihenwertevergleich *-------------------- * *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|-------------------|---------| *| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | EvalZeitraum | Referenzwert | IstWert | *| | | | | | | | | Start | Ende | WertTyp | RefWert | | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|---------|---------|---------| | P | OutfallLoad | | - | | WEL | B401_2AB | Diff | | | | | | *|-----|---------------|---------|---|-------|-------|------------|---------|-------|------|---------|---------|---------| * *IHA-Analyse *----------- * *|-----|---------------|---------|---|-------|-------|------------|-----------|-------------------------------|----------| *| Opt | Bezeichnung | Gruppe | R | OpFak | Datei | SimGröße | ZielFkt | Referenzreihe | IstWert | *| | | | | | | | | RefGröße | Datei | | *|-----|---------------|---------|---|-------|-------|------------|-----------|----------|--------------------|----------| | P | IHAGesamt | | | | WEL | S09 _1ZU | | TOLF_1ZU | ZRE\Olef_orig.wel | | | S | IHAQuantity | | | | WEL | S09 _1ZU | Quantity | TOLF_1ZU | ZRE\Olef_orig.wel | | | S | IHAExtremes | | | | WEL | S09 _1ZU | Extremes | TOLF_1ZU | ZRE\Olef_orig.wel | | | S | IHATiming | | | | WEL | S09 _1ZU | Timing | TOLF_1ZU | ZRE\Olef_orig.wel | | | S | IHAFrequency | | | | WEL | S09 _1ZU | Frequency | TOLF_1ZU | ZRE\Olef_orig.wel | | | S | IHARate | | | | WEL | S09 _1ZU | Rate | TOLF_1ZU | ZRE\Olef_orig.wel | | *|-----|---------------|---------|---|-------|-------|------------|-----------|----------|--------------------|----------| * *SKos *---- * *|-----|---------------|---------|---|-------| *| Opt | Bezeichnung | Gruppe | R | OpFak | *| | | | | | *|-----|---------------|---------|---|-------| | P | Baukosten | | | | *|-----|---------------|---------|---|-------| * *Aggregierte Ziele *----------------- * *|-----|---------------|---------|---| *| Opt | Bezeichnung | Gruppe | R | *|-----|---------------|---------|---| | P | Beckengesamt | Becken | | *|-----|---------------|---------|---|
Spaltenbeschreibung
Parameter Beschreibung Opt Angabe, ob es sich um ein Primärziel handelt ( P
) oder nicht (N
). Wenn nicht, handelt es sich um ein Sekundärziel, die zwar immer ausgewertet wird, aber nicht für die Optimierung herangezogen wird.Bezeichnung Bezeichnung des Ziels (beliebig) Gruppe Group name for aggregated objective functions Richtung -
: Die Zielfunktion soll minimiert werden (Standard)+
: Die Zielfunktion soll maximiert werden (hierzu wird der evaluierte Zielwert mit -1 multipliziert, siehe Bug 303)
Operator oder Faktor +
: Der Zielwert wird zur Gruppe addiert-
: Der Zielwert wird von der Gruppe subtrahiert2; 0.5; -10
: Ein Faktor, mit dem der Zielwert multipliziert und dann zur Gruppe addiert wird.
Datei Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, KWL, ASC, BIL, PRB(Bug 220)]SimGröße Die Simulationsgröße, auf dessen Basis der Qualitätswert berechnet werden soll ZielFkt Gibt an welche Zielfunktion verwendet werden soll. AbQuad
: Abweichung der FehlerquadrateNashSutt
: Nash-Sutcliffe Koeffizient[1]
- abgeänderte Formel mit
0 < E < ∞
: - [math]\displaystyle{ E=\frac{\sum_{t=1}^T\left(Q_{gem}^t-Q_{sim}^t\right)^2}{\sum_{t=1}^T\left(Q_{gem}^t-\overline{Q_{gem}}\right)^2} }[/math]
Diff
: DifferenznÜber
: Relative Anzahl der Zeitschritte mit Überschreitung des Referenzwerts/der Referenzreihe [%]sÜber
: Summe der Überschreitungen des Referenzwerts/der ReferenzreihenUnter
: Relative Anzahl der Zeitschritte mit Unterschreitung des Referenzwerts/der Referenzreihe [%]sUnter
: Summe der Unterschreitungen des Referenzwerts/der ReferenzreiheKorr
: Bestimmtheitsmaß (einfache lineare Regression)0 ≤ R² ≤ 1
:
- [math]\displaystyle{ R^2 = \frac{s^2_{xy}}{s^2_x \cdot s^2_y} }[/math]
Volf
: Volumenfehler [%]IHA
: Indicators of Hydrologic Alteration
EvalZeitraum
(optional)Bestimmt den Zeitraum, für den die Zielfunktion ausgewertet werden soll.
Format:
dd.mm.yyyy hh:mm
Wenn nicht angegeben, wird der Simulationszeitraum verwendet.WertTyp Gibt an wie der Wert, der mit dem Referenzwert verglichen werden soll, aus dem Simulationsergebnis berechnet werden soll. MaxWert
: Maximaler Wert des SimulationsergebnissesMinWert
: Minimaler Wert des SimulationsergebnissesAverage
: Durchschnittlicher Wert des SimulationsergebnissesAnfWert
: Der erste wert des SimulationsergebnissesEndWert
: Der letzte Wert des SimulationsergebnissesSumme
: Summe des Simulationsergebnisses
RefWert Der zu vergleichende Referenzwert RefGröße
(nur bei Referenzreihen und .WEL als Referenzdatei)Gibt an welche Spalte der .WEL Referenzdatei zum Vergleich herangezogen werden soll. RefDatei Der Dateiname der Referenzreihe (.zre oder .wel)
Achtung: Die Zeitschrittweite der Referenzreihe muss mit dem Zeitschritt der Simulation übereinstimmen! (siehe Bug 218)IstWert
(optional)Ein Wert, der in den Diagrammen als Vergleichswert angezeigt wird.
Die Breite der Spalten darf bei Bedarf angepasst werden, nur alle "|"-Zeichen müssen erhalten bleiben!
Ein "*
" am Anfang einer Zeile führt dazu, dass die Zeile ignoriert wird.
Literaturangaben
- ↑ Nash, J. E. and Sutcliffe, J. V. (1970): River flow forecasting through conceptual models part I — A discussion of principles, Journal of Hydrology, 10 (3), 282–290, DOI:10.1016/0022-1694(70)90255-6.