pop_generate: Simulate body masses for a population

In diazrenata/birdsize: Estimate Avian Body Size Distributions

Simulate body masses for a population

Description

Draws body mass measurements for a population of birds (of all the same species) given the population size and either (1) the species AOU or (2) the mean and potentially standard deviation of body mass for that species.

Usage

pop_generate(
  abundance = NA_integer_,
  AOU = NA_integer_,
  scientific_name = NA_character_,
  mean_size = NA_real_,
  sd_size = NA_real_,
  sim_species_id = 1
)

Arguments

abundance	integer number of individuals to draw. Required.
AOU	the numeric AOU code used for this species in the Breeding Bird Survey
scientific_name	as "Genus species"
mean_size	numeric, mean body mass (in grams) for this species.
sd_size	numeric, standard deviation of body mass for this species.
sim_species_id	defaults AOU or 1

Details

abundance is required, as well as one of: AOU, scientific_name, or mean_size.

Value

a dataframe with abundance rows - one record per individual - and columns for species attributes.

Specifically:

• AOU: the AOU, if provided

• sim_species_id: the sim_species_id if provided

• scientific_name: the scientific name if provided

• individual_mass: the simulated body mass (in grams) for this individual

• individual_bmr: the simulated basal metabolic rate for this individual

• mean_size: the mean body mass for this species (i.e. the parameter used for simulation)

• sd_size: the standard deviation of body mass for this species (i.e. the parameter used for simulation)

• abundance: the number of individuals simulated of this species (i.e. parameter used for simulation)

• sd_method: the method for finding the standard deviation for body mass for this species

Examples

pop_generate(abundance = 5, AOU = 2881)
pop_generate(abundance = 5, scientific_name = "Selasphorus calliope")
pop_generate(abundance = 5, mean_size = 20, sd_size = 3)

diazrenata/birdsize documentation built on Jan. 29, 2024, 12:25 p.m.