sim_bcrw: Simulate Biased Correlated Random Walk (BCRW)

View source: R/fidelity_funs_simulate-bcrw.R

sim_bcrwR Documentation

Simulate Biased Correlated Random Walk (BCRW)

Description

Function to simulate a movement track under a Biased Correlated Random Walk model. Called as needed by simulate_tracks.

Usage

sim_bcrw(
  n_steps,
  sl_par,
  rho,
  start_loc,
  beta,
  prange,
  lands,
  neighbors,
  jitter,
  scenario_id = NA,
  lands_name = NA
)

Arguments

n_steps

Numeric. Number of steps to simulate

sl_par

Vector of length 2 containing the shape and scale of the step length distribution (Weibull)

rho

Numeric. Movement autocorrelation parameter

start_loc

Data frame with a single row containing coordinates of the starting location (columns x and y). 0, 0 if unprojected.

beta

Numeric. Value of bias

prange

Numeric. Perceptual range radius. Units match the units of the coordinates: m if UTM, degrees if lat/long.

lands

Raster of habitat quality.

neighbors

List of cell neighborhoods created by get_neighbors. #' @param jitter Logical. If TRUE, starting locations will be jittered by 20 km in any direction for spatially-explicit models (MCRW and BCRW).

scenario_id

Character string. Optional ID of the current scenario. Automatically assigned when using simulate_tracks().

lands_name

Path to the landscape file.

Value

Returns a data frame containing the coordinates of each location along the simulated track and the associated simulation parameter values as specified in create_scenarios_bcrw.


picardis/fidelity documentation built on Dec. 10, 2022, 6:16 a.m.