BlueM.Opt input files: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Formatänderungen gemäß Rev 109)
 
 
(52 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div style="float:right; margin-left:10px;">__TOC__</div>
{{BlueM.Opt_nav}}
==List of input files for BlueM.Opt==


==Datei EVO.ini==
When performing a simulation-based optimization or sensitivity analysis (e.g. with [[BlueM.Sim]], [[TALSIM|Talsim-NG]] or [[SWMM]]), the simulation dataset has to contain the following additional input files required by BlueM.Opt:
Eine Datei '''<code>Evo.ini</code>''' im Verzeichnis <code>\EVO_Anwendung\bin\</code> kann dazu benutzt werden, Voreinstellungen vorzunehmen.
* '''[[MOD-file]]''': defines the model parameters
<ini>
* '''[[OPT-file]]''': defines the optimization parameters
[EVO]
* '''[[OBF-file]]''': defines the objective functions
;Allgemeine EVO-Einstellungen
* '''[[CON-file]]''' (optional): defines the constraints
[BlauesModell]
;Einstellungen für das Blaue Modell
BM_Exe=Pfad\zu\BlauesModell.exe
Datensatz=Pfad\zum\Datensatz.ALL
OptParameter=Pfad\zu\den\OptimierungsParametern.opt
ModellParameter=Pfad\zu\den\ModellParametern.opt
OptZiele=Pfad\zu\den\OptZielWerten.zie
</ini>
Für INI-Syntax siehe [http://de.wikipedia.org/wiki/Initialisierungsdatei Wikipedia/Ini-Datei].


==Datei OptimierungsParameter (*.OPT)==
[[Category:BlueM.Opt input files|*]]
Eine Datei welche im Dialog ausgewählt werden kann bzw. deren default Pfad in der <code>Evo.ini</code> unter "<code>OptParameter</code>" stehen kann. (Dateiname beliebig, aber Endung muss .OPT sein).
 
Diese Datei definiert die zu optimierenden Parameter. Jede Zeile entspricht einem Parameter. Aus jedem Optimierungsparameter lassen sich mehrere Modellparameter berechnen (siehe unten).
<pre>
*Optimierungsparameter
*=====================
*
*|--------------|-------|-----------|--------|--------|
*| Bezeichnung  | Einh. | Anfangsw. |  Min  |  Max  |
*|-<---------->-|-<--->-|-<------->-|-<---->-|-<---->-|
| PSI          |  -  |    0.5    |  0.1  |  0.9  |
| RetKonst    |  -  |    0.5    |  0.1  |    1  |
*|--------------|-------|-----------|--------|--------|
</pre>
 
===Spaltenbeschreibung===
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
|- bgcolor="#F1F1F1"
| width="100" | '''Bezeichnung''' || width="400" | Bezeichnung des Parameters (beliebig)<br/>''Diese Bezeichnung muss sich in der Datei "ModellParameter" wiederfinden, damit eine Zuordnung gemacht werden kann)''
|-
| '''Einh.''' || Einheit des Parameterwertes
|- bgcolor="#F1F1F1"
| '''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 (*.OPT)==
Eine Datei welche im Dialog ausgewählt werden kann bzw. deren default Pfad in der <code>Evo.ini</code> unter "<code>ModellParameter</code>" stehen kann. (Dateiname beliebig, aber Endung muss .OPT sein).
 
Diese Datei definiert die zu optimierenden ModellParameter des Blauen Modells. Jede Zeile entspricht einem ModellParameter. Die ModellParameter sind durch den Gruppennamen den Optimierungsparametern zugeordnet.
<pre>
*ModellParameter
*=====================
*
*|--------------|--------------|-------|-------|-------|-----|-----|--------|
*| OptParameter | Bezeichnung  | Einh. | Datei | Zeile | von | bis | Faktor |
*|-<---------->-|-<---------->-|-<--->-|-<--->-|-<--->-|-<->-|-<->-|-<---->-|
| PSI          | A01_psi      |  -  |  EZG  |  10  | 110 | 115 |  1    |
| PSI          | A02_psi      |  -  |  EZG  |  11  | 110 | 115 |  1    |
| RetKonst    | A01_K1      |  -  |  EZG  |  10  | 143 | 149 |  10  |
| RetKonst    | A02_K1      |  -  |  EZG  |  11  | 143 | 149 |  10  |
*|--------------|--------------|-------|-------|-------|-----|-----|--------|
</pre>
 
===Spaltenbeschreibung===
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
|- bgcolor="#F1F1F1"
| width="100" | '''OptParameter''' || width="400" | Bezeichnung des Optimierungsparameters aus welchem dieser Modellparameter berechnet wird
|-
| '''Bezeichnung''' || Bezeichnung des Parameters (beliebig)
|- bgcolor="#F1F1F1"
| '''Einh.''' || Einheit des Parameterwertes
|-
| '''Datei''' || Endung der [[BlauesModell Eingabedateien | Eingabedatei des BlauenModells]], in der sich der Parameter befindet [EZG, TRS, TAL, BOF, BOA, BOD, etc]
|- bgcolor="#F1F1F1"
| '''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
|- bgcolor="#F1F1F1"
| '''Faktor''' || ModellParameter = OptimierungsParameter &times; Faktor
|}
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 Optimierungsziele (*.ZIE)==
Eine Datei welche im Dialog ausgewählt werden kann bzw. deren default Pfad in der <code>Evo.ini</code> unter "<code>OptZiele</code>" stehen kann. (Dateiname beliebig, aber Endung muss .ZIE sein)
 
