user interface | user manual

Content of user manual

 

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 with parameter choice (not complete!)



 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
      16 planting of Aleppo pine 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
      10 drought and nitrogen limitation; no N-limitation at 120 kg/ha anorganic N, under it decrease depending on N demand and N mineralisation
 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
      10 like 0; N uptake distribution controlled by N-supply of cohorts
      11 like 1; N uptake distribution controlled by N-supply of cohorts
 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: Jackson approach
       2 input of root profile after request; unchanged during the simulation time
       3 root profile: Arora approach
       4 root profile: TRAP model
       5 Jackson approach with root depth following Arora
       6 Jackson approach with root depth depending on water shortage
 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
 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

 

Multi run option 1
Bei der Auswahl Multi run(run option 1) ist die Ausführung mehrerer Simulationsläufe nacheinander bei gleicher Steuerungskonfiguration, aber variierenden Input-Dateien möglich.

Nach Auswahl der run option ist in der Steuerungsdatei zusätzlich die Anzahl der Simulationen anzugeben.

Entsprechend der Anzahl der Simulationen werden die kompletten Sätze der Input-Dateien , einschließlich Standortname und Bestandesnummer angegeben, d.h. durch die Informationen bis Zeile 49 wird der erste Lauf festgelegt, ab Zeile 50 wird der nächste Lauf festgelegt, wobei alle input-Files noch einmal angegeben werden müssen. Alle flags gelten weiterhin, sofern sie nicht durch explizite Auswahl überschrieben werden.
                         Achtung: es gilt immer die zuletzt erzeugte Konstellation !!!  

Intern werden die Filenamen in entsprechenden Feldern gespeichert und beim Start eines neuen Simulationslaufs komplett neu eingelesen. Damit kann diese Option sowohl zur Simulation an verschiedenen Standorten als auch zur Sensitivitätsanalyse genutzt werden, indem im letzteren Fall für gleichbleibende Standort-Daten die Dateien mit den Spezies-Parametern oder die Steuer-flags geändert werden.

Für jeden Simulationslauf wird der ausgewählte Satz von Ausgabe-Dateien erzeugt, der aus dem für diesen Lauf angegebenen Standortnamen und einer Numerierung nach dem Appendix out bzw. res generiert wird (s. 3. Ausgabedateien).

Multi run option 4
Bei der Auswahl option 4  ist die Ausführung  mehrerer Simulationsläufe bei gleicher Steuerkonfiguration möglich,  siehe Beispiel für Simulatrion der ÖWK-Punkte Brandenburg.
Erläuterung des Beispiels:

  • Die zu simulierenden Flächen sind in der Datei *.con angeführt mit einer ID, Klima-ID und Boden-ID:  Beispiel *.con
  • Die Initialisierung der Standorte erfolgt über die ID in der Initialisierungdatei *.ini
  • In der Datei *.cli ist eine Zuordnung aller Klima-ID zu longitude, lattitude, Höhe und Name des Szenarium (ersten 3 Buchstaben) gegeben:  Beispiel *.cli
  • nach der Angabe der Datei *.cli ist die Angabe des Verzeichnisses notwendig, in dem die Klimaszenarien (zeitreihen) stehen, sowie
  • die Angabe des Verzeichnisses, in dem die Bodendaten stehen, die in diesem Beispiel den Namen wbuekBoden_id.soi bzw. wbuekBoden_id.sop haben.
  • in der letzten Zeile steht der Name des Klimaszenarios, der zur Generierung der Namen der einzelnen Stationen benötigt wird


Multi run option 7
Mehrere Simulationsläufe werden durch eine datei *.con gesteuert, für alle runs werden identische Bodeninitialisierungen verwendet.
Bespiel (sim-file):

  • Die zu simulierenden Flächen sind in der Datei *.con angeführt mit einer Kurzbezeichung, dem Klimafile, dem management-flie, dem Initialiserungsfile,   Beispiel *.con

 


Ä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 !

 

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