pm_list_ecoregions: Display ecoregion metadata for Peruvian mammals

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

Display ecoregion metadata for Peruvian mammals

Description

Displays summary information about the ecoregions used in the Peruvian mammal backbone. Ecoregions follow the Brack-Egg (1986) classification system used in Peruvian biogeography to describe the distribution of mammal species across different ecological regions.

Usage

pm_list_ecoregions(include_endemic = FALSE)

Arguments

include_endemic

Logical. If TRUE, includes columns showing the number and percentage of endemic species per ecoregion. Default is FALSE.

Details

The ecoregion classification follows Brack-Egg (1986), a widely-used biogeographic framework for Peru that recognizes 10 distinct ecological regions based on climate, vegetation, and elevation. This classification is used in Pacheco et al. (2021) to document the distribution patterns of Peruvian mammals.

The function prints a formatted summary to the console and invisibly returns the complete data for further analysis.

Value

A tibble with one row per ecoregion, arranged in descending order by species richness, with the following columns:

ecoregion_code

Abbreviated ecoregion code (e.g., "SB", "YUN")

ecoregion_label

Full ecoregion name in Spanish

n_species

Total number of mammal species recorded in the ecoregion

pct_species

Percentage of Peru's total mammal diversity (0-100)

n_endemic

(Only if include_endemic = TRUE) Number of endemic species in the ecoregion

pct_endemic

(Only if include_endemic = TRUE) Percentage of endemic species relative to total species in the ecoregion (0-100)

References

Brack-Egg, A. (1986). Ecología de un país complejo. In J. Mejía Baca (Ed.), Gran Geografía del Perú: Naturaleza y Hombre (Vol. 2, pp. 175-319). Barcelona: Manfer-Mejía Baca.

See Also

peru_mammals_ecoregions_meta for the complete ecoregion metadata, peru_mammals_ecoregions for species-ecoregion associations, pm_by_ecoregion() to filter species by ecoregion, pm_ecoregion_summary() for species richness summaries by ecoregion.

Examples

# Display ecoregion information
pm_list_ecoregions()

# Include endemic species information
 pm_list_ecoregions(include_endemic = TRUE)

# Access the data for further analysis
ecoregion_data <- pm_list_ecoregions()

# Ecoregions with highest species richness
ecoregion_data

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