Package 'taxnames'

Get or set a global taxonomy

Description

For convenience and to simplify the call of name formats, the containing object (a taxlist::taxlist object) will be handled internally by all functions.

A standard taxonomic list is already set in this package and can be retrieved or replaced.

The function set_style() sets the style for the formatted names (default "markdown") and the standard collapse connectors.

Usage

set_tax(tax)

## S3 method for class 'taxlist'
set_tax(tax)

get_tax()

set_style(style, collapse, secundum)

get_style()

Arguments

tax	A taxlist::taxlist object set as standard taxonomy.
style	A character value setting the format style. It is passed to the homonimous parameter in taxlist::print_name().
collapse	A character vector (lenght 1 or 2) setting the collapse connectors for multiple names. It is passed to the homonimous parameter in taxlist::print_name().
secundum	A character value indicating the name of the colum in slot taxonViews of the internal object, which will be used to indicate the respective taxon view.

Value

get_tax() returns an object of class taxlist::taxlist, while get_style() returns a list with options set for the session.

Examples

## Get the current taxonomy
get_tax()

## Get further settings
get_style()

---

Standard formats for accepted names

Description

Inserting formatted taxonomic names in documents require specific functions for every format, which are provided here.

These functions print only accepted names for the selected taxon concepts.

Suffixes in the function names are explained as follows:

• fn: Full name without author name.

• fna: Full name with author name.

• fnas: Full name with author name and taxon view (secundum).

• an: Abbreviated name without author name.

• ana: Abbreviated name with author name.

Usage

tn_fn(x, ...)

tn_fna(x, ...)

tn_fnas(x, ...)

tn_an(x, ...)

tn_ana(x, ...)

Arguments

x	A vector containing selected identifiers for taxon concepts (TaxonConceptID) included in the internal taxonomic object (see set_tax()).
...	Further arguments passed to taxlist::print_name().

Value

All these functions return a character value.

Examples

## Compare all these outputs
tn_fn(13)
tn_fna(13)
tn_fnas(13)
tn_an(13)
tn_ana(13)

---

Standard formats for taxonomic names

Description

These functions work similarly to tn_an() and its alies but the names are accessed by their TaxonUsageID and work also for synonyms.

Suffixes in the function names are explained as follows:

• fun: Full usage name without author name.

• funa: Full usage name with author name.

• aun: Abbreviated usage name without author name.

• auna: Abbreviated usage name with author name.

Usage

tn_fun(x, ...)

tn_funa(x, ...)

tn_aun(x, ...)

tn_auna(x, ...)

Arguments

x	A vector containing selected identifiers for taxon names (TaxonUsageID) included in the internal taxonomic object (see set_tax()).
...	Further arguments passed to taxlist::print_name().

Value

All these functions return a character value.

Examples

## Compare all these outputs
tn_fun(52613)
tn_funa(52613)
tn_aun(52613)
tn_auna(52613)

---

Print formatted names for parents

Description

Displaying names of parent taxa.

Suffixes in the function names are explained as follows:

• pfn: Parent's full name without author name.

• pfna: Parent's full name with author name.

• pfnas: Parent's full name with author name and taxon view (secundum).

• pan: Parent's abbreviated name without author name.

• pana: Parent's abbreviated name with author name.

Usage

tn_pfn(x, level, ...)

tn_pfna(x, level, ...)

tn_pfnas(x, level, ...)

tn_pan(x, level, ...)

tn_pana(x, level, ...)

Arguments

x	A vector containing selected identifiers for taxon concepts (TaxonConceptID) included in the internal taxonomic object (see set_tax()).
level	A character value indicating the taxon rank set for parent taxa. I is passed to taxlist::parents().
...	Further arguments passed to taxlist::print_name().

Value

All these functions return a character value.

Examples

## Compare all these outputs
tn_pfn(13, "family")
tn_pfna(13, "family")
tn_pfnas(13, "family")
tn_pan(13, "family")
tn_pana(13, "family")

---