| Title: | Access to the List of Birds Species of Peru |
|---|---|
| Description: | Allows access to the data found in the species list featured in the renowned 'List of the Birds of Peru' Plenge, M. A. (2023) <https://sites.google.com/site/boletinunop/checklist>. This publication stands as one of Peru's most comprehensive reviews of bird diversity. The dataset incorporates detailed species accounts and has been meticulously structured for effortless utilization within the R environment. |
| Authors: | Paul E. Santos Andrade [aut, cre]
|
| Maintainer: | Paul E. Santos Andrade <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.0.3 |
| Built: | 2024-12-05 13:54:45 UTC |
| Source: | CRAN |
The aves_peru_2023 dataset comprises a tibble containing information regarding bird species documented in Peru, sourced from the "List of the Birds of Peru" compiled by M. A. Plenge in 2023. It encompasses various details, including scientific names, English names, Spanish names, order, family, and status of each species.
aves_peru_2023aves_peru_2023
A tibble with 1,892 rows and 6 columns:
Scientific name of the bird species.
English common name of the bird species.
Spanish common name of the bird species.
The order to which the bird species belongs.
The family to which the bird species belongs.
Status of the bird species (e.g., resident, endémic, migratory, etc.).
This dataset is designed to provide users with comprehensive information about the avian species found in Peru, as documented by M. A. Plenge. It is organized for easy access and utilization within the R environment.
Data compilation: M. A. Plenge, Package implementation: Paul Efren Santos Andrade
The dataset is based on the "List of the Birds of Peru" by M. A. Plenge.
For more information about the "avesperu" package and the data sources, visit the package's GitHub repository: https://github.com/PaulESantos/avesperu
# Load the avesperu package library(avesperu) # Access the avesperu_tab dataset data("aves_peru_2023") # Display the first few rows head(aves_peru_2023)# Load the avesperu package library(avesperu) # Access the avesperu_tab dataset data("aves_peru_2023") # Display the first few rows head(aves_peru_2023)
The aves_peru_2024 dataset contains a tibble that provides information on bird species recorded in Peru, based on the "List of the Birds of Peru" by M. A. Plenge (last updated on March 6, 2024). It includes details such as scientific names, English names, Spanish names, order, family, and status of each species.
aves_peru_2024aves_peru_2024
A tibble with 1,901 rows and 6 columns:
Scientific name of the bird species.
English common name of the bird species.
Spanish common name of the bird species.
The order to which the bird species belongs.
The family to which the bird species belongs.
Status of the bird species (e.g., resident, endemic, migratory, etc.).
This dataset is designed to provide users with comprehensive information about the avian species found in Peru, as documented by M. A. Plenge. It is organized for easy access and utilization within the R environment.
Data compilation: M. A. Plenge, Package implementation: Paul Efren Santos Andrade
The dataset is based on the "List of the Birds of Peru" by M. A. Plenge. The citation for the list is as follows: Plenge, M. A. Version (09-03-2024). List of the birds of Peru / Lista de las aves del Perú. Unión de Ornitólogos del Perú: https://sites.google.com/site/boletinunop/checklist
For more information about the "avesperu" package and the data sources, visit the package's GitHub repository: https://github.com/PaulESantos/avesperu
# Load the avesperu package library(avesperu) # Access the avesperu_tab dataset data("aves_peru_2024") # Display the first few rows head(aves_peru_2024)# Load the avesperu package library(avesperu) # Access the avesperu_tab dataset data("aves_peru_2024") # Display the first few rows head(aves_peru_2024)
The aves_peru_2024_v2 dataset provides an updated tibble of bird
species recorded in Peru, based on the latest taxonomic revisions
by the South American Checklist Committee (SACC).
aves_peru_2024_v2aves_peru_2024_v2
A tibble with 1,909 rows and 6 columns:
Taxonomic order to which the bird species belongs.
Taxonomic family to which the bird species belongs.
Scientific name of the bird species.
English common name of the bird species.
Spanish common name of the bird species.
Category indicating the species' status, based on the following codes: X - Resident species. E - Endemic species. NB - Migratory species. V - Vagrant species. IN - Introduced species. EX - Extirpated species. H - Hypothetical species.
This version incorporates significant taxonomic changes, new categories, and updates derived from recent publications, photographs, and sound recordings archived in accredited institutions.
Total species: 1,909
Distribution by status:
X: 1,542 species
E: 117 species
NB: 138 species
V: 83 species
IN: 3 species
EX: 0 species
H: 26 species
Species near Peru’s borders with Ecuador, Colombia, Brazil, and Chile are included at the end of the list as potential additions to the Peruvian bird inventory. These updates reflect the SACC's ongoing efforts to evaluate and recognize certain subspecies as full species.
Data compilation: Manuel A. Plenge Package implementation: Paul Efren Santos Andrade
Plenge, M. A. (2024). Lista de las aves del Perú. Last updated: December 2, 2024. Unión de Ornitólogos del Perú.
For more information about the taxonomy, visit the South American Checklist Committee (SACC) website: https://sites.google.com/site/boletinunop/checklist
# Load the dataset data("aves_peru_2024_v2") # Display the first few rows head(aves_peru_2024_v2)# Load the dataset data("aves_peru_2024_v2") # Display the first few rows head(aves_peru_2024_v2)
This function searches for bird species information in the dataset provided by
the avesperu package, given a list of species names. It supports approximate
(fuzzy) matching to handle typographical errors or minor variations in the
species names. The function returns detailed information for each species,
including taxonomic data, common names, and status.
search_avesperu(splist, max_distance = 0.1)search_avesperu(splist, max_distance = 0.1)
splist |
A character vector containing the names of bird species to search for. Names can include minor variations or typos. |
max_distance |
Numeric. The maximum allowable distance for fuzzy matching, which can either be a proportion (0 < max_distance < 1) or an integer representing the maximum number of allowed differences. Defaults to 0.1. |
The function performs the following steps:
Validates the input, ensuring that splist is a character vector or a factor.
Standardizes species names and identifies duplicate entries in the list.
For each unique species name, it searches for matches in the dataset using
approximate string matching (agrep), with a customizable max_distance.
Retrieves the taxonomic and common name data for the closest matching species.
If no matches are found for a species, the corresponding row in the output will
contain NA values.
A data frame with the following columns:
The species name provided as input.
The closest matching species name from the dataset, or NA if no match is found.
The taxonomic order of the species.
The taxonomic family of the species.
The common name of the species in English.
The common name of the species in Spanish.
The conservation or other status of the species.
The computed distance between the submitted name and the matched name.
# Example: Search for bird species in the dataset splist <- c("Falco sparverius", "Tinamus osgodi", "Crypturellus soui", "Thraupis palmarum", "Thamnophilus praecox") search_avesperu(splist)# Example: Search for bird species in the dataset splist <- c("Falco sparverius", "Tinamus osgodi", "Crypturellus soui", "Thraupis palmarum", "Thamnophilus praecox") search_avesperu(splist)