vignettes/fate_tutorial_0_modelling_framework.Rmd
fate_tutorial_0_modelling_framework.Rmd
The whole area is divided in grid-cells in which an independent demographic model regulates the PFG life cycle. PFG abundances are structured by age into cohorts and each cohort is attributed to a height stratum according to the growth parameters.
Different submodels affect this cycle at various levels :
Interaction through light and/or soil resources regulates interactions between cohorts affecting germination, recruitment and survival.
Habitat suitability affects the recruitment and fecundity rates.
The seed dispersal
model makes FATE
spatially explicit by connecting
grid-cells.
It depends on the amount of seeds produced by mature plants and affects
each PFG’s seed bank in each cell.
Disturbances affect PFG survival and fecundity.
Only three age classes are considered : germinant, juvenile and mature.
The timestep is at the year level : seasonality is not included within each timestep, but communities go through 4 states :
Light and soil resources are proportional to the abundance of
the PFG community of the pixel. They are both converted into
qualitative classes (Low
,
Medium
or High
), for each height
stratum (concerning light) and for each PFG
(according to its tolerance, regarding soil). The response of each PFG
to each resource level is defined in function of age
(Germinant
, Immature
and Mature
),
in a semi-binary way for light (bottom right), and in a more
quantitative way for soil (bottom left).
Influence of environment (habitat suitability) :
DO_HABITAT_SUITABILITY
parameter in
GlobalParameter
file).Is the habitat suitable ? :
Each year (timestep), the values contained in each PFG habitat
suitability maps will be compared to a reference value :
1
)0
)Depending on the parameterisation chosen, (see
HABSUIT_OPTION
parameter in GlobalParameter
file), the reference value can be set in two different ways.
Lifespan & maturity :
\[\text{LifeSpan} *
\text{getEnvMort}()\]
\[\begin{align} \text{maturityTime} &= (\text{LifeSpan} - \text{Maturity}) * (1.0 - \text{getEnvGrowth}()) + \text{Maturity} \\ \text{maturityTime} &= ceil(\text{maturityTime}) \end{align}\]
If DO_HABITAT_SUITABILITY
model is NOT selected, or the
habitat is suitable, then \(\text{maturityTime} =
\text{Maturity}\).
Otherwise, it the habitat is NOT suitable, \(\text{maturityTime} = \text{LifeSpan}\),
which means there will be no fecundity, and then no seeds produced.
Carrying capacity (mature vs immature) :
IMM_SIZE
parameter in Succession
files).MAX_ABUNDANCE
parameter in Succession
files). It is converted to abundance-related values when contributing to
structural equations (see MAX_ABUND_{...}
parameters in GlobalParameter
file).Germination :
\[\begin{align} \text{totAbund} &= \text{MatureAbund} &+ \text{ImmatureAbund} * \text{ImmSize} \\ \text{globalCC} &= \text{MaxAbund} &+ \text{MaxAbund} * \text{ImmSize}\\ &\text{if (totAbund} < \text{globalCC)} \\ &\{ \\ & ... \\ &\} \end{align}\]
ACTIVE_GERM
parameter in Light and Soil
files).DO_HABITAT_SUITABILITY
parameter in GlobalParameter
file), the habitat must be suitable, otherwise the recruitment will be
null.\[\begin{align} \text{RecruitmentRate} &= \text{GerminationRate} &* \text{ getEnvRecrRate}() \\ &= \text{AvailSeeds} * \text{MaxRecruitment} &* \text{ getEnvRecrRate}() \end{align}\]
Fecundity :
POTENTIAL_FECUNDITY
parameter in Succession
files). Due to lack of empirical data, this amount is often set at the
same value for all PFG.DO_HABITAT_SUITABILITY
parameter in GlobalParameter
file) (no seeds produced if the habitat is not suitable) :\[\text{Fecundity} = min(\text{MatureAbund}, \text{MaxAbund}) * \text{PotentialFecund} * \text{getEnvFecund}()\]
If \(\text{MatureAbund} \geqslant \text{MaxAbund}\), the PFG has reached its annual carrying capacity : it is in optimal conditions and will produce its maximum amount of seeds (\(\text{MaxAbund} * \text{PotentialFecund}\)). Otherwise, this amount will be reduced in proportion.
ANNUAL SEED CYCLE : (combining all previous information)
Germination occurs depending on the current abundance of the PFG inside the pixel : if it reaches the carrying capacity of the PFG = \(\text{MaxAbund} * (1 + \text{ImmSize})\), no seed germinates. The number of produced seeds is proportional to the current abundance of mature individuals only.