/
movement-behaviors.Rmd
47 lines (32 loc) · 3 KB
/
movement-behaviors.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
---
title: "Movement behaviors"
output: rmarkdown::html_vignette
vignette: >
%\VignetteIndexEntry{Movement behaviors}
%\VignetteEncoding{UTF-8}
%\VignetteEngine{knitr::rmarkdown}
editor_options:
chunk_output_type: console
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>"
)
```
```{r setup}
library(arrR)
```
## Movement behaviors
The **arrR** model allows to specify different movement behaviors for each model run.
Fish movement is simulated using a movement distance and direction. How these distance and directions are simulated for each individual depends on the type of movement.
If an individual moves outside the seafloor environment, it re-enters it on the opposite side ("torus translation").
### Random movement
A random distance is sampled from a log-normal distribution using `move_mean` and `move_sd` as mean and standard deviation, respectively. A random directions is sampled from uniform distribution (0° <= direction <= 360°).
### Attracted movement
A random distance is sampled from a log-normal distribution using `move_mean` and `move_sd` as mean and standard deviation, respectively. In contrast to random movement, fish individuals perceive the relative distance to the artificial reef cells in three fixed directions ahead of them (45° left, 0° straight and 45° right) and always move in the direction that is the shortest to an artificial reef cell.
### Behavioral movement
For the behavioral movement, movement types differ across individuals depending on their spatial location and energy reserves.
1) **Sheltering**: Individuals shelter at a reef cell if their reserves are above a threshold of their maximum reserves, set by `pop_reserves_thres`. They are considered to be "on the reef" if their distance to the closest reef cell is less than `move_border`. Individuals move randomly using a distance sampled from a log-normal distribution using `move_reef` as mean. During this behavior, individuals do not forage. If reserves are below the threshold, individuals switch to the foraging behavior. If individuals move away from the reef (by chance), they switch to the returning behavior.
2) **Returning**: If energy reserves are completely filled but they are not already sheltering, individuals move directly towards the reef using either a random distance sampled from a log-normal distribution using `move_return` or the distance to the closest reef cell (if this distance is shorter than `move_return`) as mean movement distance. The direction is the direct bearing towards the reef cell. During this behavior, individuals do not forage.
3) **Foraging**: Individuals move randomly (see "Random movement" above) and forage until their energy reserves are completely filled. However, the amount of nutrients that can be foraged each timestep is limited by `pop_reserves_consump`, which sets the maximum consumption amount relative to the maximum reserves. Once energy reserves are completely filled, they switch to sheltering or returning depending on their spatial location.