# 2.1. Steuerfile

empf. Extension: .sim

Im Steuerfile wird die Anfangsbelegung verschiedener Steuerungsparameter für die durchzuführende Simulation definiert. Sie ist standortunabhängig und gilt bei jeder Option für alle Simulationsläufe.

Die Werte werden zeilenweise eingelesen, die dahinter folgende Beschreibung dient nur dem besseren Verständnis des Fileaufbaus.

Description of control file *.sim
Position | Name | Meaning | Selection | Interpretation
--- | --- | --- | --- | ---
1 | flag_multi | run option | 1 | multi run; requires following additional line with number of runs
|  |  | 2 | climate sensitivity
|  |  | 3 | multi run mit Parameter-Wahl (noch nicht vollständig bearbeitet!)
|  |  | 4 | multi run; multi run with different data sets; requires following additional line with number of runs
|  |  | 5 | multi run option for 4C with SPRINT/SIMENV on SP; requires following additional line with number of run
|  |  | 6 | single run with the same intialization for every year; requires following additional line with number of runs = 1
|  |  | 7 | multi run for one site description and a list of control files for climate, management,stand initialization
|  |  | 8 | multi run; multi run with different data sets similar flag_multi = 4; requires following additional line with number of runs
1a | site_nr | number of runs | integer | with flag_multi = 1, 4, 5, 6, 8
2 | *** | simulation specifications | comment line |
3 | year | number of simulation years | integer |
4 | time_b | start year of simulation | integer |
5 | kpatchsize | patchsize [m²] default = 200 | real |
6 | dz | foliage layer thickness [cm] default = 50 | real |
7 | ns_pro | Time step photosynthesis [d] default = 7 | integer |
8 | *** | choice of model options | comment line |
9 | flag_mort | mortality flag | 0 | without mortality
|  |  | 1 | with stress mortality only
|  |  | 2 | with stress and intrinsic mortality
10 | flag_reg | regeneration flag | 0 | without regeneration
|  |  | 1 | with regeneration
|  |  | 2 | with regeneration and weekly seedling growth
|  |  | 3 | generation of several cohorts at one time step
|  |  | 10 | planting of pine seedlings
|  |  | 11 | planting of beech seedlings
|  |  | 12 | planting of oak seedlings
|  |  | 13 | planting of spruce seedlings
|  |  | 14 | planting of birch seedlings
|  |  | 15 | planting of aspen seedlings
|  |  | 20 | planting of small trees in the first year given by data from file *.pla
|  |  | 30 | regeneration according to data from FORGRA (given by Vincent Kint)
11 | flag_forska | use FORSKA environmental factors and regeneration | (default = 0) |
12 | flag_stand | initialization flag | 0 | without Initialisation
|  |  | 1 | read data from *.ini
|  |  | 2 | generate *.ini from original data
13 | flag_sveg | ground vegetation | 0 | no ground vegetation
|  |  | 1 | initialisation of ground vegetation with fixed data set
14 | flag_mg | management flag | 0 | without managment
|  |  | 1 | simple management routine
|  |  | 2 | new management routines (thinnings)
|  |  | 3 | yield table management, adapted for applications by Vincent Kint
|  |  | 4 | seeding routine, seeds once in simulation time
|  |  | 5 | thinning of dead trees, which are removed from stand (no litter input)
|  |  | 9 | Austrian management
|  |  | 10 | disturbance management (Bavaria)
15 | flag_dis | disturbance flag | 0 | without disturbance
16 | flag_light | ligth algorithm number | 1 | classical gap model approach
|  |  | 2 | cohorts with crown projection area, light is averaged after each layer
|  |  | 3 | cohorts with crown projection area, light is absorbed per layer and cohort
|  |  | 4 | cohorts with crown projection area, light is absorbed per layer and cohort and modified by average yearly sun inclination
17 | flag_folhei | foliage-height relationship | 0 | old (linear)
|  |  | 1 | new (nonlinear)
18 | flag_volfunc | volume function | 0 | old (two sapwood cones)
|  |  | 1 | new (sapwood cylinder below crown base and cone above)
19 | flag_resp | respiration flag | 0 | tree respiration equals 0.52*NPP
|  |  | 1 | tree respiration modelled with organ specific respiration rates
20 | flag_limi | limitation flag (limitations of Photosynthesis) | 0 | no limitation
|  |  | 1 | only drought limitation
|  |  | 2 | only nitrogen limitation
|  |  | 3 | drought and nitrogen limitation
|  |  | 4 | nitrogen dynamic, only nitrogen limitation
|  |  | 5 | nitrogen dynamic, drought and nitrogen limitation
|  |  | 6 | nitrogen dynamic from mineralisation, only nitrogen limitation
|  |  | 7 | nitrogen dynamic from mineralisation, drought and nitrogen limitation
|  |  | 8 | only nitrogen limitation, age-dependent
|  |  | 9 | drought and age-dependent nitrogen limitation
21 | flag_decomp | choice of decomposition model | 0 | uniform decomposition model of all litter fractions (incl. stem wood and coarse roots)
|  |  | 1 | stem wood and coarse root decay in a separate model with no direct N mineralisation and input into the humus layer according to N release
22 | flag_sign | root activity function flag | 0 | constant sigman
|  |  | 1 | sigman varies with tree dimension
23 | flag_wred | soil water uptake flag | 1 | function with uptake inhibition near wilting point and field capcity
|  |  | 2 | uptake restrict to 4%
|  |  | 3 | reduction along a profile
|  |  | 4 | specific reduction function for Beerenbusch
|  |  | 5 | no reduction
24 | flag_wurz | root distribution flag | 0 | equally distributed over all layers
|  |  | 1 | root profile
|  |  | 2 | input of root profile after request; unchanged during the simulation time
25 | flag_cond | heat conductance flag | 0 | thermal conductivity and capacity: de Vries-approach; soil surface temperature equals temperature of 1. layer
|  |  | 1 | thermal conductivity and capacity: Neusypina-approach; soil surface temperature equals temperature of 1. layer
|  |  | 10 | thermal conductivity and capacity: de Vries-approach; real soil surface temperature (additional to the soil profile)
|  |  | 11 | thermal conductivity and capacity: Neusypina-approach; real soil surface temperature (additional to the soil profile)
|  |  | 20 | thermal conductivity and capacity: de Vries-approach; reading soil surface temperature after request
|  |  | 21 | thermal conductivity and capacity: Neusypina-approach; reading soil surface temperature after request
26 | flag_int | interception flag | 0 | total interception of canopy and ground vegetation (with total crown storage capacity)
|  |  | 1 | interception for each cohort (with storage capacity in each crown layer and with distribution of precipitation over all canopy layers)
|  |  | 2 | interception for each cohort (with storage capacity for each cohort); precipitation distributed according to foliage
|  |  | 3 | pine interception from Anders (storage capacity = 2.9 mm)
|  |  | 4 | fit for Level II Brandenburg, pine (20% of precipitation)
|  |  | 5 | 30% of precipitation (for spruce); faster evaporation
27 | flag_eva | evapotranspiration flag | 0 | Turc / Ivanov
|  |  | 1 | Priestley / Taylor
|  |  | 2 | Priestley / Taylor for each cohort
|  |  | 3 | Penman / Monteith
|  |  | 4 | Penman / Monteith for each cohort
|  |  | 5 | Haude
28 | flag_CO2 | CO2 flag | 0 | constant atmospheric mixing ratio as specified in model.par
|  |  | 1xx, xx = as choice detailed below | increasing atmospheric mixing ratio as historic increase
|  |  | 2xx, xx = as choice detailed below | step change in the middle of the simulation period
|  |  | xx = 01 | Kohlmaier function
|  |  | xx = 02 | LTEEF scenario
|  |  | xx = 03 | Mauna Loa series
|  |  | xx = 10 | IPCC IS92a after Bern CC model, reference
|  |  | xx = 11 | IPCC SRES A1FI after Bern CC model, reference
|  |  | xx = 12 | IPCC SRES A2 after Bern CC model, reference
|  |  | xx = 13 | IPCC SRES B1 after Bern CC model, reference
29 | flag_sort | assortment | 0 | all assortments
|  |  | 1 | without stems (Stammholz)
|  |  | 2 | only LAS with 3m + industrial + fuel wood
|  |  | 3 | only LAS with 4m + industrial + fuel wood
30 | flag_wpm | wood product model | 0 | (default = 0) if 1: wood product model (WPM) is called with output
|  |  | 2 | Socio Economic Analasys (SEA) called with output
|  |  | 3 | SEA and WPM called with output
|  |  | 4 | generating spinup-file without simulation (using manrec- and mansort-files)
|  |  | 5 | WPM without simulation (using manrec- and mansort-files)
31 | flag_stat | statistic flag | 0 | no analysis
|  |  | 1 | comparison with measurements and statistical analysis
|  |  | 2 | additional to 1 output of the tripels of measurement , simulation value and residual
31 | *** | output specifications | comment line |
32 | time_out | Yearly output flag | 0 | no
|  |  | n (n=1,2,3,...) | yes; output every n years
|  |  | -1 | output of control file and compressed files at start and end
|  |  | -2 | output of compressed file at end without header (only useful with simenv-version)
33 |  | Selection of yearly output files | string | selection of any yearly output files; each name in a new line; ending with end (always necessary)
34 | flag_dayout | Daily output flag | 0 | no
|  |  | 1 | yes
36 |  | Selection of daily output files | string | selection of any daily output files; each name in a new line; ending with end (always necessary)
35 | flag_cohout | cohort output flag | 0 | no
|  |  | 1 | yes
36 |  | Selection of cohort output file | string | selection of any cohort output files; each name in a new line; ending with end (always necessary)
37 | flag_sum | summation output flag | 0 |
|  |  | 1 | daily output
|  |  | 2 | output with time step of photosynthesis
|  |  | 3 | monthly
|  |  | 4 | yearly
38 | *** | input data | comment line |
39 | specfile | species parameter file (species.par) | string |
40 | site_name | name of output-files | string | identifier (first part of the name of all output files of this run)
41 | climfile | name of climate data file | string |
42 | sitefile | name of soil data file (*.sop) | string |
43 | valfile | name of soil data file (*.soi) | string |
44 | treefile | name of initialization file of stand (*.ini) | string |
45 | standid | stand identifier | integer | stand identifier for use of multi initialization file; be skiped wit 999 in case of single intialization file
46 | manfile | management file | string |
47 | depofile | name of deposition data file (*.dep) | string | in case of dummy file or file not found: all deposition data set to zero
48 | redfile | name of RedN file (*.red) | string | values of RedN (model parameter); in case of dummy file or file not found: internal calculation of RedN
49 | litfile | name of litter intilisation file (*.lit) | string | data of litter fraction intilaisation; in case of dummy file or file not found: internal initialisation of litter fractions
50 | *** | run number | comment line | !!! all following lines only necessary with flag_multi = 1 !!!
51 |  |  | (integer, flag_name) | change of any flags (in pairs of value and flag_name) ending with a certain line (value < 0, name = end); this last line is always necessary
52 | specfile | species parameter file (species.par) | string |
53 | site_name | name of output-files | string |
54 | climfile | name of climate data file | string |
55 | sitefile | name of soil data file (*.sop) | string |
56 | valfile | name of soil data file (*.soi) | string |
57 | treefile | name of initialization file of stand (*.ini) | string |
58 | standid | stand identifier | integer | stand identifier for use of multi initialization file; be skiped in case of single intialization file
59 | manfile | management file | string |
60 | depofile | name of deposition data file (*.dep) | string |
61 | redfile | name of RedN file (*.red) | string |
62 | litfile | name of litter intilisation file (*.lit) | string |

