OBF-file: Difference between revisions

From BlueM
Jump to navigation Jump to search
mNo edit summary
(ZIE-Datei ist jetzt EVO Eingabedatei)
Line 1: Line 1:
{{Eingabedateien}}
Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion.


<big>Zielfunktionen</big>
Die Datei muss den gleichen Namen wie der [[BlueM]]-Datensatz haben, aber mit der Endung '''.ZIE''', und muss sich im BlueM-Arbeitsverzeichnis befinden.


''siehe auch [[Bewertung des wasserwirtschaftlichen Betriebs|Theorie:Bewertung des wasserwirtschaftlichen Betriebs]]''
''Beispielhafte ZIE-Datei für eine Autokalibrierung mit 3 Zielfunktionen:''
<pre>
*Optimierungsziele
*=================
*
*|---------------|---------|-------|----------|---------|--------------|--------------------|---------------------------|
*| Bezeichnung  | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |      Zielwert  ODER      Zielreihe          |
*|              |        |      |          |        | Start | Ende | WertTyp | ZielWert | ZielGröße | Datei        |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
| QSpitze      | Wert    |  WEL  | S100_1ZU | Diff    |      |      | MaxWert |    50    |          |              |
| SumFehlQ      | Reihe  |  WEL  | S100_1ZU | AbQuad  |      |      |        |          |          | Zeitreihe.zre |
| Volumenfehler | Reihe  |  WEL  | S100_1ZU | Volf    |      |      |        |          | S100_ZU  | Zeitreihe.wel |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
</pre>


==Datei==
<span style="color:red">''Die 2 Spalten "EvalZeitraum" sind noch nicht implementiert! (Bug 199)''</span>
<bluem>
 
*Zielfunktionen (*.ZIE)
===Spaltenbeschreibung===
*======================
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
*
|- bgcolor="#F1F1F1"
*|--------|-----|------------------------------------------|------------------------------------------|
| width="150" | '''Bezeichnung''' || width="500" | Bezeichnung des Optimierungsziels (beliebig)
*| Bez.  | Fkt |          Minimal Abfluss                |              Maximal Abfluss            |
|-
*|     an| Kng |Ziel|Sollwert    Gangl.  Gew Exp  Norm. |Ziel|Sollwert    Gangl.  Gew Exp  Norm. |
| '''ZielTyp'''
*|     J/N|     |fkt.|         JGG WGG TGG  -   -  Abweich|fkt.|         JGG WGG TGG  -  -  Abweich|
|  
*|-<-->-+-|-<->-|<-->|<------>-<->-<->-<->-<->-<->-<------>|<-->|<------>-<->-<->-<->-<->-<->-<------>|
* <code>Wert</code>: Es handelt sich um einen einzelnen Zielwert
*|  A  B |  C  |  D |    E    F  G  H  I  J      K  |  L |    M    N  O  P  Q  R      S  |
* <code>Reihe</code>: Es handelt sich um eine Zielreihe
| E100 J | 1AB | 1 |      0              1  1      1  |  2 |      1              1  1      1  |Tsim
|- bgcolor="#F1F1F1"
*|-<-->-+-|-<->-|<-->|<------>-<->-<->-<->-<->-<->-<------>|<-->|<------>-<->-<->-<->-<->-<->-<------>|
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, BIL, <del>PRB</del> (Bug 220)]
</bluem>
|-
| '''SimGröße''' || Die Simulationsgröße, auf dessen Basis der Qualitätswert berechnet werden soll
|- bgcolor="#F1F1F1"
| '''ZielFkt''' || Gibt an welche Zielfunktion verwendet werden soll.
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
* <code>Diff</code>: Differenz
* <code>nÜber</code>: Relative Anzahl der Zeitschritte mit Überschreitung des Zielwerts/der Zielreihe (in Prozent)
* <code>sÜber</code>: Summe der Überschreitungen des Zielwerts/der Zielreihe
* <code>nUnter</code>: Relative Anzahl der Zeitschritte mit Unterschreitung des Zielwerts/der Zielreihe (in Prozent)
* <code>sUnter</code>: Summe der Unterschreitungen des Zielwerts/der Zielreihe
* <code>Volf</code>: Volumenfehler (nur bei Zielreihen möglich)
* <code>IHA</code>: [[Zielfunktion IHA | Indicators of Hydrologic Alteration]]
|-
| '''EvalZeitraum'''<br/>(optional)<br/><span style="color:red">''noch nicht implementiert! (Bug 199)''</span> || Bestimmt den Zeitraum, für den die Zielfunktion ausgewertet werden soll.<br/>
Format: <code>dd.mm.yyyy hh:mm</code><br/>
''Wenn nicht angegeben, wird der Simulationszeitraum verwendet.''
|- bgcolor="#F1F1F1"
| '''WertTyp'''<br/>(nur bei Zielwerten) || Gibt an wie der Wert, der mit dem Zielwert verglichen werden soll, aus dem Simulationsergebnis berechnet werden soll.
* <code>MaxWert</code>: Maximaler Wert des Simulationsergebnisses
* <code>MinWert</code>: Minimaler Wert des Simulationsergebnisses
* <code>Average</code>: Durchschnittlicher Wert des Simulationsergebnisses
* <code>AnfWert</code>: Der erste wert des Simulationsergebnisses
* <code>EndWert</code>: Der letzte Wert des Simulationsergebnisses
|-
| '''Zielwert'''<br/>(nur bei Zielwerten) || Der zu vergleichende Zielwert
|- bgcolor="#F1F1F1"
| '''ZielGröße'''<br/>(nur bei Zielreihen und .wel als Zieldatei) || Gibt an welche Spalte der .wel Zieldatei zum Vergleich herangezogen werden soll.
|-
| '''Datei'''<br/>(nur bei Zielreihen) || Der Dateiname der Zielreihe (.zre oder .wel)<br/><span style="color:red">'''Achtung:''' Die Zeitschrittweite der Zielreihe muss mit dem Zeitschritt der Simulation übereinstimmen! (siehe Bug 218)</span>
|}
Die Breite der Spalten darf bei Bedarf angepasst werden, nur alle "|"-Zeichen müssen erhalten bleiben!


