comsimitv
package
During simulations seed production depends on the competition for
resources within (sub)-communities. First strength of competition (α) is calculated for each pair of
co-occurring individuals from the trait values related to resource use
by competition kernels specified in competition.kernel
parameter of comm.simul
function. Then the matrix of
pairwise competition coefficient are used in function specified by
fSeedProduction
parameter. This vignette shows the
available symmetric (where αij = αji)
and asymmetric (where αij ≠ αji
if i ≠ j) kernels,
and SeedProduction
function that recently the only
available function in the package for this purpose.
Recently the only available symmetric competition kernel is the Gaussian one:
where Bi and Bj are the resource use related trait values of the two species, while σb determines how steeply decrease the strength of competition with increasing difference in resource use (Figure @ref(fig:gauss)).
For Bi = Bj, αij = 1 irrespectively to value of σb. If σb = 0 the strength of competition is zero any case of Bi ≠ Bj. If σb = ∞, αij = 1 for all species pairs.
Gaussian competition kernel can be used by setting
competition.kernel="Gaussian.competition,kernel"
(which is
the default value of this parameter). Value of σb has to be set
by parameter sigma.b
.
According to MacArthur & Levins (1967), this competition kernel can be deduced as overlap of Gaussian resource use curves. Their general formula for overlap is
where U is the resource use function, and x is the quality of the resource (e.g. seed size or rooting depth). Let both Ui and Uj be density function of normal (Gaussian) distribution with same standard deviation (σ), and let rescale x to be expected values equals to zero and d = Bi − Bj, respectively:
Since $x^2+(x-d)^2=2x^2+d^2-2xd=2\left(x-\frac{d}{2}\right)^2+\frac{d^2}{2}$
Note that σb in equation @ref(eq:eq1) equals to 2σ2 in equation @ref(eq:eq4)
Recently two types of asymmetric competition kernels are available
via asymmetric.competition.kernel
function:
Kisdi’s convex-concave function
smooth function suggested by Nattrass et al. (2012)
It is a function defined by equation (2) in Kisdi (1999), however the parametrization are slightly modyfied:
Contrary to the Gaussian competition kernel, It has three parameters
(C, v, σb) instead
of the only one parameter of Gaussian competition kernel. Note that in
the R function these parameters are called ac.C
,
ac.v
and sigma.b
, respectively. C and v have to be positive, while σb ≠ 0. Possible
values of the function ranges from zero to C. If σb > 0 it is
a decreasing sigmoid (convex-concave) function (Figure @ref(fig:kisdi1))
of trait difference (Bi − Bj)
with inflection point at Bi − Bj = σbln v
, where the strength of competition is C/2 .
Strength of competition between functionally equivalent individulas (i.e. if Bi = Bj) is $\alpha_{ij}=C\left(\frac{v}{1+v}\right)$. If the other two parameter fixed, absolute value of parameter σb determines the steepness of the curve around its inflection point (Figure @ref(fig:fig3) ).
This is also a sigmoid function defined by a formula similar to Kisdi’s function:
It ranges from 1 − C to 1 + C. Position of its inflection point is Bi − Bj = 0, where its value is 1, irrespective to the parameter values. When its range (i.e. value of parameter C) is fixed, σb determines the steepness of the curve at the inflection point: lower σb results in steeper curve.
However equation @ref(eq:eq6) is not defined when sigmab = 0
and Bj = Bi,
following suggestion of Nattrass et al. (2012)
asymmetric.competition.kernel
function set the strength of
competition to 1 in this case.
SeedProduction
functionThis function calculates number of produced seeds for each
individual. The number of seeds is random number from Bernoulli (zero or
one seed) or Poisson distribution (unlimited number of seeds). The
expected value of produced seeds (irrespectively to the distribution)
for individual i
in local community k
depends
on the competition for resources:
Where: b0 is the maximum probability of reproduction in competition free conditions; K is level of competition above which probability of reproduction becomes zero; αij = competitive effect of individual j on individual i, calculated from resource acquisition traits by the competition kernel functions.