population_dynamics: Define population dynamics.

In steps-dev/steps: Spatially- and Temporally-Explicit Population Simulator

Define population dynamics.

Description

A population_dynamics object is used to describe how populations change in space and time.

Usage

population_dynamics(
  change = NULL,
  dispersal = NULL,
  modification = NULL,
  density_dependence = NULL,
  dynamics_order = c("change", "dispersal", "modification", "density_dependence")
)

Arguments

change	population_change_functions to define how population growth occurs at each timestep
dispersal	population_dispersal_functions to define how the population disperses at each timestep
modification	population_modification_functions to define any deterministic changes to the population - such as translocations or population control - at each timestep
density_dependence	population_density_dependence_functions to control density dependence effects on the population at each timestep
dynamics_order	the order in which the population dynamics should be executed on the landscape object - default is "change" -> "dispersal" -> "modification" -> "density_dependence". Note, if population dynamics are reordered, all dynamics must be listed in dynamics_order.

Details

A population_dynamics object is passed to simulation and defines how populations change between timesteps. Note, some dynamics functions can be executed at non-regular intervals (i.e. only timesteps explicitly defined by the user). The population_dynamics function is used to construct an object with several population dynamics functions and their associated parameters. These functions specify how the population in the landscape object will be modified throughout a simulation. The dynamics can be executed in any order that is specified by the user. It is cautioned that the order of dynamics will have implications depending on whether the user has assumed a post-breeding or pre-breeding census in the transition matrix. For more information on this, please refer to Kendall et al, (2019) Ecological Applications.

Value

An object of class population_dynamics

Examples

# Example of setting up population dynamics to only use a population change function.

## Not run: 
ls <- landscape(population = egk_pop, suitability = NULL, carrying_capacity = NULL)

pd <- population_dynamics(change = growth(egk_mat))

simulation(landscape = ls, population_dynamics = pd, habitat_dynamics = NULL, timesteps = 20)

## End(Not run)

steps-dev/steps documentation built on Dec. 9, 2023, 10:51 p.m.