BlueM.Opt input files: Difference between revisions

From BlueM
Jump to navigation Jump to search
 
(67 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
OptZiele=Pfad\zu\den\OptZielWerten.zie
</ini>
Für INI-Syntax siehe [http://de.wikipedia.org/wiki/Initialisierungsdatei Wikipedia/Ini-Datei].


==Datei *.OPT (Optimierungsparameter)==
[[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 des Blauen Modells. Jede Zeile entspricht einem Parameter.
<pre>
*Optimierungsparameter
*=====================
*
*|--------------|-------|-------|-------|-----|-----|-----------|--------|--------|
*| Bezeichnung  | Einh. | Datei | Zeile | von | bis | Anfangsw. |  Min  |  Max  |
*|-<---------->-|-<--->-|-<--->-|-<--->-|-<->-|-<->-|-<------->-|-<---->-|-<---->-|
| A01_psi      |  -  |  EZG  |  10  | 110 | 115 |    0.5    |    0  |  1    |
| A02_psi      |  -  |  EZG  |  11  | 110 | 115 |    0.5    |    0  |  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)
|-
| '''Einh.''' || Einheit des Parameterwertes
|- bgcolor="#F1F1F1"
| '''Datei''' || Endung der [[BlauesModell Eingabedateien | Eingabedatei des BlauenModells]], in der sich der Parameter befindet [EZG, TRS, TAL, BOF, BOA, BOD, etc]
|-
| '''Zeile''' || Zeile, in der sich der Parameter befindet (gezählt vom Dateianfang der Eingabedatei)
|- bgcolor="#F1F1F1"
| '''von''' & '''bis''' || Spaltennummern, innerhalb derer der Parameter in der Eingabedatei definiert ist
|-
| '''Anfangsw.''' || Anfangswert für den Parameter
|- bgcolor="#F1F1F1"
| '''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 *.ZIE (Optimierungsziele)==
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 00:11, 31 August 2020

EVO.png BlueM.Opt | Download | 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