user interface | user manual

Content of user manual

 

Description of input files

Simulation control file

Examples

Run option 1 - single run

Run option 1 - multi run

Run option 2

Run option 7

Run option 8

Run option 8 without name of climate scenarios

Run option 9

Run option 10

 

Run option 1 - single run

The following example configures a single simulation run from the year 1994 to 2001. The size of the patch is 3200 m².
The name of the site is site1, the output files are named as Testsite. Three output files are requested: Testsite_clim.out1 and Testsite_soil.out1 with annual values and Testsite_day.out1 with daily values (creation of names see Description of the output files).
The file with management instructions is located in the directory Dir1, all other files are located in a subdirectory (input) of the actual working directory. No deposition and no initialisation of litter pools are given.
The output files are written in the subdirectory output. The name and location of the output directory is mandatory, all other names are unrestricted.


1        ! Run option
1        ! repeat number
! *** simulation specifications **************************************
8        ! number of simulation years
1994  ! start year for simulation
3200. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
0        ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
1        ! initialization flag (flag_stand)
1        ! soil vegetation flag (flag_sveg) !!! new !!!
3        ! management flag (flag_mg)
0        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
3        ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
0        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1        ! Yearly output flag
clim
soil
end
1        ! Daily output flag
day
end
0        ! cohort output flag
end
0        ! summation output flag
! *** input files *****************************************************
input/species.par
Testsite
input/site1.cli
input/site1.sop
input/site1.soi
input/site1.ini
9999
input/site1.man
input/dummy.dep
input/site1.red
input/dummy.lit

 

Run option 1 - multi run

The following example configures a multi simulation run on three different sites from year 1980 to 2004. The size of the patch on each site is 1700 m², but it can be overwritten by the patch size given in the stand initialization files.
The name of the sites are site1, site2 and site3, the output files are named as site1, site2 and site3. The requested output files are only the *_soil.out* and *_veg.out* with annual values labeled as site1_soil.out1 and site1_veg.out1 for the results of the first run, site2_soil.out2 and site2_veg.out2 for the results of the second run and so on (creation of names see Description of the output files).
All files are located in a subdirectory (input) of the actual working directory. No initialisation of litter pools are given.
The model configuration controlled by setting the flags are the same for each run.
The output files are written in the subdirectory output. The name and location of the output directory is mandatory, all other names are unrestricted.


1        ! Run option
3        ! repeat number
! *** simulation specifications **************************************
25      ! number of simulation years
1980 ! start year for simulation
1700. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
0        ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
1        ! initialization flag (flag_stand)
1        ! soil vegetation flag (flag_sveg) !!! new !!!
3        ! management flag (flag_mg)
0        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
3        ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
1        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1        ! Yearly output flag
soil
veg
end
0        ! Daily output flag
end
0        ! cohort output flag
end
0        ! summation output flag
! *** input files *****************************************************
input/species.par
site1
input/site1.cli
input/site1.sop
input/site1.soi
input/site1.ini
9999
input/site1.man
input/dummy.dep
input/site1.red
input/dummy.lit
! ******* run 2 ****************************************************
-99.0   end
input/species.par
site2
input/site2.cli
input/site2.sop
input/site2.soi
input/site2.ini
9999
input/site2.man
input/site2.dep
input/site2.red
input/dummy.lit
! ******* run 3 ****************************************************
-99.0   end
input/species.par
site3
input/site3.cli
input/site3.sop
input/site3.soi
input/site3.ini
9999
input/site3.man
input/site3.dep
input/site3.red
input/dummy.lit

Run option 2

The example is the simulation file for (1+3+2)*(1+2+2)= 30 runs of the climate sensitivity experiment. In this case the daily temperature is increased by 1°, 2°, 3° (3 runs) and reduced by 1° and 2° (2 runs) (plus an additional run with no change) and the precipitation is increased by 10 % and 20% (2 runs) and reduced by 10% and 20% (2 runs) (with an additional run with no change).

2       ! Run option
1        ! repeat number
! *** simulation specifications **************************************
8        ! number of simulation years
1994  ! start year for simulation
3200. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
0        ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
1        ! initialization flag (flag_stand)
1        ! soil vegetation flag (flag_sveg) !!! new !!!
3        ! management flag (flag_mg)
0        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
3        ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
0        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1        ! Yearly output flag
clim
soil
end
1        ! Daily output flag
day
end
0        ! cohort output flag
end
0        ! summation output flag
! *** input files *****************************************************
input/species.par
Testsite
input/site1.cli
input/site1.sop
input/site1.soi
input/site1.ini
9999
input/site1.man
input/dummy.dep
input/site1.red
input/dummy.lit
1 3 2
0.1 2 2

Run option 7

