OPT-file: Difference between revisions

From BlueM
Jump to navigation Jump to search
(translation)
(Removed BlueM.MPC-specific parts (BlueM.Opt v1.7))
Line 1: Line 1:
{{Template:BlueM.Opt input files}}
{{Template:BlueM.Opt input files}}
<div class="info_versionen">
'''Versions:'''
* '''current''' v1.7 (as of r1779)
* [{{SERVER}}/index.php?title=OPT-file&oldid=7258 v1.6 and older]
</div>
This file defines the parameters that are to be optimized. Each line corresponds to one optimization parameter. Each optimization parameter can be used to calculate one or more [[MOD-file|model parameters]].
This file defines the parameters that are to be optimized. Each line corresponds to one optimization parameter. Each optimization parameter can be used to calculate one or more [[MOD-file|model parameters]].


Line 9: Line 14:
*=======================
*=======================
*
*
*|--------------|-------|-------------|--------|--------|-----------|----------|-----------|  
*|--------------|-------|-------------|--------|--------|-----------|
*| Name        | Unit  | Start value |  Min  |  Max  | Relation  |  Object  | Time      |  
*| Name        | Unit  | Start value |  Min  |  Max  | Relation  |
*|-<---------->-|-<--->-|-<--------->-|-<---->-|-<---->-|-<------->-|-<------>-|-<------->-|
*|-<---------->-|-<--->-|-<--------->-|-<---->-|-<---->-|-<------->-|
  | RunoffCoeff  |  -  |    0.5      |  0.1  |  0.9  |          |          |          |  
  | RunoffCoeff  |  -  |    0.5      |  0.1  |  0.9  |          |
  | RetConstV    |  -  |    1        |  0.1  |    10  |          |          |          |  
  | RetConstV    |  -  |    1        |  0.1  |    10  |          |
  | RetConst1    |  -  |    1        |  0.1  |    10  |    >    |          |          |  
  | RetConst1    |  -  |    1        |  0.1  |    10  |    >    |
  | RetConst2    |  -  |    1        |  0.1  |    10  |    >    |          |          |  
  | RetConst2    |  -  |    1        |  0.1  |    10  |    >    |
*|--------------|-------|-------------|--------|--------|-----------|----------|-----------|  
*|--------------|-------|-------------|--------|--------|-----------|
</bluem>
</bluem>


Line 39: Line 44:
* <code>>=</code> (larger or equal than)
* <code>>=</code> (larger or equal than)
If a relation is specified, the algorithm makes sure that the relation is always adhered to by generating new parameter values up to 1000 times if necessary, until the defined relation is true.
If a relation is specified, the algorithm makes sure that the relation is always adhered to by generating new parameter values up to 1000 times if necessary, until the defined relation is true.
|-
| '''Object''' || Optional parameter for predictive control, used for determining an unambiguous order for the moving time frame. Has to consist of the combination "OBJECT Name ATTRIBUTE", e.g. "ORIFICE Gate SETTING". Only used by [[BlueM.MPC]].
|-
| '''Time''' || Optional parameter for predictive control, used for determining an unambiguous order for the moving time frame. Only used by [[BlueM.MPC]].
|}
|}
The width of the columns can be adjusted if necessary, but the column separators (<code>|</code>) must be preserved!
The width of the columns can be adjusted if necessary, but the column separators (<code>|</code>) must be preserved!

Revision as of 02:02, 8 April 2018

EVO.png BlueM.Opt | Usage | Development

BlueM.Opt input files: MOD · OPT · OBF · CON

Versions:

This file defines the parameters that are to be optimized. Each line corresponds to one optimization parameter. Each optimization parameter can be used to calculate one or more model parameters.

This file must have the same filename as the rest of the simulation dataset but have the file extension .OPT, and be located in the same directory as the rest of the dataset.

Example with 4 optimization parameters (calibration of a rainfall-runoff model by optimizing runoff coefficient and retention constants): 

*Optimization parameters
*=======================
*
*|--------------|-------|-------------|--------|--------|-----------|
*| Name         | Unit  | Start value |  Min   |  Max   | Relation  |
*|-<---------->-|-<--->-|-<--------->-|-<---->-|-<---->-|-<------->-|
 | RunoffCoeff  |   -   |    0.5      |   0.1  |   0.9  |           |
 | RetConstV    |   -   |    1        |   0.1  |    10  |           |
 | RetConst1    |   -   |    1        |   0.1  |    10  |     >     |
 | RetConst2    |   -   |    1        |   0.1  |    10  |     >     |
*|--------------|-------|-------------|--------|--------|-----------|

Description

Parameter Description
Name Name of the optimization parameter (arbitrary)
This name is also used in the MOD-file so that model parameters can be associated with optimization parameters
Unit Unit of the parameter value (optional)
Start value Start value for the parameter
Min & Max Lower and upper bound for the parameter value
Relation Optional relation to another optimization parameter. The relation is defined as a constraint of the parameter's value in regard to the value of the optimization parameter on the previous line. (#241)
  •   (no relation)
  • < (smaller than)
  • <= (smaller or equal than)
  • > (larger than)
  • >= (larger or equal than)

If a relation is specified, the algorithm makes sure that the relation is always adhered to by generating new parameter values up to 1000 times if necessary, until the defined relation is true.

The width of the columns can be adjusted if necessary, but the column separators (|) must be preserved!

An asterisk (*) at the beginning of the line causes the line to be ignored.

Retrieved from "https://wiki.bluemodel.org/index.php?title=OPT-file&oldid=7349"