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