Skip to contents

Simulate fish tracks with correlated random walks and detection events (ROBUST)

Source: R/1.6_function_walks_detections.R
simulate_fish_tracks.Rd

Automatically detects column names and optimizes for speed.

Usage

simulate_fish_tracks(
  raster,
  station_distances,
  n_paths = 1,
  n_steps = 100,
  step_length_mean = NULL,
  step_length_sd = NULL,
  turning_angle_mean = NULL,
  turning_angle_sd = NULL,
  time_step = 60,
  start_locations = NULL,
  start_time = as.POSIXct("2025-07-01 08:00:00", tz = "America/Toronto"),
  seed = NULL,
  station_info = NULL,
  temporal_info = NULL,
  de_model = NULL,
  species = NULL,
  fish_size_cm = NULL,
  species_params = NULL,
  temperature_data = NULL,
  behavioral_states = NULL,
  spawning_behavior = FALSE
)

Arguments

raster

A RasterLayer object defining the study area boundaries.

station_distances

Data frame with receiver detection probabilities.

n_paths

Integer. Number of fish paths to simulate. Default is 1.

n_steps

Integer. Number of steps per path. Default is 100.

step_length_mean

Numeric. Mean step length in map units. Default is 50.

step_length_sd

Numeric. Standard deviation of step length. Default is 20.

turning_angle_mean

Numeric. Mean turning angle in degrees. Default is 0.

turning_angle_sd

Numeric. Standard deviation of turning angle in degrees. Default is 45.

time_step

Numeric. Time between steps in seconds. Default is 60.

start_locations

Matrix or data frame with x,y coordinates for starting locations. Default is NULL.

start_time

POSIXct object for simulation start time. Default is July 1, 2025 08:00:00 EST.

seed

Numeric. Random seed for reproducible results. Default is NULL.

station_info

Data frame with station deployment information including start/end dates. Default is NULL.

temporal_info

Data frame with daily environmental conditions. Default is NULL.

de_model

Model object for predicting detection efficiency based on temporal conditions. Default is NULL.

species

Character. Species name for preset movement parameters ("Walleye", "Smallmouth Bass", "Muskellunge"). Default is NULL.

fish_size_cm

Numeric. Fish length in centimeters for size-scaled movement parameters. Default is NULL.

species_params

Data frame with custom species movement parameters. Default is NULL.

temperature_data

Data frame with daily temperature data. Default is NULL.

behavioral_states

Logical. Whether to use 3-state behavioral model (cruise/search/rest). Default is TRUE when species specified.

spawning_behavior

Logical. Whether to enable spawning behavior modifications. Default is FALSE.

Value

A list containing tracks and station_detections data frames.