The example configures 3 simulation runs from the year 1996 to 2004. The size of the patch is 3500 m².
The first part of the name of all output files is testm. For each run two output files with annual values are requested: testmt1_c_bal.out1 and testmt1_veg_pi.out1, testmt2_c_bal.out2 and testmt2_veg_pi.out2, and so on (creation of names see Description of the output files).
The file with management instructions is located in the directory Dir1, all other files are located in a subdirectory (input) of the higher-level directory.
The output files are written in the subdirectory output of the actual working directory. The name and location of the output directory is mandatory, all other names are unrestricted

7        ! Run option
3        ! repeat number
! *** simulation specifications **************************************
9        ! number of simulation years
1996  ! start year for simulation
3500. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
15      ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
0        ! initialization flag (flag_stand)
0        ! soil vegetation flag (flag_sveg) !!! new !!!
8        ! management flag (flag_mg)
1        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
10      ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1 ! Yearly output flag (time_out)
c_bal
veg_pi
end
0 ! Daily output flag (flag_dayout)
end
0 ! cohort output flag (flag_cohout)
end
0 ! summation output flag (flag_sum)
! *** input files *****************************************************
../input/species_neu.par
testm
../input/test_multi.con
../input/
../input/
../input/
C:/Dir1//input/
../input/
../input/
../input/

At the beginning of the site control file test_multi.con (located in the subdirectory input of the higher-level directory) you can write any number of comment lines starting with "!". The site control file contains all file names with information about climate, soil, tree initialization, management, N deposition, reduction factors, and litter initialization. In the case below only the management strategies are varied whereas the site conditions are the same for each run. No deposition and no initialisation of litter pools are given (dummy.dep, dummy.lit). The site_name is the second part of the name of the output file (see above).

! example: site control file, run option 7
! sitenum  site_name   climate_file   soil_file    tree_initial.   management  deposition    reduction   litter_initialization
     1                t1          test7.cli     test7.sop    test.ini           test1.man    dummy.dep   test7.red   dummy.lit
     2                t2          test7.cli     test7.sop    test.ini           test2.man    dummy.dep   test7.red   dummy.lit
     3                t3          test7.cli     test7.sop    test.ini           test3.man    dummy.dep   test7.red   dummy.lit

 

Run option 8

This example configures a multi simulation run from the year 1982 to 2003 at 12 sites. The size of the patch is 10000 m².
The output files are named as multi. Three output files with annual values are requested:multi_soil.out1 multi_clim.out1 and multi_veg_pt.out1 (creation of names see Description of the output files).
The files with climate data are located in the directory s:\/tp1klima/deubasz5106_dez09, the file with the soil information of all sites (named buek.sod) is located in the directory j:\/4C/4C_input/soil, all other files are located in a subdirectory (input) of the of the higher-level directory.
The output files are written in the subdirectory output of the actual working directory. The name and location of the output directory is mandatory, all other names are unrestricted.


8        ! Run option
12      ! repeat number
! *** simulation specifications **************************************
22      ! number of simulation years
1982 ! start year for simulation
10000. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
15      ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
0        ! initialization flag (flag_stand)
0        ! soil vegetation flag (flag_sveg) !!! new !!!
8        ! management flag (flag_mg)
1        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
10      ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1 ! Yearly output flag (time_out)
soil
clim
veg_pt
end
0 ! Daily output flag (flag_dayout)
end
0 ! cohort output flag (flag_cohout)
end
0 ! summation output flag (flag_sum)
! *** input files *****************************************************
../input/species.par
multi
../input/oewk_all.ini
../input/aspen5.man
../input/bvvg_auswahl_2.con
../input/clim_brd_all.dat
s:\/tp1klima/deubasz5106_dez09/
j:\/4C/4C_input/soil/buek.sod
basz
DEU
perc
temp
end

 

See another example with run option 8.

 

Run option 8 without name of climate scenarios

Analogous to example 4 this example configures a multi simulation run from the year 1982 to 2003 at 12 sites. The size of the patch is 10000 m². The output files are named as multi. Three output files with annual values are requested:multi_soil.out1 multi_clim.out1 and multi_veg_pt.out1 (creation of names see Description of the output files).
The files with climate data are located in the directory s:\/Klimafolgenonline\klima_Cordex_i2c\rcp85stars, the name of the climate scenarios will be generated as follows:

             <pathdir1>/<climate_station>.<app>

In contrast to example 4 the line "climszen" is empty; that means: an empty line is necessary without any blanks.
The file with the soil information of all sites (named buek.sod) is located in the directory j:\/4C/4C_input/soil, all other files are located in a subdirectory (input) of the of the higher-level directory.
The output files are written in the subdirectory output of the actual working directory. The name and location of the output directory is mandatory, all other names are unrestricted.


