dietSummaryByPrey: Summarize the importance of a single prey item across bird...

Description Usage Arguments Examples

View source: R/dietSummaryByPrey.r

Description

This function provides a summary of quantitative diet data for a given prey type

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
dietSummaryByPrey(
  preyName,
  preyLevel,
  preyStage = "any",
  dietType = NULL,
  season = NULL,
  region = NULL,
  yearRange = c(1700, 2100),
  speciesMean = FALSE,
  db = NULL
)

Arguments

preyName

scientific name of prey item to summarize, which may be at any taxonomic level denoted by preyLevel

preyLevel

taxonomic level of prey; possibile values include 'Kingdom', 'Phylum', 'Class', 'Order', 'Family', 'Genus', or 'Species'

preyStage

defaults to 'any'; one can alternatively specify 'adult', 'larva', or 'pupa' to narrow summary results to those that match these specific life stages

dietType

the way in which diet data were quantified; possible values include percent by 'Items', 'Wt_or_Vol' (weight or volume), or 'Occurrence'; defaults to NULL, in which case summaries will be provided for each Diet_Type for which data exist.

season

the season for which a diet summary should be conducted; possible values include 'spring', 'summer', 'fall', 'winter', or 'any'; defaults to 'any'.

region

the region for which a diet summary should be conducted; typically these are US or Mexican state or Canadian province names; by default all regions will be included.

yearRange

a vector specifying the minimum and maximum years over which a diet summary should be conducted; by default all years will be included.

speciesMean

logical value indicating whether to average across all regions, years and seasons to yield a single diet value per bird species-Diet_Type combination; default is FALSE in which case all diet analyses in which the prey taxon appears will be listed separately.

db

used to specify an alternative Diet Database object, mainly for testing; the default results in the main 'dietdb' data object being used.

Examples

1
dietSummaryByPrey("Lepidoptera", preyLevel = "Order", larvaOnly = TRUE, dietType = "Items", season = "spring")

ahhurlbert/aviandietdb documentation built on Oct. 12, 2021, 5:20 p.m.