Description Usage Arguments Details Value Author(s) See Also Examples
View source: R/PRE_FATE.params_PFGsuccession.R
This script is designed to create parameter files containing
succession parameters for each PFG (one file for each of them) used in the
core module of FATE
.
1 2 3 4 5 6 7 | PRE_FATE.params_PFGsuccession(
name.simulation,
mat.PFG.succ,
strata.limits = c(0, 20, 50, 150, 400, 1000, 2000, 5000, 10000),
strata.limits_reduce = TRUE,
opt.folder.name = NULL
)
|
name.simulation |
a |
mat.PFG.succ |
a |
strata.limits |
a |
strata.limits_reduce |
default |
opt.folder.name |
(optional) |
The core module of FATE
allows the user to simulate a
primary vegetation succession based on a demography model.
Several parameters, given within mat.PFG.succ
, are required for
each PFG in order to set up this life cycle :
or life-form, based on Raunkier.
It should be either
H
(herbaceous), C
(chamaephyte) or P
(phanerophyte)
for now
the maximum or average height that reach the PFG
the age from which the PFG can reproduce
the maximum or average lifespan of the PFG
the maximum abundance of mature PFG in favorable conditions
the maximum number of seeds produced by the PFG
the relative size of immature versus mature plants
if the PFG is to be considered as an alien
(1
) or not (0
)
how easily the PFG burns
These values will allow to calculate or define a set of characteristics for all PFG :
= height values that define each stratum.
Two methods to define these limits are available :
from predefined rules (using strata.limits_reduce
= TRUE
, strata.limits
, height
) :
limits should go exponentially and are selected among
strata.limits
PFG are separated according to these strata.limits
and
then grouped making sure to have
\text{number of PFG per stratum} ≥q √{\text{total number of PFG}} - 2
to try to homogenize the number of PFG within each stratum.
from user data : (using strata.limits_reduce =
FALSE
)
with the values contained within the strata.limits
column, if provided
and a set of characteristics for each PFG :
= maximum stratum that each PFG can reach
= maximum abundance of mature PFG in favorable
conditions
= It can be seen as a proxy of maximum carrying capacity for mature
individuals
(and therefore as a proxy a quantity of shade
produced as well, if the light module is activated).
Two methods to define these abundances are available :
from predefined rules (using type
,
MAX_STRATUM
) :
MAX_STRATUM | 1 | 2 | 3 | + |
H (herbaceous) | 1 | 1 |
2 | 2 |
C (chamaephyte) | 1 | 2 |
2 | 3 |
P (phanerophyte) | 1 | 2 |
3 | 3
|
from user data :
with the values contained within the max_abundance
column, if provided
= relative size of immature versus mature plants
= for example, immature herbaceous take as much space as mature
herbaceous, while immature phanerophytes take less space (and
contribute to shade half less) than mature individuals
Two methods to define these sizes are available :
from predefined rules (using type
, MAX_STRATUM
)
:
MAX_STRATUM | 1 | 2 | 3 | + |
H (herbaceous) | 100% | 80%
| 50% | 50% |
C (chamaephyte) | 100% | 50%
| 50% | 50% |
P (phanerophyte) | 50% | 50%
| 50% | 10%
|
from user data :
with the values contained within the immature_size
column, if provided
= at what age each PFG goes into the upper stratum
It is defined using a logistic growth curve with 2 points to
parameterize it :
at age = \text{maturity}/2, height = \text{IMM_SIZE} * \text{height}
at age = \text{longevity}, height = \text{height}
= maximum number of seeds produced by the PFG
Two methods to define this number are available :
from predefined rules : same value for all PFG
(100%
)
from user data :
with the values contained within the potential_fecundity
column, if provided
= if the PFG is to be considered as an alien (1
) or
not (0
)
= how easily the PFG burns
A .txt
file per PFG into the
‘name.simulation/DATA/PFGS/SUCC/’ directory with the following
parameters :
name of the PFG
PFG life-form (H
: herbaceous C
:
chamaephyte P
: phanerophyte)
PFG maximum height (in cm)
PFG maturity age (in years)
PFG life span (in years)
maximum height stratum that the PFG can reach
maximum abundance / space (qualitative) that the PFG
is able to produce / occupy
(1
: Low 2
: Medium
3
: High)
PFG immature relative size (from 0
to
10
, corresponding to 0 to 100%)
ages at which the PFG goes in the upper stratum
(in years, put a value higher than the PFG life span if it is
not supposed to rise a stratum)
maximum number of years seeds are able to survive (for active and dormant pool)
are the seeds dormant or not (0
: No
1
: Yes)
maximum number of seeds produced by the
PFG
(set by default to 100
)
is the PFG an alien or not (0
: No 1
:
Yes)
how easily the PFG burns (numeric
)
A ‘SUCC_COMPLETE_TABLE.csv’ file summarizing information for all
groups into the ‘name.simulation/DATA/PFGS/’ directory.
This file can be used to parameterize the disturbance files (see
PRE_FATE.params_PFGdisturbance
).
If the opt.folder.name
has been used, the files will be into the
folder ‘name.simulation/DATA/PFGS/SUCC/opt.folder.name/’.
Maya Guéguen
PRE_FATE.skeletonDirectory
,
PRE_FATE.params_globalParameters
,
PRE_FATE.params_PFGdisturbance
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | ## Create a skeleton folder with the default name ('FATE_simulation')
PRE_FATE.skeletonDirectory()
## Create PFG succession parameter files
PRE_FATE.params_PFGsuccession(name.simulation = "FATE_simulation"
, mat.PFG.succ = data.frame(PFG = paste0("PFG", 1:6)
, type = c("C", "C", "H", "H", "P", "P")
, height = c(10, 250, 36, 68, 1250, 550)
, maturity = c(5, 5, 3, 3, 8, 9)
, longevity = c(12, 200, 25, 4, 110, 70)))
## Create PFG succession parameter files
PRE_FATE.params_PFGsuccession(name.simulation = "FATE_simulation"
, mat.PFG.succ = data.frame(PFG = paste0("PFG", 1:6)
, type = c("C", "C", "H", "H", "P", "P")
, height = c(10, 250, 36, 68, 1250, 550)
, maturity = c(5, 5, 3, 3, 8, 9)
, longevity = c(12, 200, 25, 4, 110, 70)
, immature_size = c(10, 8, 10, 10, 1, 5)))
## ----------------------------------------------------------------------------------------- ##
## Load example data
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.