pm_list_endemic: List endemic mammal species by taxonomic order

In perumammals: Taxonomic Backbone and Name Validation Tools for Mammals of Peru

List endemic mammal species by taxonomic order

Description

Summarises the diversity of endemic mammal species in Peru, grouped by taxonomic order. Provides counts of families, genera, and species that are endemic to Peru within each order. Optionally includes endemism rates relative to total species richness.

Usage

pm_list_endemic(include_rate = FALSE)

Arguments

include_rate

Logical. If TRUE, includes additional columns showing total species richness and endemism rate for each order. Default is FALSE.

Details

This function focuses exclusively on species that are endemic to Peru (i.e., species found nowhere else in the world). Orders without any endemic species are not included in the output.

When include_rate = FALSE (default), results are sorted by the number of endemic species in descending order, highlighting which orders have the highest endemic diversity.

When include_rate = TRUE, results are sorted by total species richness in descending order, and include endemism rates to show what proportion of each order's diversity is endemic to Peru. A summary row labeled "Total" is appended to show overall statistics.

Value

A tibble with one row per order containing endemic species, arranged in descending order by number of endemic species, with the following columns:

order

Taxonomic order

n_families

Number of families with endemic species in the order

n_genera

Number of genera with endemic species in the order

n_endemic

Number of endemic species in the order

n_species

(Only if include_rate = TRUE) Total number of species in the order

endemic_rate

(Only if include_rate = TRUE) Proportion of endemic species (0-1)

endemic_pct

(Only if include_rate = TRUE) Percentage of endemic species (0-100)

Examples

# Summary of endemic species by order
pm_list_endemic()

# Include endemism rates
pm_list_endemic(include_rate = TRUE)

perumammals documentation built on Jan. 6, 2026, 5:06 p.m.