Single run : flag_multi = 0; Angabe der Zeilen 1 bis 48 erforderlich (ohne 1a!) - s. Beispiel
Multi run : flag_multi = 1; mehrere Simulationsläufe nacheinander; Anzahl wird in Zeile 1a definiert;
durch Informationen bis Zeile 40 wird der erste Lauf festgelegt;
ab Zeile 49 wird der nächste Lauf festgelegt, wobei alle input-Files noch einmal angegeben werden müssen;
flags gelten weiterhin, sofern sie nicht durch explizite Auswahl überschrieben werden.
Achtung: es gilt immer die zuletzt erzeugte Konstellation !!!
Wiederholung ab Zeile 49 entsprechend der in Zeile 1a angegebenen Anzahl der Simulationen
s. Beispiel

### Änderung von flags

Für jeden Simulationslauf können beliebig viele flags neu gesetzt werden.
Die Auswahl erfolgt in der Form
value flag_name

d.h. pro Zeile kann ein flag gesetzt werden, der die vorherige Einstellung überschreibt.
Der flag_name kann den Beispielen der sim-Files entnommen werden.

### Beenden der flag-Änderung

Die Änderung der flags wird durch eine Zeile der obigen Form abgeschlossen, wobei

value < 0 flag_name = optional

beispielsweise:

