foraging.range: Predict foraging range for bees using intertegular distance...

View source: R/foraging.range.R

foraging.rangeR Documentation

Predict foraging range for bees using intertegular distance and degree of sociality

Description

Calculates realized (or potential) foraging range from Kendall et al. (2022) using intertegular distance (ITD) values and degree of sociality (highly eusocial, primitively eusocial or solitary).

Usage

foraging.range(
  data,
  model.type = "social",
  random.effects = "reduced",
  measure.type = "realized"
)

Arguments

data

A dataframe containing between two to four columns: bee intertegular distance (ITD) measurements in mm, species (Format: "Genus_species") and sociality (Format: "Highly Eusocial","Primitively Eusocial", "Solitary").

model.type

A string stating which model should be used: "social", for the model that includes sociality, body size (ITD) and measurement type, or "ITD", for the reduced model that only includes body size and measurement type.

random.effects

A sting stating if random effects are to be used using predictive purposes. Options are 1) phylogenetic effect and species effects "full", 2) only phylogenetic effect ("phylo"), or 3) fixed effects only ("reduced"). Default is "reduced".

measure.type

A string stating whether to return realized ("realized") or potential ("potential") estimates.

Value

A dataframe with bee foraging range (km) is returned for each bee species (row).

References

  • Kendall et al. (2022) The potential and realized foraging movements of bees are differentially determined by body size and sociality Ecology TBC.

Examples

ITD=c(2.9,2.9,2.9)
species=c("Apis_mellifera","Osmia_cornifrons","Bombus_bifarius")
sociality=c("Highly Eusocial","Solitary","Primitively Eusocial")
example.data <- data.frame(ITD,species,sociality)
foraging.range(example.data,random.effects = "full",measure.type = "realized")


liamkendall/pollimetry documentation built on April 28, 2023, 2:09 a.m.