BlueM.Opt input files

From BlueM
Jump to navigation Jump to search

Datei EVO.ini

Eine Datei Evo.ini im Verzeichnis \_Main\bin\ kann dazu benutzt werden, Voreinstellungen vorzunehmen.

Für die Anwendungen mit BlueM oder SMUSI ist diese Datei erforderlich!

<ini> [EVO]

Allgemeine EVO-Einstellungen

[Sim]

Einstellungen für das Simulationsanwendungen (BlueM / Smusi)

Exe=Pfad\zu\Anwendung.exe Datensatz=Pfad\zum\Datensatz.ALL </ini>

Für INI-Syntax siehe Wikipedia/Ini-Datei.

Der Datensatz lässt sich auch während der Laufzeit über das GUI verändern, aber es muss dennoch ein Standard-Datensatz in der EVO.ini angegeben werden.

Datei OptimierungsParameter (*.OPT)

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

Diese Datei definiert die zu optimierenden Parameter. Jede Zeile entspricht einem Parameter. Aus jedem Optimierungsparameter lassen sich mehrere Modellparameter berechnen (siehe unten).

*Optimierungsparameter
*=====================
*
*|--------------|-------|-----------|--------|--------|
*| Bezeichnung  | Einh. | Anfangsw. |  Min   |  Max   |
*|-<---------->-|-<--->-|-<------->-|-<---->-|-<---->-|
 | PSI          |   -   |    0.5    |   0.1  |   0.9  |
 | RetKonst     |   -   |    0.5    |   0.1  |     1  |
*|--------------|-------|-----------|--------|--------|

Spaltenbeschreibung

Bezeichnung Bezeichnung des Parameters (beliebig)
Diese Bezeichnung muss sich in der Datei "ModellParameter" wiederfinden, damit eine Zuordnung gemacht werden kann)
Einh. Einheit des Parameterwertes
Anfangsw. Anfangswert für den Parameter
Min & Max Untere und obere Grenze für den Parameterwert

Die Breite der Spalten der *.OPT-Datei 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.

Datei ModellParameter (*.MOD)

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

Diese Datei definiert die zu optimierenden ModellParameter des Blauen Modells. Jede Zeile entspricht einem ModellParameter. Die ModellParameter sind durch die Spalte "OptParameter" den Optimierungsparametern zugeordnet.

*ModellParameter
*=====================
*
*|--------------|--------------|-------|-------|--------|-------|-----|-----|--------|
*| OptParameter | Bezeichnung  | Einh. | Datei |Elem. /o| Zeile | von | bis | Faktor |
*|-<---------->-|-<---------->-|-<--->-|-<--->-|-<---->-|-<--->-|-<->-|-<->-|-<---->-|
 | PSI          | A01_psi      |   -   |  EZG  |  S201  |   10  | 110 | 115 |   1    |
 | PSI          | A02_psi      |   -   |  EZG  |  S201  |   11  | 110 | 115 |   1    |
 | RetKonst     | A01_K1       |   -   |  EZG  |  S201  |   10  | 143 | 149 |   10   |
 | RetKonst     | A02_K1       |   -   |  EZG  |  S201  |   11  | 143 | 149 |   10   |
*|--------------|--------------|-------|-------|--------|-------|-----|-----|--------|

Spaltenbeschreibung

OptParameter Bezeichnung des Optimierungsparameters aus welchem dieser Modellparameter berechnet wird
Bezeichnung Bezeichnung des Parameters (beliebig)
Einh. Einheit des Parameterwertes
Datei Endung der Eingabedatei des BlauenModells, in der sich der Parameter befindet [EZG, TRS, TAL, BOF, BOA, BOD, etc]
Elem. /o optional: Bezeichnung des Elements für das dieser Modellparameter zuständig ist
Zeile Zeile, in der sich der Parameter befindet (gezählt vom Dateianfang der Eingabedatei)
von & bis Spaltennummern, innerhalb derer der Parameter in der Eingabedatei definiert ist
(siehe Bug 120)
Faktor ModellParameter = OptimierungsParameter × Faktor

Die Breite der Spalten der *.MOD-Datei 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.

Datei Optimierungsziele (*.ZIE)

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

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

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 |
*|---------------|---------|-------|----------|---------|-------|------|---------|----------|-----------|---------------|

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 138)]
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)
  • nUnter: Relative Anzahl der Zeitschritte mit Unterschreitung des Zielwerts/der Zielreihe (in Prozent)
  • Volf: Volumenfehler (nur bei Zielreihen möglich)
  • 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 Zeitreihe müssen mit der .wel Datei des Simulationsergebnisses übereinstimmen! (siehe Bug 105)

Die Breite der Spalten der *.ZIE-Datei 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.

Datei Optimierungsgrenzen (*.CON)

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

Diese Datei definiert die Constraints (Grenzen) für die Optimierung. Jede Zeile entspricht einem Constraint.

Für die Berechnung eines Constraints wird die Differenz zwischen der Simulationsgröße und dem Grenzwert gebildet.

Beispielhafte CON-Datei für eine Talsperre mit 2 Constraints:

*Constraints
*===========
*
*|---------------|----------|-------|-----------|------------|----------------------|-----------------------------|
*|               |          |       |           |            |      Grenzwert       |        Grenzreihe           |
*| Bezeichnung   | GrenzTyp | Datei | SimGröße  | Oben/Unten | WertTyp  | Grenzwert | Grenzgröße | Datei          |
*|---------------|----------|-------|-----------|------------|----------|-----------|------------|----------------|
 | Überlauf      | Wert     |  WEL  | TOLF_VOL  | Obergrenze | Min      |    0      |            |                |
 | HWSRaum       | Reihe    |  WEL  | TOLF_VOL  | Obergrenze |          |           | HWSR       | HWSR.wel       |
*|---------------|----------|-------|-----------|----------- |----------|-----------|------------|----------------|

Spaltenbeschreibung

Bezeichnung Bezeichnung des Constraints (beliebig)
GrenzTyp
  • Wert: Es handelt sich um einen Grenzwert
  • Reihe: Es handelt sich um eine Grenzwertreihe
Datei Die Ergebnisdatei, aus der das Simulationsergebnis ausgelesen werden soll [WEL]
SimGröße Die Simulationsgröße, die auf Verletzung der Grenze überprüft werden soll
Oben/Unten Gibt an, ob die Grenze eine Ober- oder Untergrenze darstellt.
  • Obergrenze
  • Untergrenze
WertTyp
(nur bei Grenzwerten)
Gibt an wie der Wert, der mit dem Grenzwert 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
Grenzwert
(nur bei Grenzwerten)
Der zu überprüfende Grenzwert
Grenzgröße
(nur bei Grenzwertreihen und .wel als Grenzwertdatei)
Gibt an welche Spalte der .wel Grenzwertdatei für die Grenze herangezogen werden soll.
Datei
(nur bei Grenzwertreihen)
Der Dateiname der Grenzwertdatei (.zre oder .wel)
Achtung: Die Zeitschrittweite der Zeitreihe müssen mit der .wel Datei des Simulationsergebnisses übereinstimmen! (siehe Bug 105)

Die Breite der Spalten der *.ZIE-Datei 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.