get_endpoint_within: Predict within-habitat evolutionary endpoint

In rscherrer/speciomx: Adaptive Dynamics Approximation of the Speciome Model

Predict within-habitat evolutionary endpoint

Description

Predicts the evolutionary equilibrium reached given a starting point and some parameter values, and if this equilibrium is stable.

Usage

get_endpoint_within(
  xstart,
  pars,
  from = xstart - 10,
  to = xstart + 10,
  step = 1e-04,
  ...
)

Arguments

xstart	The starting resident trait value
pars	An unevaluated parameter-list (e.g. as returned by get_default_pars)
from, to	Arguments to be passed to find_singularities_within (only the bound towards which the initial selection gradient is pointing is considered)
step	Argument to be passed to is_convergent_within
...	Optional extra arguments for find_singularities_within

Details

The function computes the selection gradient at the starting point to know in which direction evolution is leading, then finds the closest singularity in that direction.

Value

A data frame with the singularity, whether it is attainable and whether it is evolutionarily stable. If a singularity is attainable and stable, it is an evolutionarily stable strategy (labelled "ESS"). If it is attainable and unstable, it is a branching point ("BP"). If it is unattainable, it is a repeller.

See Also

get_gradient_within, find_singularities_within, is_stable_within, is_convergent_within

Examples

pars <- get_default_pars()
get_endpoint_within(0, pars)

rscherrer/speciomx documentation built on March 28, 2023, 8:49 p.m.