BlueM.Opt input files

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 Dll=Pfad\zu\Anwendung.dll 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.
• Es muss mindestens die Exe oder die Dll gesetzt werden. Sind beide gesetzt, wird die Dll genutzt.

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

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 Zeitreihe müssen mit der .wel Datei des Simulationsergebnisses übereinstimmen! (siehe Bug 218)

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 ist optional!)

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_QH2  | Obergrenze | MinWert  |    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 218)

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.