check_species: Check scientific or vernacular name(s)

In inbo/camtraptor: Read, Explore and Visualize Camera Trap Data Packages

Check scientific or vernacular name(s)

Description

Checks if a given scientific or vernacular name(s) can be found in the metadata (package$taxonomic) and returns error if not.

Usage

check_species(
  package = NULL,
  species,
  arg_name = "species",
  datapkg = lifecycle::deprecated()
)

Arguments

package	Camera trap data package object, as returned by read_camtrap_dp().
species	Character vector with scientific or vernacular names.
arg_name	Character with argument name to return in error message Default: "species".
datapkg	Deprecated. Use package instead.

Value

A character vector with the correspondent scientific names.

Examples

# Species is a scientific name
check_species(mica, "Martes foina")

# Species is a vector of vernacular names
check_species(mica, c("beech marten", "european polecat"))

# Vernacular names can be specified in any language available
check_species(mica, c("vos", "blauwe reiger"))

# Vernacular names and scientific names can be mixed up
check_species(mica, c("beech marten", "blauwe reiger", "Anas strepera"))

# Case insensitive
check_species(mica, "AnaS StrePeRa")
check_species(mica, "bEEch mARteN")

## Not run: 
check_species(mica, "bad name")

## End(Not run)

inbo/camtraptor documentation built on June 2, 2025, 5:17 a.m.