Add scientific name and authorship to a tibble

Format the field scientificName, the lowest identified taxonomic name of an occurrence, along with the rank and authorship of the provided name.

Usage

use_scientific_name(
  .df,
  scientificName = NULL,
  scientificNameAuthorship = NULL,
  taxonRank = NULL,
  .keep = "unused"
)

Arguments

.df

a data.frame or tibble that the column should be appended to.

scientificName

The full scientific name in the lower level taxonomic rank that can be determined.

scientificNameAuthorship

The authorship information for scientificName.

taxonRank

The taxonomic rank of scientificName.

.keep

Control which columns from .data are retained in the output. Note that unlike dplyr::mutate(), which defaults to "all" this defaults to "unused"; i.e. only keeps Darwin Core fields, and not those fields used to generate them.

Value

A tibble with the requested fields added.

Details

Examples of scientificName values (we specify the rank in parentheses, but users should not include this information):

• Coleoptera (order)

• Vespertilionidae (family)

• Manis (genus)

• Ctenomys sociabilis (genus + specificEpithet)

• Ambystoma tigrinum diaboli (genus + specificEpithet + infraspecificEpithet)

Examples of scientificNameAuthorship:

• (Györfi, 1952)

• R. A. Graham

• (Martinovský) Tzvelev

Examples of taxonRank:

• order

• genus

• subspecies

• infraspecies

See also

use_taxonomy() for taxonomic name information.