==Erläuterung==
Ein "<code>*</code>" am Anfang einer Zeile führt dazu, dass die Zeile ignoriert wird.
'''Allgemein'''
*A: Bezeichnung
*B: ???
*C: Funktionskennung
'''Minimal Abfluss'''
*D: Zielfunktion
*E: Sollwert
*F: Jahresganglinie
*G: Wochenganglinie
*H: Tagesganglinie
*I: ???
*J: ???
*K: Norm. Abweichung
'''Maximal Abfluss'''
*L: Zielfunktion
*M: Sollwert
*N: Jahresganglinie
*O: Wochenganglinie
*P: Tagesganglinie
*Q: ???
*R: ???
*S: Norm. Abweichung


[[Category:BlauesModell]]
[[Kategorie:EVO]]
[[Category:BlauesModell Eingabedateien]]
[[Kategorie:EVO Eingabedateien]]

Revision as of 04:00, 3 September 2007

Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion.

Die Datei muss den gleichen Namen wie der BlueM-Datensatz haben, aber mit der Endung .ZIE, und muss sich im BlueM-Arbeitsverzeichnis befinden.

Beispielhafte ZIE-Datei für eine Autokalibrierung mit 3 Zielfunktionen: 

*Optimierungsziele
*=================
*
*|---------------|---------|-------|----------|---------|--------------|--------------------|---------------------------|
*| Bezeichnung   | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |       Zielwert   ODER      Zielreihe           |
*|               |         |       |          |         | Start | Ende | WertTyp | ZielWert | ZielGröße | Datei         |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
 | QSpitze       | Wert    |  WEL  | S100_1ZU | Diff    |       |      | MaxWert |    50    |           |               |
 | SumFehlQ      | Reihe   |  WEL  | S100_1ZU | AbQuad  |       |      |         |          |           | Zeitreihe.zre |
 | Volumenfehler | Reihe   |  WEL  | S100_1ZU | Volf    |       |      |         |          | S100_ZU   | Zeitreihe.wel |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|

Die 2 Spalten "EvalZeitraum" sind noch nicht implementiert! (Bug 199)

Spaltenbeschreibung

Bezeichnung Bezeichnung des Optimierungsziels (beliebig)
ZielTyp
  • Wert: Es handelt sich um einen einzelnen Zielwert
  • Reihe: Es handelt sich um eine Zielreihe
Datei Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, 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 Fehlerquadrate
  • Diff: Differenz
  • nÜber: Relative Anzahl der Zeitschritte mit Überschreitung des Zielwerts/der Zielreihe (in Prozent)
  • sÜber: Summe der Überschreitungen des Zielwerts/der Zielreihe
  • nUnter: Relative Anzahl der Zeitschritte mit Unterschreitung des Zielwerts/der Zielreihe (in Prozent)
  • sUnter: Summe der Unterschreitungen des Zielwerts/der Zielreihe
  • Volf: Volumenfehler (nur bei Zielreihen möglich)
  • IHA: Indicators of Hydrologic Alteration
EvalZeitraum
(optional)
noch nicht implementiert! (Bug 199)		 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
(nur bei Zielwerten)		 Gibt an wie der Wert, der mit dem Zielwert verglichen werden soll, aus dem Simulationsergebnis berechnet werden soll.
  • MaxWert: Maximaler Wert des Simulationsergebnisses
  • MinWert: Minimaler Wert des Simulationsergebnisses
  • Average: Durchschnittlicher Wert des Simulationsergebnisses
  • AnfWert: Der erste wert des Simulationsergebnisses
  • EndWert: Der letzte Wert des Simulationsergebnisses
Zielwert
(nur bei Zielwerten)		 Der zu vergleichende Zielwert
ZielGröße
(nur bei Zielreihen und .wel als Zieldatei)		 Gibt an welche Spalte der .wel Zieldatei zum Vergleich herangezogen werden soll.
Datei
(nur bei Zielreihen)		 Der Dateiname der Zielreihe (.zre oder .wel)
Achtung: Die Zeitschrittweite der Zielreihe muss mit dem Zeitschritt der Simulation übereinstimmen! (siehe Bug 218)

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.

Retrieved from "https://wiki.bluemodel.org/index.php?title=OBF-file&oldid=4505"