Warning
This file is auto-generated from parameters.yaml. Do not edit it by hand!
Instead, edit parameters.yaml and regenerate this file with:
python scripts/parameters_table.py -o parameters.md
Spatial extent of the world and resolution of the tree grid
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
width |
World size in east-west direction. Must be a multiple of cell_size (technical) | 4000 m | 1000 – 100000 m | None, technical parameter |
height |
World size in north-south direction. Must be a multiple of cell_size (technical) | 3000 m | 1000 – 100000 m | None, technical parameter |
cell_size |
Cell size of the fine tree grid, holding at most one tree per cell (technical) | 10 m | 5 – 20 m | TODO |
Initializes trees and their damage and beetle colonization state
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
km2_probability |
Probability that a 1x1 km block is forested (scenario) | 0.6 | 0 – 1 | None, preliminary to generate heterogeneous landscapes |
tree_probability |
Probability that a fine grid cell within a forested block holds a tree (ecological) | 0.9 | 0 – 1 | TODO |
damage_prevalence |
Initial proportion of damaged trees (ecological) | 0.03 | 0 – 1 | TODO |
beetle_prevalence |
Initial proportion of damaged trees that are colonized by beetles (ecological) | 0.2 | 0 – 1 | TODO |
Updates model time
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
ticks_per_year |
Number of model ticks per year (technical) | 52 ticks / year | – | None, technical parameter |
Progression of nematode-infected trees to damaged state
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
ticks_to_damage |
Time from nematode infection of a tree until it becomes damaged (ecological) | 8 weeks | TODO | TODO |
Initial introduction of the nematode by infecting randomly selected trees anywhere in the world
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_infection |
Model tick at which the trees are infected (scenario) | 0 weeks | – | None, scenario parameter |
num_trees |
Number of trees to infect. Capped at the number of undamaged, uninfected trees (scenario) | 10 trees | – | None, scenario parameter |
Annual background damage of trees (by causes other than the nematode) and removal of damaged trees
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_year |
Week of the year when trees are damaged and removed (ecological) | 35 week | 0 – 51 week | TODO |
damage_probability |
Annual probability of an undamaged tree to become damaged (ecological) | 0.01 1 / year | 0 – 1 1 / year | TODO |
removal_probability |
Annual probability of a damaged tree to be removed (management) | 0.333 1 / year | 0 – 1 1 / year | TODO |
Annual emergence of nematode-carrying beetles from damaged, infected trees
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_year |
Week of the year when beetles emerge (ecological) | 19 week | 0 – 51 week | TODO |
beetles_per_tree |
Number of beetles emerging from each damaged, infected tree (ecological) | 5 beetles / tree | TODO | TODO |
life_expectancy |
Mean adult beetle life span (exponentially distributed). In Naves et al., 2006, mortality seems to be linear, with a maximum age of 120 days. However, this is a lab experiment. (ecological) | 5 weeks | TODO | TODO |
max_age |
Maximum adult beetle life span. Caps the exponentially distributed life span. In Naves et al., 2006, the maximum age in the lab was 120 days. (ecological) | 18 weeks | TODO | Naves et al., 2006 |
Attraction field of damaged trees, guiding beetles during egg laying
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_year |
Week of the year when the attraction field is calculated (technical) | 18 week | 0 – 51 week | None, technical parameter |
damaged_trees |
Whether this instance computes the attraction of damaged (true) or healthy (false) trees (technical) | true | – | None, technical parameter |
half_distance |
Distance at which a tree's attraction has decayed to half its value at the tree (ecological) | 50 m | TODO | TODO |
density_radius |
Radius within which neighboring damaged trees count towards a tree's local density. Must be a multiple of the fine cell size (ecological) | 20 m | TODO | TODO |
density_weight |
Exponent applied to a tree's local density to scale its attraction. 0 disables the density effect (ecological) | 1.0 | TODO | TODO |
Attraction field of healthy trees, guiding beetles during maturation feeding
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_year |
Week of the year when the attraction field is calculated (technical) | 18 week | 0 – 51 week | None, technical parameter |
damaged_trees |
Whether this instance computes the attraction of damaged (true) or healthy (false) trees (technical) | false | – | None, technical parameter |
half_distance |
Distance at which a tree's attraction has decayed to half its value at the tree (ecological) | 50 m | TODO | TODO |
density_radius |
Radius within which neighboring healthy trees count towards a tree's local density. Must be a multiple of the fine cell size (ecological) | 20 m | TODO | TODO |
density_weight |
Exponent applied to a tree's local density to scale its attraction. 0 disables the density effect (ecological) | 1.0 | TODO | TODO |
Movement of nematode-carrying beetles during maturation feeding and egg laying, towards the attraction source
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
steps_per_tick |
Number of movement steps (days) per week (ecological) | 7 steps / week | TODO | TODO |
distance_per_step |
Maximum flight distance per step, shared by leaving a tree and the directed flight towards the attraction source (ecological) | 2000 m / step | TODO | TODO |
duration_feeding |
Duration of the maturation feeding phase after emergence, during which beetles always target healthy trees (ecological) | 3 weeks | TODO | Naves et al., 2006 |
feeding_probability |
Per-step probability of a beetle after maturation feeding to feed (target healthy trees) rather than to lay eggs (target damaged trees) (ecological) | 0.5 1 / step | 0 – 1 1 / step | TODO |
leave_tree_probability |
Per-step probability of a beetle to leave the target tree it is on (ecological) | 0.25 1 / step | 0 – 1 1 / step | TODO |
emergence_flight_distance |
Maximum distance of the undirected flight in a beetle's first step after emergence. The actual distance is drawn uniformly between 0 and this value (ecological) | 100 m | TODO | TODO |
Annual background spread of beetles (without nematodes) to damaged trees, via a dispersal kernel
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
tick_of_year |
Week of the year when colonization takes place (ecological) | 20 week | 0 – 51 week | TODO |
cell_size |
Cell size of the dispersal grid (technical) | 100 m | TODO | None, technical parameter |
kernel_half_distance |
Distance at which the dispersal kernel's weight has decayed to half its value at the source cell (ecological) | 50 m | TODO | TODO |
kernel_radius |
Cutoff radius of the dispersal kernel. Rounded up to full cells (ecological) | 300 m | TODO | TODO |
beetles_per_tree |
Number of beetles emerging from each colonized tree per year (ecological) | 2.0 beetles / tree / year | TODO | TODO |
trees_per_beetle |
Mean number of damaged trees within a cell that an arriving beetle attempts to colonize (ecological) | 1.0 trees / beetle | TODO | TODO |
Infection of healthy trees by feeding, nematode-carrying beetles
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
infection_probability |
Probability of a tree to become infected per feeding step of a beetle on it (ecological) | 0.02 1 / step | 0 – 1 1 / step | TODO |
Stops the simulation after a fixed number of ticks
| Parameter | Description | Value | Range | Source |
|---|---|---|---|---|
steps |
Number of simulation ticks to run (technical) | 5200 weeks | – | None, technical parameter |
- Naves, P., De Sousa, E., & Quartau, J. A. (2006). Reproductive traits of Monochamus galloprovincialis (Coleoptera: Cerambycidae) under laboratory conditions. Bulletin of Entomological Research, 96(3), 289-294. https://doi.org/10.1079/BER2006422