|  | about 4C news 4C guide theory applications publications contact |  | user interface | user manual
Simulation control file Description Recommended extension: .sim The control file defines the start configuration of different control parameters for the simulation that is to be performed. It applies for all simulation runs. The input of the values happens line by line. The following description only serves the purpose of a better understanding of the file configuration. The following table contains the description of each line of the control file with the selection options.
Position | Name | Meaning | Selection | Description
--- | --- | --- | --- | ---
1 | flag_multi | run option | 1 | multi run; requires following additional line 2 with number of runs
2 | climate sensitivity
3 | multi run with parameter choice (not complete!)
4 | multi run; multi run with different data sets similar flag_multi = 8; 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 initialisation for every year; requires following additional line with number of runs = 1
7 | multi run with a list of control files for climate, soil, management,stand initialisations, deposition, litter initialisation
8 | multi run; multi run with different data sets similar flag_multi = 4; requires following additional line with number of runs
9 | multi run with different data sets similar flag_multi = 8; allows simulation with divers climate scenarios (0 - 3K) and a set of its realisations; requires following additional line with number of runs
10 | multi run with different data sets similar flag_multi = 9; allows simulation with divers climate scenarios (RCP) and a set of its realisations; requires following additional line with number of runs
2 | site_nr | number of runs | integer | with flag_multi = 1, 4, 5, 6, 8, 9, 10
3 | *** | simulation specifications | comment line |
4 | year | number of simulation years | integer |
5 | time_b | start year of simulation | integer |
6 | kpatchsize | patchsize [m²] default = 200 | real |
7 | dz | foliage layer thickness [cm] default = 50 | real |
8 | ns_pro | Time step photosynthesis [d] default = 7 | integer |
9 | *** | choice of model options | comment line |
10 | flag_mort | mortality flag | 0 | without mortality
1 | with stress mortality only
2 | with stress and intrinsic mortality
11 | 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
16 | planting of Aleppo pine seedlings
17 | planting Douglas fir seedlings
18 | planting black locust 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)
12 | flag_forska | use FORSKA environmental factors and regeneration | (default = 0) |
13 | flag_stand | initialisation flag | 0 | without Initialisation
1 | read data from *.ini
2 | generate *.ini from original stand data
14 | flag_sveg | ground vegetation | 0 | no ground vegetation
1 | initialisation of ground vegetation with fixed data set
15 | flag_mg | management flag | 0 | without management
1 | simple management routine
2 | new management routines (thinnings) (not recommended)
3 | target based management, adapted for applications in OakChain (using target stem numbers for thinning)
33 | target based management (using relative biomass reduction parameter)
4 | seeding routine, seeds once in simulation time
5 | thinning of dead trees, which are removed from stand (no litter input)
8 | SRC management
9 | Austrian management
10 | disturbance management (Bavaria)
16 | flag_dis | disturbance flag | 0 | without disturbance
1 | with biotic disturbance (mistletoe, defoliator, stem, xylem, phloem or root disturber) a management file must be available, see flag_mg
17 | flag_light | light 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
18 | flag_folhei | foliage-height relationship | 0 | old (linear)
1 | new (nonlinear)
19 | flag_volfunc | volume function | 0 | old (two sapwood cones)
1 | new (sapwood cylinder below crown base and cone above)
20 | flag_resp | respiration flag | 0 | tree respiration equals 0.52*NPP
1 | tree respiration modeled with organ specific respiration rates
21 | flag_limi | limitation flag (limitations of Photosynthesis) | 0 | no limitation
1 | only drought limitation
2 | only nitrogen limitation; fixed per species
3 | like 2 and drought limitation
4 | nitrogen dynamic, only nitrogen limitation
5 | nitrogen dynamic, drought and nitrogen limitation
6 | nitrogen dynamic from mineralisation, only nitrogen limitation; daily, per cohort
7 | nitrogen dynamic from mineralisation, drought and nitrogen limitation; daily, per cohort
10 | drought and nitrogen limitation; no N-limitation at 120 kg/ha anorganic N, under it decrease depending on N demand and N mineralisation
11 | reduction of photosynthesis by ratio of cumulated N uptake and N demand of each species; daily calculation
12 | exponential reduction of photosynthesis by ratio of cumulated N uptake and N demand of each species; daily calculation
13 | reduction of photosynthesis by modified ratio of cumulated N uptake and N demand of each species; daily calculation
14 | N limitation as 13; no drought limitation
15 | like 13; for species Pinus sylvestris another approach is used
22 | 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
10 | like 0; N uptake distribution controlled by N-supply of cohorts
11 | like 1; N uptake distribution controlled by N-supply of cohorts
20 | like 0; read litter input
21 | like 1; read litter input
30 | like 0; no litter input
31 | like 1; no litter input
40 | like 0; N uptake controlled by C/N-ratio of non-heartwood
41 | like 1; N uptake controlled by C/N-ratio of non-heartwood
23 | flag_sign | root activity function flag | 0 | constant sigman
1 | sigman varies with tree dimension
24 | flag_wred | soil water uptake flag | 1 | function with uptake inhibition near wilting point and field capacity
2 | uptake restrict to 4%
3 | reduction along a profile
4 | specific reduction function for Beerenbusch
5 | no reduction
6 | uptake restrict to 50%
7 | uptake restrict to 25%
8 | ArcEGMO
10 | function with uptake exponential inhibition near wilting point and field capacity
25 | flag_wurz | root distribution flag | 0 | equally distributed over all layers
1 | root profile: Jackson approach
2 | input of root profile after request; unchanged during the simulation time
7 | Jackson approach with fixed root depth given from soil data
26 | flag_cond | heat conductance flag | 0 | thermal conductivity: de Vries-approach; soil surface temperature equals temperature of 1. layer
1 | thermal conductivity: Neusypina-approach; soil surface temperature equals temperature of 1. layer
2 | thermal conductivity: concept of resistance; soil surface temperature equals temperature of 1. layer
3 | thermal conductivity: Campbell approach; soil surface temperature equals temperature of 1. layer
10 | thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile)
11 | thermal conductivity: Neusypina-approach; real soil surface temperature (additional to the soil profile)
12 | thermal conductivity: concept of resistance; real soil surface temperature (additional to the soil profile)
13 | thermal conductivity: Campbell approach; real soil surface temperature (additional to the soil profile)
20 | thermal conductivity: de Vries-approach; reading soil surface temperature after request
21 | thermal conductivity: Neusypina-approach; reading soil surface temperature after request
22 | thermal conductivity: concept of resistance; reading soil surface temperature after request
23 | thermal conductivity: Campbell approach; reading soil surface temperature after request
30 | thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile), daily correction factor and damping coefficient constant 1
31 | thermal conductivity: Neusypina-approach; real soil surface temperature (additional to the soil profile), daily correction factor and damping coefficient constant 1
32 | thermal conductivity: concept of resistance; real soil surface temperature (additional to the soil profile), daily correction factor and damping coefficient constant 1
33 | thermal conductivity: Campbell approach; real soil surface temperature (additional to the soil profile), daily correction factor and damping coefficient constant 1
40 | thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile), no recalculation of physical soil parameters
41 | thermal conductivity: Neusypina-approach; real soil surface temperature (additional to the soil profile), no recalculation of physical soil parameters
42 | thermal conductivity: concept of resistance; real soil surface temperature (additional to the soil profile), no recalculation of physical soil parameters
43 | thermal conductivity: Campbell approach; real soil surface temperature (additional to the soil profile), no recalculation of physical soil parameters
27 | 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
6 | no interception
10xx | like 0; reduction of throughfall to xx %
11xx | like 1; reduction of throughfall to xx %
12xx | like 2; reduction of throughfall to xx %
16xx | like 6; reduction of throughfall to xx %
28 | flag_eva | evapotranspiration flag | 0 | Turc / Ivanov; calculation of transpiration demand after deduction of soil evaporation and interception with BIOME3 approach
1 | Priestley / Taylor
2 | Priestley / Taylor for each cohort
3 | Penman / Monteith
4 | Penman / Monteith for each cohort
5 | Haude
6 | Turc / Ivanov; calculation of transpiration demand without consideration of soil evaporation and interception with BIOME3 approach
7 | Turc / Ivanov; transpiration demand from potential evapotranspiration after deduction of soil evaporation and interception
29 | flag_CO2 | CO2 flag | 0 | constant atmospheric mixing ratio (350 ppm)
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
xx = 14 | IPCC B2 after Bern CC model, reference
xx = 15 | IPCC A1B after Bern CC model, reference
xx = 16 | IPCC A1p after Bern CC model, reference
xx = 17 | RCP8.5, final release, 26 Nov. 2009
xx = 18 | RCP2.6, final release, 26 Nov. 2009
xx = 19 | RCP4.5, final release, 26 Nov. 2009
xx = 20 | RCP6.0, final release, 26 Nov. 2009
xx = 31 | RCP2.6, 1765-2300, PROFOUND-DB
xx = 32 | RCP6.0, 1765-2300, PROFOUND-DB
xx = 33 | 1765 - 2005 historical data (PROFOUND-DB), time>2005 CO2 = 378.81 ppm
yyy | setting of constant atmospheric mixing ratio yyy ppm with yyy > 250 ppm (integer)
199 | special function implemented (Hyytiälä)
30 | 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
31 | flag_wpm | wood product model | 0 | (default = 0) if 1: wood product model (WPM) is called with output
2 | Socio- Economic Analyses (SEA) called with output
3 | SEA and WPM called with output
32 | flag_stat | statistic flag | 0 | no analysis
1 | comparison with measurements and statistical analysis
2 | additional to 1 output of the triples of measurement , simulation value and residual
33 | *** | output specifications | comment line |
34 | 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)
35 |  | Selection of yearly output files | string | selection of any yearly output files; each name in a new line; ending with end (always necessary)
36 | flag_dayout | Daily output flag | 0 | no
1 | yes
37 |  | Selection of daily output files | string | selection of any daily output files; each name in a new line; ending with end (always necessary)
38 | flag_cohout | cohort output flag | 0 | no
1 | yes
2 | yes with additinal output of three files
39 |  | Selection of cohort output file | string | selection of any cohort output files; each name in a new line; ending with end (always necessary)
40 | flag_sum | summation output flag | 0 |
1 | daily output
2 | output with time step of photosynthesis
3 | monthly
4 | yearly
41 | *** | input data | comment line |
42 | specfile | species parameter file (species.par) | string |
43 | site_name | name of output-files | string | identifier (first part of the name of all output files of this run)
44 | climfile | name of climate data file | string |
45 | sitefile | name of soil data file (*.sop) | string |
46 | valfile | name of soil data file (*.soi) | string |
47 | treefile | name of initialisation file of stand (*.ini) | string |
48 | standid | stand identifier | integer | stand identifier for use of multi initialisation file; be skipped with 999 in case of single initialisation file
49 | manfile | management file | string |
50 | depofile | name of deposition data file (*.dep) | string | in case of dummy file or file not found: all deposition data set to zero
51 | 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
52 | litfile | name of litter initialisation file (*.lit) | string | data of litter fraction initialisation; in case of dummy file or file not found: internal initialisation of litter fractions
53 | *** | run number | comment line | !!! all following lines only necessary with flag_multi = 1 and number of runs > 1!!!
54 |  |  | (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
55 | specfile | species parameter file (species.par) | string |
56 | site_name | name of output-files | string |
57 | climfile | name of climate data file | string |
58 | sitefile | name of soil data file (*.sop) | string |
59 | valfile | name of soil data file (*.soi) | string |
60 | treefile | name of initialisation file of stand (*.ini) | string |
61 | standid | stand identifier | integer | stand identifier for use of multi initialisation file; be skipped in case of single initialisation file
62 | manfile | management file | string |
63 | depofile | name of deposition data file (*.dep) | string |
64 | redfile | name of RedN file (*.red) | string |
65 | litfile | name of litter initialisation file (*.lit) | string |
The brackets contain the recommended file extension.
about 4C | news | 4C guide | theory | applications | publications | contact