Diese Datei definiert die Ziele für die Optimierung. Jede Zeile entspricht einer Zielfunktion.
 
''Beispielhafte ZIE-Datei für eine Autokalibrierung mit 3 Zielfunktionen:''
<pre>
*Optimierungsziele
*=================
*
*|---------------|----------|-----------|----------|---------------------|---------------------------------------|
*|              |          |          |          |      Zielwert      |      Zielreihe                      |
*| Bezeichnung  | ZielTyp  | SpalteWel | ZielFkt  | WertTyp  | ZielWert | SpalteWel | Pfad                      |
*|---------------|----------|-----------|----------|----------|----------|-----------|---------------------------|
| QSpitze      | Wert    | S100_1ZU  | Diff    | MaxWert  |    50    |          |                          |
| SumFehlQ      | Reihe    | S100_1ZU  | AbQuad  |          |          |          | Pfad\zur\Zeitreihe.zre    |
| Volumenfehler | Reihe    | S100_1ZU  | Volf    |          |          | S100_ZU  | Pfad\zur\Zeitreihe.wel    |
*|---------------|----------|-----------|----------|----------|----------|-----------|---------------------------|
</pre>
 
===Spaltenbeschreibung===
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
|- bgcolor="#F1F1F1"
| width="150" | '''Bezeichnung''' || width="500" | Bezeichnung des Optimierungsziels (beliebig)
|-
| '''ZielTyp'''
|
* <code>Wert</code>: Es handelt sich um einen einzelnen Zielwert
* <code>Reihe</code>: Es handelt sich um eine Zielreihe
|- bgcolor="#F1F1F1"
| '''SpalteWel''' || Die Spalte in der .wel Ergebnisdatei der Simulation mit der der Zielwert oder die Zielreihe verglichen werden soll
|-
| '''ZielFkt''' || Gibt an welche Zielfunktion verwendet werden soll.
* <code>AbQuad</code>: Abweichung der Fehlerquadrate
* <code>Diff</code>: Differenz
* <code>Volf</code>: Volumenfehler (nur bei Zielreihen möglich)
|- 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"
| '''SpalteWel'''<br/>(nur bei Zielreihen und .wel als Zieldatei) || Gibt an welche Spalte der .wel Zieldatei zum Vergleich herangezogen werden soll.
|-
| '''Pfad'''<br/>(nur bei Zielreihen) || Der Pfad zur Zieldatei (.zre oder .wel)<br/><span style="color:red">'''Achtung:''' Der erste Zeitschritt und die Zeitschrittweite der Zeitreihe müssen mit der .wel Datei des Simulationsergebnisses übereinstimmen! (siehe Bug 59)</span>
|}
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.
 
[[Kategorie:EVO]]

Latest revision as of 01:11, 31 August 2020

EVO.png BlueM.Opt | Usage | Development

List of input files for BlueM.Opt

When performing a simulation-based optimization or sensitivity analysis (e.g. with BlueM.Sim, Talsim-NG or SWMM), the simulation dataset has to contain the following additional input files required by BlueM.Opt:

  • MOD-file: defines the model parameters
  • OPT-file: defines the optimization parameters
  • OBF-file: defines the objective functions
  • CON-file (optional): defines the constraints