Add bird nest traits (NestTrait) — add

Joins bird nest-site, nest-structure and nest-attachment indicators to a taxify() result by accepted_name. Each trait is a 0/1 presence flag; a species may carry several flags within a group.

Usage

add_nesttrait(x, cols = NULL, verbose = TRUE)

Arguments

x: A data.frame returned by taxify().
cols: Which columns to attach: NULL (default) the curated set, "all" every column the source carries, or a character vector of names. See enrichment_cols.
verbose: Logical. Default TRUE.

Value

The same data.frame with three collapsed categorical columns (nesttrait_structure, nesttrait_site, nesttrait_attachment, each a pipe-delimited set of modalities for multi-modal species) plus 20 raw 0/1 indicator columns prefixed nesttrait_: brood_parasite, mound_builder, seven nestsite_*, seven neststr_* and four nestatt_* flags.

Details

Source: NestTrait v2 (Chia et al. 2023, Scientific Data, CC-BY 4.0).

References

Chia SY et al. (2023) A global database of bird nest traits. Scientific Data. doi:10.1038/s41597-023-02837-1

Examples

if (FALSE) { # \dontrun{
taxify("Turdus merula", backbone = "gbif") |>
  add_nesttrait()
} # }