steps (version 1.0.0)

translocation: Translocate populations

Description

This function is used to move or introduce populations throughout a simulation. A user can specify which life-stages will be affected (default is all) and in which timesteps the translocations will take place. A warning will be generated if populations are not available where specified to translocate from.

Usage

translocation(
  origins_layer,
  destinations_layer,
  stages = NULL,
  effect_timesteps = 1
)

Arguments

origins_layer

the name of a spatial layer in the landscape object with the locations and number of individuals to translocate from. Note, this layer will have only zero values if individuals are being introduced from outside the study area

destinations_layer

the name of a spatial layer in the landscape object with the locations and number of individuals to translocate to. Note, this layer will have only zero values if individuals are being controlled (e.g. culling)

stages

which life-stages are modified - default is all

effect_timesteps

which timesteps in a single simulation do the translocations take place

Examples

# NOT RUN {
# Modify populations in all life-stages using explicit layers of origin and destination populations
# in timesteps 5, 10, and 15.

# }
# NOT RUN {
trans_pop <- translocation(origins_layer = "origins",
                           destinations_layer = "destinations",
                           stages = NULL,
                           effect_timesteps = c(5, 10, 15))

ls <- landscape(population = egk_pop,
                suitability = NULL,
                carrying_capacity = NULL,
                "origins" = egk_origins,
                "destinations" = egk_destinations)

pd <- population_dynamics(change = growth(egk_mat), modification = trans_pop)

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