8        ! Run option
12      ! repeat number
! *** simulation specifications **************************************
22      ! number of simulation years
1982 ! start year for simulation
10000. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
15      ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
0        ! initialization flag (flag_stand)
0        ! soil vegetation flag (flag_sveg) !!! new !!!
8        ! management flag (flag_mg)
1        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
10      ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
1 ! Yearly output flag (time_out)
soil
clim
veg_pt
end
0 ! Daily output flag (flag_dayout)
end
0 ! cohort output flag (flag_cohout)
end
0 ! summation output flag (flag_sum)
! *** input files *****************************************************
../input/species.par
multi
../input/oewk_all.ini
../input/aspen5.man
../input/bvvg_auswahl_2.con
../input/clim_brd_all.dat
s:\/Klimafolgenonline/klima_Cordex_i2c/rcp85stars/
j:\/4C/4C_input/soil/buek.sod

DEU
perc
temp
end

 

 

Run option 9

This example configures a multi simulation run from the year 2015 to 2049. The size of the patch is 10000 m².
The output files are named as oewk. No yearly output files are requested.
The files with climate data are located in the directory s:\/tp1klima/star05k and its subdirectories clim_0760_05, clim_0760_10, clim_0760_25 (denoting the 0.5K, 1.0K, and 2.5K scenarios). The first ten realisations of the climate scenarios were selected, so that one single climate data file of the climate station 18105 for the 1.0K scenario and the 5. realisation can be found as s:\/tp1klima/star05k/clim_0760_10/real_5/18105simsz.dat
All other files are located in a subdirectory (input) of the actual working directory.
The output files are written in the subdirectory output, the name and location of the output directory is mandatory.


9        ! Run option
35      ! repeat number
! *** simulation specifications **************************************
40      ! number of simulation years
2015  ! start year for simulation
10000. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
15      ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
0        ! initialization flag (flag_stand)
0        ! soil vegetation flag (flag_sveg) !!! new !!!
8        ! management flag (flag_mg)
1        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
10      ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
0 ! Yearly output flag (time_out)
end
0 ! Daily output flag (flag_dayout)
end
0 ! cohort output flag (flag_cohout)
end
0 ! summation output flag (flag_sum)
! *** input files *****************************************************
../input/species.par
oewk
../input/oewk_all.ini
../input/aspen5.man
../input/bvvg_auswahl.con
../input/clim_brd_all.dat
s:\/tp1klima/star05k/clim_0760_
../input/oewk_mv.sod
simsz
05 10 25
10
perc
ctot
prec
temp
end

 

Run option 10

This example is the same as example 5. It configures a multi simulation run from the year 2015 to 2049.. The size of the patch is 10000 m².
The output files are named as rcp. No yearly output files are requested.
The difference between exmaple 5 and example 6 is the choose of the climate scenarios. The climate scenarios derived from the RCP scenario don't need any identification of the levels of climate scenarios and therefore information in line 51 of the simulation file is not used, but the line is mandatory with optional charcters. In this example "dummy" is used. The directory is daten_sim_2011-2100 and is located like the other files in a subdirectory (input) of the actual working directory.
The output files are written in the subdirectory output. The name and location of the output directory is mandatory.


10        ! Run option
35      ! repeat number
! *** simulation specifications **************************************
40      ! number of simulation years
2015  ! start year for simulation
10000. ! patch size [m²]
50.0   ! thickness of foliage layers [cm]
7        ! time step photosynthesis calculations [d]
! *** choice of model options *****************************************
1        ! mortality flag (flag_mort)
15      ! regeneration flag (flag_reg)
0        ! use FORSKA environmental factors and regeneration (flag_forska)
0        ! initialization flag (flag_stand)
0        ! soil vegetation flag (flag_sveg) !!! new !!!
8        ! management flag (flag_mg)
1        ! disturbance flag (flag_dis)
4        ! ligth algorithm number (flag_light)
1        ! foliage-height relationship (flag_folhei)
1        ! volume function (flag_volfunc)
0        ! respiration flag (flag_resp)
10      ! limitation flag (flag_limi)
1        ! decomposition model (flag_decomp)
0        ! root activity function flag (flag_sign)
1        ! soil water uptake flag (flag_wred)
1        ! root distribution flag (flag_wurz)
0        ! heat conductance flag (flag_cond)
0        ! interception flag (flag_int)
2        ! evapotranspiration flag (flag_eva) 1
0        ! CO2 flag (flag_CO2)
0        ! assortment flag (flag_sort)
0        ! wpm flag (flag_wpm)
0        ! flag_stat
! *** output specifications *******************************************
0 ! Yearly output flag (time_out)
end
0 ! Daily output flag (flag_dayout)
end
0 ! cohort output flag (flag_cohout)
end
0 ! summation output flag (flag_sum)
! *** input files *****************************************************
../input/species.par
rcp
../input/oewk_all.ini
../input/aspen5.man
../input/bvvg_auswahl.con
../input/clim_brd_all.dat
../input/daten_sim_2011-2100
../input/oewk_mv.sod
simsz
dummy
10
perc
ctot
prec
temp
end

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