-99.0 end

Diese Zeile muß immer angegeben werden, auch wenn keine flags geändert wurden !!!

### Auswahl der jährlichen Output-Dateien

Aus den vorhanden Output-Files können für die gesamte Simulation beliebig viele Files ausgewählt werden.

Zur Auswahl stehen:

'c_bal','Chum','Copm','classd', 'classh', 'clim', 'litter',
'Nhum','Nopm','manrec', 'mansort','root','sdrought',
'soil', 'spec', 'standsort','veg', 'veg_be', 'veg_bi', 'veg_pi', 'veg_oa','veg_sp','veg_sveg'

Die Auswahl erfolgt durch Angabe des Strings; jede Ausgabeanforderung wird auf eine neue Zeile geschrieben, z.B.

soil

veg
abgeschlossen wird die Auswahl mit

end

Die letzte Zeile (end) muss immer angegeben werden !!!

Wird nur diese Zeile angegeben, so werden alle jährlichen Output-Files ausgegeben.

Diese Einstellungen werden nur in Zusammenhang mit dem jährlichen Output-Flag time_out > 0 aktiv !

### Auswahl der täglichen Output-Dateien

Aus den vorhanden Output-Files können für die gesamte Simulation beliebig viele Files ausgewählt werden.

Zur Auswahl stehen:

'Chumd','Copmd','COPMfract', 'day','NH4','NH4c','NO3','NO3c','Nhumd','Nopmd',
'NOPMfract', 'perc', 'temp', 'water', 'wupt'

Die Auswahl erfolgt durch Angabe des Strings; jede Ausgabeanforderung wird auf eine neue Zeile geschrieben, z.B.

day
perc
abgeschlossen wird die Auswahl mit

end

Die letzte Zeile (end) muss immer angegeben werden !!!

Wird nur diese Zeile angegeben, so werden alle jährlichen Output-Files ausgegeben.

Diese Einstellungen werden nur in Zusammenhang mit dem täglichen Output-Flag flag_dayout > 0 aktiv !

### Auswahl der Cohorten-Output-Dateien

Aus den vorhanden Output-Files können für die gesamte Simulation beliebig viele Files ausgewählt werden.

Zur Auswahl stehen:

für den täglichen Output

'ass', 'aevi', 'ddi', 'dem', 'dips', 'gp', 'gsdps', 'interc',
'Ndemc_d', 'Nuptc_d', 'N_pool', 'res', 'resbr', 'ressap', 'resfrt', 'sup'

und für den jährlichen Output

'age', 'atr', 'bioi', 'cpa', 'daybb', 'dcrb', 'diac', 'diam', 'dtr', 'fol',
'foli', 'frt', 'frti', 'frtrel', 'geff', 'gfol', 'gfrt', 'grossass', 'gsap',
'gsd', 'hbo', 'hea', 'hei', 'hrt', 'leaf', 'maintres', 'nas', 'npp', 'sap',
'sfol', 'sfrt', 'spn', 'ssap', 'stem', 'str', 'tdb','trman', 'ttb','Ndemc_c','Nuptc_c','Nstr','rooteff'
Die Auswahl erfolgt durch Angabe des Strings; jede Ausgabeanforderung wird auf eine neue Zeile geschrieben, z.B.

ass
npp
abgeschlossen wird die Auswahl mit

end

Die letzte Zeile (end) muss immer angegeben werden !!!

Wird nur diese Zeile angegeben, so werden alle jährlichen Output-Files ausgegeben.

Diese Einstellungen werden nur in Zusammenhang mit dem jährlichen Output-Flag time_out > 0 bzw. mit dem täglichen Output-Flag flag_dayout > 0 aktiv !