user interface | user manual

Content of user manual

 

Description of input files

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
 2 multi run; climate sensitivity
 6
single run with the same initialisation for every year
 7 multi run with a list of control files for climate, soil, management,stand initialisations, deposition, litter initialisation, CO2 flag
 8
multi run; multi run with different data sets
 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
10 multi run with different data sets similar flag_multi = 9; allows simulation with divers climate scenarios (RCP) and a set of its realisations
 2 site_nr number of runs  integer with flag_multi = 1, 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  see 4C_description, Chapter 2.1;
no changes are recommended
 8  ns_pro Time step photosynthesis [d] default = 7  integer  see 4C_description, Chapter 4.2;
no changes are recommended
 9  ***  choice of model options  comment line  
 10 flag_mort mortality flag  0 without mortality
 1 with stress mortality only; see 4C_description, Chapter 7.2
 2 with stress and intrinsic mortality; see 4C_description, Chapter 7
 11 

flag_reg 

regeneration flag 

 0 without regeneration
 1 with regeneration; see 4C_description, Chapter 8
 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) not in use, 0 has to be set
 13 flag_stand initialisation flag  0 without Initialisation 
 1 read data from *.ini
 2 generate *.ini from original stand data; see 4C_initialization_manual.pdf  
 14 flag_sveg  ground vegetation   0  no ground vegetation 
 1 initialisation of ground vegetation with fixed data set; no input is neccessary
 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 given with the appropriate flag_mg;
see 4C_description, Chapter 10
 17 flag_light light algorithm number  1 classical gap model approach,
see 4C_description, Chapter 3.5.1
 2 cohorts with crown projection area, light is averaged after each layer,
see 4C_description, Chapter 3.5.2
 3 cohorts with crown projection area, light is absorbed per layer and cohort,
see 4C_description, Chapter 3.5.3
 4 cohorts with crown projection area, light is absorbed per layer and cohort and modified by average yearly sun inclination,
see 4C_description, Chapter 3.5.4
 18 flag_folhei foliage-height relationship  0 old (linear)
 1 new (nonlinear),
see 4C_description, Chapter 4.4.2
 19 flag_volfunc volume function  0 old (two sapwood cones) 
 1 new (sapwood cylinder below crown base and cone above),
see 4C_description, Chapter 4.4.3 
 20 flag_resp respiration flag  0 tree respiration equals 0.52*NPP 
 1 tree respiration modeled with organ specific respiration rates),
see 4C_description, Chapter 4.3
 21





flag_limi





limitation flag (limitations of Photosynthesis)





 0 no limitation 
 1 only drought limitation),
see 4C_description, Chapter 4.2.3
 2 only nitrogen limitation; fixed per species), see 4C_description, Chapter 4.2.4 
 3 like 2 and drought limitation 
 6
nitrogen dynamic from mineralisation,
only nitrogen limitation;
daily, per cohort;
see 4C_description, Chapter 4.2.4, Eq. (4.19)
 7
nitrogen dynamic from mineralisation, drought and nitrogen limitation; daily, per cohort; see 4C_description, Chapter 4.2.4, Eq. (4.19)
 8
only nitrogen limitation, age-dependent
 9
drought and age-dependent nitrogen limitation
 10 drought and nitrogen limitation; 
no N-limitation at 120 kg/ha anorganic N, under it decrease depending on N demand and N mineralisation;
see 4C_description, Chapter 4.2.4, Eq. (4.20)
 11 reduction of photosynthesis by ratio of cumulated N uptake and N demand of each species;
daily calculation;
see 4C_description, Chapter 4.2.4, Eq. (4.21)
 12 exponential reduction of photosynthesis by ratio of cumulated N uptake and N demand of each species;
daily calculation;
see 4C_description, Chapter 4.2.4, Eq. (4.23)
 13 reduction of photosynthesis by modified ratio of cumulated N uptake and N demand of each species;
daily calculation;
see 4C_description, Chapter 4.2.4, Eq. (4.22)
 14 N limitation like 13;
no drought limitation
 15 N limitation like 13;
for species Pinus sylvestris another approach is used;
see 4C_description, Chapter 4.2.4, Eq. (4.24)
 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, input into the humus layer according to N release;
see 4C_description, Chapter 6.3.2
 10 like 0; N uptake is controlled by N-supply of the cohorts;
see 4C_description, Chapter 6.3.5
 11 like 1; N uptake is controlled by N-supply of the cohorts
 20 like 0; read litter input for selected years
 21 like 1; read litter input for selected years
 30 like 0; no litter input
 31 like 1; no litter input
 40 like 0; N uptake is controlled by C/N-ratio of non-heartwood
 41 like 1; N uptake is 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;
see 4C_description, Chapter 6.1.3, case a)
 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%
 10 function with uptake exponential inhibition near wilting point and field capacity;
see 4C_description, Chapter 6.1.3, case b)
11 case for Mistletoe, function after van Wijk, 2000 with a very strong reduction in water availability
 25 flag_wurz root distribution flag  0 equally distributed over all layers
 1 root profile: Jackson approach;
see 4C_description, Chapter2.3.1, case b)
 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, physical soil parameters wil be recalculated depending on humus content;
see 4C_description, Chapter 6.2.2, case b) 
 1
thermal conductivity: Neusypina-approach; soil surface temperature equals temperature of 1. layer;
see 4C_description, Chapter 6.2.2, case a) 
 3 thermal conductivity: Campbell approach; soil surface temperature equals temperature of 1. layer, physical soil parameters wil be recalculated depending on humus content;
see 4C_description, Chapter 6.2.2, case e) 
 10
thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile), physical soil parameters wil be recalculated depending on humus content
 11 thermal conductivity: Neusypina-approach; real soil surface temperature (additional to the soil profile)
 13 thermal conductivity: Campbell approach; real soil surface temperature (additional to the soil profile), physical soil parameters wil be recalculated depending on humus content
 20 thermal conductivity: de Vries-approach; reading soil surface temperature after request, physical soil parameters wil be recalculated depending on humus content
 21 thermal conductivity: Neusypina-approach; reading soil surface temperature after request
 23 thermal conductivity: Campbell approach; reading soil surface temperature after request, physical soil parameters wil be recalculated depending on humus content
 30 thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile), daily correction factor and damping coefficient constant 1, physical soil parameters wil be recalculated depending on humus content
 31 thermal conductivity: Neusypina-approach; 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, physical soil parameters wil be recalculated depending on humus content
 40 thermal conductivity: de Vries-approach; real soil surface temperature (additional to the soil profile), no recalculation of physical soil parameters depending on humus content
 41 thermal conductivity: Neusypina-approach; 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; not recommended for long simulation periods (greater than 40 years)
 4 Penman / Monteith for each cohort; not recommended for long simulation periods (greater than 40 years)
 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 special files from the allocation, the NPP, and the light module
 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 dummy or identification of soil profile resp.  string line is always mandatory; in case of a sitefile with multiple soil profiles the identification of the soil profile is given here
 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 - N reduction of photosynthesis);
 in case of dummy file or file not found: internal calculation of RedN
 52  litfile  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, flag_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 dummy or identification of soil profile resp.  string line is always mandatory; in case of a sitefile with multiple soil profiles the identification of the soil profile is given here
 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.

Top

about 4C | news | 4C guide | theory | applications | publications | contact