used_synonyms: Retrieve synonyms or taxon concepts used in a data set

Description

Plots records are rather linked to plant names than plant taxon concepts. The function used_synonyms() provides a quick report about synonyms used in a data set (a vegtable object) and their respective accepted names.

Additionally, not all taxon concepts included in the taxonomic list (slot species) may be recorded in the plot observations. In that case the function used_concepts() will optimize the size of the taxonomic list by discarding taxa that are not "in use". Alternatively parents or children of these taxa may be included in the output data set.

Usage

used_synonyms(x, ...)
# S4 method for vegtable
used_synonyms(x, ...)
used_concepts(x, ...)
# S4 method for vegtable
used_concepts(x, keep_children = FALSE, keep_parents = FALSE, ...)

Value

The function used_synonyms() returns a data frame including following variables:

SynonymID: ID of the taxon usage name applied as synonym.
Synonym: The synonym itself.
SynonymAuthor: Author of synonym.
TaxonConceptID: ID of the respective taxon concept.
AcceptedNameID: ID of the taxon usage name set as accepted name of the taxon concept.
AcceptedName: The respective accepted name.
AcceptedNameAuthor: The author of the accepted name.

The function used_concepts() returns a taxlist object including only taxa occurring in the plot observations of the input vegtable

object.

Arguments

x: A vegtable object.
...: Further arguments to be passed from or to another methods.
keep_children: Argument passed to taxlist::get_children().
keep_parents: Argument passed to taxlist::get_parents().

Author

Miguel Alvarez kamapu78@gmail.com

Examples

Run this code

## Synonyms used in the Kenya_veg
Synonyms <- used_synonyms(Kenya_veg)
head(Synonyms)