MOD-file: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Die Seite wurde neu angelegt: 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 d...)
 
(translation)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Die Datei muss den gleichen Namen wie der [[BlueM]]-Datensatz haben, aber mit der Endung '''.MOD''', und muss sich im BlueM-Arbeitsverzeichnis befinden.  
{{Template:BlueM.Opt input files}}
This file defines the model parameters. They are derived from the [[OPT-file|optimization parameters]] and written to the input files of the simulation model (the dataset). Each line corresponds to one model parameter.  


Diese Datei definiert die zu optimierenden Modellparameter des Blauen Modells. Jede Zeile entspricht einem Modellparameter. Die Modellparameter sind durch die Spalte "OptParameter" den [[OPT-Datei|Optimierungsparametern]] zugeordnet.
The file must have the same filename as the rest of the dataset's files but have the file extension '''<code>.MOD</code>''', and be located in the same directory as the rest of the dataset.  


<pre>
''Example for auto-calibration of a rainfall-runoff model with runoff-coefficient and retention constant for two catchments'':
*ModellParameter
<bluem>
*=====================
*Model parameters
*================
*
*
*|--------------|--------------|-------|-------|--------|-------|-----|-----|--------|
*|--------------|---------|-------|------|--------|------|------|-----|--------|
*| OptParameter | Bezeichnung | Einh. | Datei |Elem. /o| Zeile | von | bis | Faktor |
*| OptParameter | Name    | Unit | File | Element| Line | from | to  | Factor |
*|-<---------->-|-<---------->-|-<--->-|-<--->-|-<---->-|-<--->-|-<->-|-<->-|-<---->-|
*|--------------|---------|-------|------|--------|------|------|-----|--------|
  | PSI          | A01_psi     |  -  |  EZG |  S201  |  10 | 110 | 115 |  1    |
  | PSI          | A01_psi |  -  |  EZG |  S201  |  10 | 110 | 114 |  1    |
  | PSI          | A02_psi     |  -  |  EZG |  S201  |  11 | 110 | 115 |  1    |
  | PSI          | A02_psi |  -  |  EZG |  S201  |  11 | 110 | 114 |  1    |
  | RetKonst    | A01_K1       |  -  |  EZG |  S201  |  10 | 143 | 149 |  10  |
  | RetKonst    | A01_K1 |  -  |  EZG |  S201  |  10 | 143 | 148 |  10  |
  | RetKonst    | A02_K1       |  -  |  EZG |  S201  |  11 | 143 | 149 |  10  |
  | RetKonst    | A02_K1 |  -  |  EZG |  S201  |  11 | 143 | 148 |  10  |
*|--------------|--------------|-------|-------|--------|-------|-----|-----|--------|
*|--------------|---------|-------|------|--------|------|------|-----|--------|
</pre>
</bluem>


===Spaltenbeschreibung===
===Description===
:{| cellpadding="2" cellspacing="2" border="0" style="border:1px solid #CCCCCC"
:{| cellpadding="5" cellspacing="0" border="0" class="standard stripes"
|- bgcolor="#F1F1F1"
|-
| width="100" | '''OptParameter''' || width="400" | Bezeichnung des Optimierungsparameters aus welchem dieser Modellparameter berechnet wird
! width="100" | Parameter !! width="400" | Description
|-
| '''OptParameter''' || Name of the [[OPT-Datei|optimization parameter]] from which this model parameter is derived.
|-  
|-  
| '''Bezeichnung''' || Bezeichnung des Parameters (beliebig)
| '''Name''' || Arbitrary name of the model parameter
|- bgcolor="#F1F1F1"
|-
| '''Einh.''' || Einheit des Parameterwertes
| '''Unit'''<br/>(optional) || Unit of the parameter value
|-
| '''File''' || File extension of the model input file in which the model parameter is located. (E.g. for [[BlueM.Sim]]: [[BlueM.Sim Eingabedateien|EZG, TRS, TAL, BOF, BOA, BOD, etc.]])
|-
| '''Element'''<br/>(optional) || Name of the element associated with the model parameter.
|-  
|-  
| '''Datei''' || Endung der Eingabedatei des BlauenModells, in der sich der Parameter befindet [EZG, TRS, TAL, BOF, BOA, BOD, etc]
| '''Line''' || Line number at which the parameter is located within the model input file.
|- bgcolor="#F1F1F1"
|-
| '''Elem. /o'''<br/>''(optional)'' || Bezeichnung des Elements für das dieser Modellparameter zuständig ist
| '''from''' & '''to''' || Column numbers between which the model parameter is defined within the model input file.
|-  
|-
| '''Zeile''' || Zeile, in der sich der Parameter befindet (gezählt vom Dateianfang der Eingabedatei)
| '''Factor''' || Factor with which the optimization parameter value should be multiplied to obtain the model parameter value.
|- bgcolor="#F1F1F1"
| '''von''' & '''bis''' || Spaltennummern, innerhalb derer der Parameter in der Eingabedatei definiert ist<br/>''(siehe Bug 170)''
|-  
| '''Faktor''' || ModellParameter = OptimierungsParameter &times; Faktor
|}
|}
Die Breite der Spalten der *.MOD-Datei darf bei Bedarf angepasst werden, nur alle "|"-Zeichen müssen erhalten bleiben!
The width of the columns can be adjusted if necessary, but the column separators (<code>|</code>) must be preserved!


Ein "*" am Anfang einer Zeile führt dazu, dass die Zeile ignoriert wird.
An asterisk (<code>*</code>) at the beginning of the line causes the line to be ignored.


[[Kategorie:EVO]]
[[Category:BlueM.Opt input files|M]]
[[Kategorie:EVO Eingabedateien]]

Latest revision as of 05:44, 22 January 2018

EVO.png BlueM.Opt | Usage | Development

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


This file defines the model parameters. They are derived from the optimization parameters and written to the input files of the simulation model (the dataset). Each line corresponds to one model parameter.

The file must have the same filename as the rest of the dataset's files but have the file extension .MOD, and be located in the same directory as the rest of the dataset.

Example for auto-calibration of a rainfall-runoff model with runoff-coefficient and retention constant for two catchments:

*Model parameters
*================
*
*|--------------|---------|-------|------|--------|------|------|-----|--------|
*| OptParameter | Name    | Unit  | File | Element| Line | from | to  | Factor |
*|--------------|---------|-------|------|--------|------|------|-----|--------|
 | PSI          | A01_psi |   -   |  EZG |  S201  |   10 | 110  | 114 |   1    |
 | PSI          | A02_psi |   -   |  EZG |  S201  |   11 | 110  | 114 |   1    |
 | RetKonst     | A01_K1  |   -   |  EZG |  S201  |   10 | 143  | 148 |   10   |
 | RetKonst     | A02_K1  |   -   |  EZG |  S201  |   11 | 143  | 148 |   10   |
*|--------------|---------|-------|------|--------|------|------|-----|--------|

Description

Parameter Description
OptParameter Name of the optimization parameter from which this model parameter is derived.
Name Arbitrary name of the model parameter
Unit
(optional)
Unit of the parameter value
File File extension of the model input file in which the model parameter is located. (E.g. for BlueM.Sim: EZG, TRS, TAL, BOF, BOA, BOD, etc.)
Element
(optional)
Name of the element associated with the model parameter.
Line Line number at which the parameter is located within the model input file.
from & to Column numbers between which the model parameter is defined within the model input file.
Factor Factor with which the optimization parameter value should be multiplied to obtain the model parameter value.

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.