Settings for speciation in simulate_evolving_metacommunity(). Speciation is checked once
per generation (steps_per_generation of evolution_control()). A species buds when its
populations fall into two or more groups: the largest group (most sites, then most
individuals) keeps the identity and age of the species, and each other group becomes a new
species with its populations, abundances and genetic means. Several new species at once
branch off one after another, the most divergent first, at the same time (internal branches
of length zero), so that the tree stays binary.
Usage
speciation_control(
mode = c("geographic", "ecological", "point", "fission"),
threshold,
rate,
divergence = c("cluster", "gradual"),
migration_min = 0.005,
reset_generations = 10,
homogenization = 1,
min_generations = 20,
migration_max = 0.001,
partition = c("spatial", "random"),
jump_var = 0,
completion = 0,
completion_dist = c("fixed", "exponential")
)Arguments
- mode
"geographic","ecological","point"or"fission".- threshold
For
"geographic"and"ecological": divergence in generations, or difference of genetic means in units of the environment, that separates groups;Infturns speciation off. With several traits (one per niche axis), the difference of two populations in"ecological"is the Mahalanobis distance of their genetic means under the phenotypic matrix of the species, \(\sqrt{\Delta\bar z^\top P^{-1} \Delta\bar z}\), sothresholdis in units of phenotypic standard deviations.- rate
For
"point": probability per individual per generation; for"fission": rate per species per generation.- divergence
For
"geographic":"cluster"or"gradual".- migration_min
For
divergence = "cluster": migration rate per generation that links two populations. Where clusters form depends on dispersal, the kernel and abundances: the rate of the strongest link of each population should straddle it. In the design ofdata-raw/evolving_migration_min.R(strongest links with median 0.006), species did not split at all at 0.002 or below and split almost as with no links at 0.02 or above.- reset_generations
For
divergence = "cluster": generations in a row in the same cluster after which divergence returns to 0.- homogenization
For
divergence = "gradual": reduction of divergence per migrant.- min_generations
For
"ecological": generations in a row of difference and reduced gene flow before groups split.- migration_max
For
"ecological": migration rate per generation below which gene flow counts as reduced.- partition
For
"fission":"spatial"or"random".- jump_var
Variance of the shift of the genetic mean of each new species. With several traits, one value (independent shifts of that variance on every trait) or a covariance matrix with one row and column per trait (for instance proportional to \(G\)).
- completion
Time to complete speciation, in generations (fixed or mean); 0 for instantaneous speciation.
- completion_dist
"fixed"or"exponential".
Details
Four modes start new species (the initiation of Hubert et al. 2015):
"geographic": each pair of populations of a species has a divergence \(d\), in generations. Withdivergence = "cluster"(the default, close to gen3sis; Hagen et al. 2021), populations linked by a migration rate of at leastmigration_minform clusters (chains of links). \(d\) grows by 1 per generation between populations of different clusters; within a cluster it stays as it is, and returns to 0 only afterreset_generationsgenerations in a row in the same cluster, so that a single generation of contact does not erase a long isolation. Withdivergence = "gradual", \(d\) grows by 1 per generation and gene flow lowers it in proportion to the migrants exchanged: \(d \leftarrow \max(0, d + 1 - h M)\), with \(M\) the expected migrants between the two populations in the generation and \(h\) =homogenization. Populations are grouped by single linkage: two are in the same group when a chain of pairs with \(d <\)thresholdlinks them."ecological": each pair of populations counts the generations in a row in which their genetic means (evolution, with genetic variance) differ by at leastthresholdand their migration rate is belowmigration_max. Populations are grouped by single linkage on pairs whose count is belowmin_generations. Requiring the difference to last, with reduced gene flow, keeps drift and founder sampling in small populations from splitting species in a uniform environment."point": point mutation, the mode of neutral theory and of MESS (Overcast et al. 2021). Each individual becomes, with probabilityrateper generation, the first individual of a new species in its site. The mother keeps its populations, except where a mutant takes its last individual. Mutants arrive in the generation of their birth."fission": random fission. Each species with two or more populations splits with probability \(1 - e^{-\lambda}\) per generation (\(\lambda\) =rate). Withpartition = "spatial", the populations of the new group are those nearest (by the dispersal kernel) to a random occupied site, in a random number from 1 to all but one; with"random"(or on a spatially implicit landscape), each population joins it with probability 1/2, with at least one population on each side.
Gene flow between two populations \(a\) and \(b\) is measured by the migration rate, the larger of the expected migrants from one to the other in the generation over the size of the receiving population, so that it does not depend on abundance. A new population takes the divergences (or counts) of the population that sent it most migrants, and a population lost at any step of a generation founds anew.
New species take the genetic means of their populations; with jump_var > 0 their genetic
means (and the optimum of their regional pool) shift by one Gaussian draw with that variance
per new species, as in the punctuated change of MESS (Overcast et al. 2021).
Protracted speciation. With completion > 0, each new lineage is incipient until it
completes, after completion generations (completion_dist = "fixed") or after an
exponential time with that mean ("exponential", the rate \(\lambda_2\) of the
protracted birth-death model; Etienne & Rosindell 2012). Completion only changes what is
recognised as a species: incipient lineages are separate lineages in the dynamics. At the
end, a lineage that has completed is a good species, and an incipient lineage belongs to the
species its parent belonged to at its birth, as in the labels of the PBD. The reconstructed
tree has one tip per good species with extant lineages, represented by the good lineage
itself or, if it is extinct, by its earliest extant member. Its nodes are times of
initiation of lineages, which for a species whose lineages are not monophyletic may predate
the initiation of the species itself.
References
Etienne, R. S., & Rosindell, J. (2012). Prolonging the past counteracts the pull of the present: protracted speciation can explain observed slowdowns in diversification. Systematic Biology, 61, 204–213. doi:10.1093/sysbio/syr091
Hagen, O., Flück, B., Fopp, F., Cabral, J. S., Hartig, F., Pontarp, M., Rangel, T. F., & Pellissier, L. (2021). gen3sis: A general engine for eco-evolutionary simulations of the processes that shape Earth's biodiversity. PLOS Biology, 19, e3001340. doi:10.1371/journal.pbio.3001340
Hubert, N., Calcagno, V., Etienne, R. S., & Mouquet, N. (2015). Metacommunity speciation models and their implications for diversification theory. Ecology Letters, 18, 864–881. doi:10.1111/ele.12458
Overcast, I., Ruffley, M., Rosindell, J., Harmon, L., Borges, P. A. V., Emerson, B. C., Etienne, R. S., Gillespie, R., Krehenwinkel, H., Mahler, D. L., Massol, F., Parent, C. E., Patiño, J., Peter, B., Week, B., Wagner, C., Hickerson, M. J., & Rominger, A. (2021). A unified model of species abundance, genetic diversity, and functional diversity reveals the mechanisms structuring ecological communities. Molecular Ecology Resources, 21, 2782–2800. doi:10.1111/1755-0998.13514
See also
Other simulate metacommunities:
as_metacommunity(),
colonisation_history(),
evolution_control(),
genetic_matrices(),
growth_rates(),
logistic_gradients(),
maladaptation(),
mc_dynamics(),
persistence(),
range_history(),
simulate_evolving_metacommunity(),
simulate_logistic(),
simulate_metacommunity(),
simulate_static()
Examples
speciation_control("geographic", threshold = 50)
#> <mc_speciation> geographic | threshold = 50 | divergence: cluster | migration_min = 0.005 | reset_generations = 10
speciation_control("geographic", threshold = 50, divergence = "gradual", homogenization = 0.5)
#> <mc_speciation> geographic | threshold = 50 | divergence: gradual | homogenization = 0.5
speciation_control("ecological", threshold = 20, min_generations = 30)
#> <mc_speciation> ecological | threshold = 20 | min_generations = 30 | migration_max = 0.001
speciation_control("point", rate = 1e-4, completion = 50)
#> <mc_speciation> point | rate = 1e-04 | completion: fixed 50
speciation_control("fission", rate = 0.01, partition = "random")
#> <mc_speciation> fission | rate = 0.01 | partition: random
