OBF-file: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Neue Spalten für Evaluierungszeitraum (Bug 199))
(Neue Spalte Opt seit r962 (Sekundäre Zielfunktionen))
Line 9: Line 9:
*=================
*=================
*
*
*|---------------|---------|-------|----------|---------|--------------|--------------------|---------------------------|
*|-----|---------------|---------|-------|----------|---------|--------------|--------------------|---------------------------|
*| Bezeichnung  | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |      Zielwert  ODER      Zielreihe          |
*| Opt | Bezeichnung  | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |      Zielwert  ODER      Zielreihe          |
*|              |        |      |          |        | Start | Ende | WertTyp | ZielWert | ZielGröße | Datei        |
*|    |              |        |      |          |        | Start | Ende | WertTyp | ZielWert | ZielGröße | Datei        |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
  | QSpitze      | Wert    |  WEL  | S100_1ZU | Diff    |      |      | MaxWert |    50    |          |              |
|  J | QSpitze      | Wert    |  WEL  | S100_1ZU | Diff    |      |      | MaxWert |    50    |          |              |
  | SumFehlQ      | Reihe  |  WEL  | S100_1ZU | AbQuad  |      |      |        |          |          | Zeitreihe.zre |
|  J | SumFehlQ      | Reihe  |  WEL  | S100_1ZU | AbQuad  |      |      |        |          |          | Zeitreihe.zre |
  | Volumenfehler | Reihe  |  WEL  | S100_1ZU | Volf    |      |      |        |          | S100_ZU  | Zeitreihe.wel |
|  J | Volumenfehler | Reihe  |  WEL  | S100_1ZU | Volf    |      |      |        |          | S100_ZU  | Zeitreihe.wel |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
</pre>
</pre>


Line 22: Line 22:
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
|- bgcolor="#F1F1F1"
|- bgcolor="#F1F1F1"
| width="150" | '''Bezeichnung''' || width="500" | Bezeichnung des Optimierungsziels (beliebig)
| width="150" | '''Opt''' || width="500" | Angabe, ob es sich um ein ''Optimierungsziel'' handelt (<code>J</code>) oder nicht (<code>N</code>). Wenn nicht, handelt es sich um eine ''Sekundäre Zielfunktion'', die zwar immer ausgewertet wird, aber nicht für die Optimierung herangezogen wird.
|-
|-
| '''Bezeichnung''' || Bezeichnung des Ziels (beliebig)
|- bgcolor="#F1F1F1"
| '''ZielTyp'''
| '''ZielTyp'''
|  
|  
* <code>Wert</code>: Es handelt sich um einen einzelnen Zielwert
* <code>Wert</code>: Es handelt sich um einen einzelnen Zielwert
* <code>Reihe</code>: Es handelt sich um eine Zielreihe
* <code>Reihe</code>: Es handelt sich um eine Zielreihe
|-
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, BIL, <del>PRB</del> (Bug 220)]
|- bgcolor="#F1F1F1"
|- bgcolor="#F1F1F1"
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, BIL, <del>PRB</del> (Bug 220)]
|-
| '''SimGröße''' || Die Simulationsgröße, auf dessen Basis der Qualitätswert berechnet werden soll
| '''SimGröße''' || Die Simulationsgröße, auf dessen Basis der Qualitätswert berechnet werden soll
|- bgcolor="#F1F1F1"
|-
| '''ZielFkt''' || Gibt an welche Zielfunktion verwendet werden soll.
| '''ZielFkt''' || Gibt an welche Zielfunktion verwendet werden soll.
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
Line 42: Line 44:
* <code>Volf</code>: Volumenfehler (nur bei Zielreihen möglich; nimmt an, dass die Simulationsgröße eine Einheit pro Sekunde besitzt)
* <code>Volf</code>: Volumenfehler (nur bei Zielreihen möglich; nimmt an, dass die Simulationsgröße eine Einheit pro Sekunde besitzt)
* <code>IHA</code>: [[Zielfunktion IHA | Indicators of Hydrologic Alteration]]
* <code>IHA</code>: [[Zielfunktion IHA | Indicators of Hydrologic Alteration]]
|-
|- bgcolor="#F1F1F1"
| '''EvalZeitraum'''<br/>(optional) || Bestimmt den Zeitraum, für den die Zielfunktion ausgewertet werden soll.<br/>
| '''EvalZeitraum'''<br/>(optional) || Bestimmt den Zeitraum, für den die Zielfunktion ausgewertet werden soll.<br/>
Format: <code>dd.mm.yyyy hh:mm</code><br/>
Format: <code>dd.mm.yyyy hh:mm</code><br/>
Wenn nicht angegeben, wird der Simulationszeitraum verwendet.
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.
| '''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>MaxWert</code>: Maximaler Wert des Simulationsergebnisses
Line 53: Line 55:
* <code>AnfWert</code>: Der erste wert des Simulationsergebnisses
* <code>AnfWert</code>: Der erste wert des Simulationsergebnisses
* <code>EndWert</code>: Der letzte Wert des Simulationsergebnisses
* <code>EndWert</code>: Der letzte Wert des Simulationsergebnisses
|- bgcolor="#F1F1F1"
| '''Zielwert'''<br/>(nur bei Zielwerten) || Der zu vergleichende Zielwert
|-
|-
| '''Zielwert'''<br/>(nur bei Zielwerten) || Der zu vergleichende Zielwert
| '''ZielGröße'''<br/>(nur bei Zielreihen und .wel als Zieldatei) || Gibt an welche Spalte der .wel Zieldatei zum Vergleich herangezogen werden soll.
|- bgcolor="#F1F1F1"
|- 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>
| '''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>
|}
|}

Revision as of 10:07, 6 March 2008

Template:EVO Eingabedateien 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.

Beispiel für eine Autokalibrierung mit 3 Zielfunktionen:

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

Spaltenbeschreibung

Opt Angabe, ob es sich um ein Optimierungsziel handelt (J) oder nicht (N). Wenn nicht, handelt es sich um eine Sekundäre Zielfunktion, die zwar immer ausgewertet wird, aber nicht für die Optimierung herangezogen wird.
Bezeichnung Bezeichnung des Ziels (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; nimmt an, dass die Simulationsgröße eine Einheit pro Sekunde besitzt)
  • 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
(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.