OBF-file: Difference between revisions

From BlueM
Jump to navigation Jump to search
mNo edit summary
(Namensgebung (r1002))
Line 9: Line 9:
*=================
*=================
*
*
*|-----|---------------|---------|-------|----------|---------|--------------|--------------------|---------------------------|
*|-----|---------------|---------|-------|----------|---------|--------------|-------------------|--------------------------|
*| Opt | Bezeichnung  | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |       Zielwert   ODER     Zielreihe          |
*| Opt | Bezeichnung  | ZielTyp | Datei | SimGröße | ZielFkt | EvalZeitraum |   Referenzwert   ODER   Referenzreihe        |
*|    |              |        |      |          |        | Start | Ende | WertTyp | ZielWert | ZielGröße | Datei        |
*|    |              |        |      |          |        | Start | Ende | WertTyp | RefWert | RefGröße | Datei        |
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|---------|----------|---------------|
  |  J  | QSpitze      | Wert    |  WEL  | S100_1ZU | Diff    |      |      | MaxWert |    50   |           |              |
  |  J  | QSpitze      | Wert    |  WEL  | S100_1ZU | Diff    |      |      | MaxWert |    50   |         |              |
  |  J  | SumFehlQ      | Reihe  |  WEL  | S100_1ZU | AbQuad  |      |      |        |          |          | Zeitreihe.zre |
  |  J  | SumFehlQ      | Reihe  |  WEL  | S100_1ZU | AbQuad  |      |      |        |        |          | Zeitreihe.zre |
  |  J  | Volumenfehler | Reihe  |  WEL  | S100_1ZU | Volf    |      |      |        |         | S100_ZU   | Zeitreihe.wel |
  |  J  | Volumenfehler | Reihe  |  WEL  | S100_1ZU | Volf    |      |      |        |         | S100_ZU | Zeitreihe.wel |
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|
*|-----|---------------|---------|-------|----------|---------|-------|------|---------|---------|----------|---------------|
</pre>
</pre>


Line 28: Line 28:
| '''ZielTyp'''
| '''ZielTyp'''
|  
|  
* <code>Wert</code>: Es handelt sich um einen einzelnen Zielwert
* <code>Wert</code>: Es soll mit einem einzelnen Referenzwert verglichen werden
* <code>Reihe</code>: Es handelt sich um eine Zielreihe
* <code>Reihe</code>: Es soll mit einer Referenzreihe verglichen werden
|-
|-
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, BIL, <del>PRB</del> (Bug 220)]
| '''Datei''' || Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL, BIL, <del>PRB</del> (Bug 220)]
Line 38: Line 38:
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
* <code>Diff</code>: Differenz
* <code>Diff</code>: Differenz
* <code>nÜber</code>: Relative Anzahl der Zeitschritte mit Überschreitung des Zielwerts/der Zielreihe (in Prozent)
* <code>nÜber</code>: Relative Anzahl der Zeitschritte mit Überschreitung des Referenzwerts/der Referenzreihe (in Prozent)
* <code>sÜber</code>: Summe der Überschreitungen des Zielwerts/der Zielreihe
* <code>sÜber</code>: Summe der Überschreitungen des Referenzwerts/der Referenzreihe
* <code>nUnter</code>: Relative Anzahl der Zeitschritte mit Unterschreitung des Zielwerts/der Zielreihe (in Prozent)
* <code>nUnter</code>: Relative Anzahl der Zeitschritte mit Unterschreitung des Referenzwerts/der Referenzreihe (in Prozent)
* <code>sUnter</code>: Summe der Unterschreitungen des Zielwerts/der Zielreihe
* <code>sUnter</code>: Summe der Unterschreitungen des Referenzwerts/der Referenzreihe
* <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 Referenzreihen 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"
|- bgcolor="#F1F1F1"
Line 49: Line 49:
Wenn nicht angegeben, wird der Simulationszeitraum verwendet.
Wenn nicht angegeben, wird der Simulationszeitraum verwendet.
|-
|-
| '''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 Referenzwerten) || 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 56: Line 56:
* <code>EndWert</code>: Der letzte Wert des Simulationsergebnisses
* <code>EndWert</code>: Der letzte Wert des Simulationsergebnisses
|- bgcolor="#F1F1F1"
|- bgcolor="#F1F1F1"
| '''Zielwert'''<br/>(nur bei Zielwerten) || Der zu vergleichende Zielwert
| '''RefWert'''<br/>(nur bei Referenzwerten) || Der zu vergleichende Referenzwert
|-
|-
| '''ZielGröße'''<br/>(nur bei Zielreihen und .wel als Zieldatei) || Gibt an welche Spalte der .wel Zieldatei zum Vergleich herangezogen werden soll.
| '''RefGröße'''<br/>(nur bei Referenzreihen und .wel als Referenzdatei) || Gibt an welche Spalte der .wel Referenzdatei zum Vergleich herangezogen werden soll.
|- bgcolor="#F1F1F1"
|- bgcolor="#F1F1F1"
| '''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 Referenzreihen) || 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>
|}
|}
Die Breite der Spalten darf bei Bedarf angepasst werden, nur alle "|"-Zeichen müssen erhalten bleiben!
Die Breite der Spalten darf bei Bedarf angepasst werden, nur alle "|"-Zeichen müssen erhalten bleiben!

Revision as of 01:35, 1 April 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 |   Referenzwert   ODER   Referenzreihe        |
*|     |               |         |       |          |         | Start | Ende | WertTyp | RefWert | RefGröß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 soll mit einem einzelnen Referenzwert verglichen werden
  • Reihe: Es soll mit einer Referenzreihe verglichen werden
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 Referenzwerts/der Referenzreihe (in Prozent)
  • sÜber: Summe der Überschreitungen des Referenzwerts/der Referenzreihe
  • nUnter: Relative Anzahl der Zeitschritte mit Unterschreitung des Referenzwerts/der Referenzreihe (in Prozent)
  • sUnter: Summe der Unterschreitungen des Referenzwerts/der Referenzreihe
  • Volf: Volumenfehler (nur bei Referenzreihen 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 Referenzwerten)
Gibt an wie der Wert, der mit dem Referenzwert 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
RefWert
(nur bei Referenzwerten)
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.
Datei
(nur bei Referenzreihen)
Der Dateiname der Referenzreihe (.zre oder .wel)
Achtung: Die Zeitschrittweite der Referenzreihe 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.