redbookperu

Lifecycle: experimental Development status CRAN status R-CMD-check

redbookperu facilita la consulta de los taxones incluidos en el Libro Rojo de las Plantas Endémicas del Perú (León et al., 2006). Permite comprobar si una lista de nombres científicos corresponde a un taxón registrado como endémico y recuperar su información de conservación y distribución.

El paquete conserva el nombre histórico publicado en el Libro Rojo y ofrece, cuando está disponible, el nombre taxonómico aceptado. Las búsquedas admiten nombres históricos, nombres aceptados, sinónimos y errores ortográficos menores.

Instalación

Instale la versión publicada desde CRAN:

install.packages("redbookperu")

O la versión de desarrollo desde GitHub:

pak::pak("PaulESantos/redbookperu")

Luego cargue el paquete:

library(redbookperu)
## This is redbookperu 0.1.0

Uso

Resolver nombres de plantas

match_redbook_names() es la función principal del paquete. Devuelve una fila por nombre enviado e informa si el nombre figura en el Libro Rojo, cómo se encontró la coincidencia y cuál es su nombre aceptado cuando está disponible. La salida resumida facilita la revisión de una lista; la salida detallada permite examinar el contexto taxonómico.

especies <- c("Sanchezia ovata", "Verbesina andinaa",
             "Persea americana", NA_character_)

coincidencias <- match_redbook_names(
  especies, dist = 0.2, parser = "legacy", output = "summary"
)
coincidencias[, c("name_submitted", "input_valid", "redbook_name",
                   "endemic_status", "match_status", "match_distance")]

detalle <- match_redbook_names("Sanchezia ovata", parser = "legacy")
detalle[, c("name_submitted", "redbook_name", "accepted_name",
            "matched_via", "name_update_status")]

El primer nombre se resuelve mediante su nombre aceptado, el segundo mediante una coincidencia aproximada, el tercero no se encuentra y la entrada ausente se marca como inválida. parser = "legacy" usa el analizador incluido en el paquete para que el ejemplo sea reproducible sin dependencias opcionales.

Comprobar endemicidad

check_redbooklist() devuelve un estado para cada nombre enviado. Es útil para añadir una columna de endemicidad a una tabla de trabajo.

species <- c("Aphelandra cuscoensis", "Sanchezia ovata", "Persea americana")

check_redbooklist(species, quiet = TRUE)
## [1] "endemic"     "endemic"     "not endemic"
#
# tibble
tibble::tibble(species = c("Aphelandra cuscoensis",
                           "Sanchezia ovata", 
                           "Persea americana")) |> 
  dplyr::mutate(endemic = check_redbooklist(species))
## Total exact matches: 1

## Total fuzzy matches: 1

## # A tibble: 3 × 2
##   species               endemic    
##   <chr>                 <chr>      
## 1 Aphelandra cuscoensis endemic    
## 2 Sanchezia ovata       endemic    
## 3 Persea americana      not endemic

Recuperar la ficha de los taxones

get_redbook_data() devuelve un tibble con la información del Libro Rojo para cada nombre consultado. Los nombres no encontrados se conservan y sus campos de información se representan como valores ausentes.

get_redbook_data(
  c("Sanchezia ovata", "Macroclinium christensonii", "Persea americana"),
  quiet = TRUE
)
##               name_submitted              name_subitted
## 1            Sanchezia ovata            Sanchezia ovata
## 2 Macroclinium christensonii Macroclinium christensonii
## 3           Persea americana           Persea americana
##                accepted_name accepted_name_author accepted_family
## 1            Sanchezia ovata          Ruiz & Pav.     Acanthaceae
## 2 Macroclinium christensonii            D.E.Benn.     Orchidaceae
## 3                       <NA>                 <NA>            <NA>
##                 redbook_name        iucn
## 1         Sanchezia capitata          DD
## 2 Macroclinium christensonii CR, B1abiii
## 3                       <NA>        <NA>
##                                   publication
## 1 Bull. Herb. Boissier, ser. 2, 4: 315. 1904.
## 2    Brittonia 46(3): 249 - 251, f. 13. 1994.
## 3                                        <NA>
##                              collector herbariums  common_name dep_registry
## 1                  A. Mathews 1230 (K)       <NA> Desconocido.      JU - PA
## 2 O. del Castillo ex D.E. Bennett 5160        NY. Desconocido.           JU
## 3                                 <NA>       <NA>         <NA>         <NA>
##                ecological_regions      sinampe peruvian_herbariums
## 1 BMHP, BHA; altitud desconocida. Sin registro            Ninguno.
## 2                   BMHM; 1800 m. Sin registro            Ninguno.
## 3                            <NA>         <NA>                <NA>
##                                                                                                                                                                                                                                             remarks
## 1               Esta especie arbustiva es conocida de dos localidades. La colección tipo fue recolectada en la cuenca del Pangoa en el siglo XVIII. Probablemente la expansión urbana y las actividades agrícolas sean problemas para esta especie.
## 2 Esta hierba epífita es conocida sólo de la colección tipo, proveniente del valle de Chanchamayo, en una subcuenca del Perené. Esta región ha sufrido continuas reducciones de sus áreas naturales debido a la ampliación de la frontera agrícola.
## 3                                                                                                                                                                                                                                              <NA>

Las funciones que generan resultados tabulares devuelven tibbles, por lo que se integran directamente con flujos de trabajo basados en dplyr y tidyr.

Referencia

León, B., Roque, J., Ulloa Ulloa, C., Jørgensen, P. M., Pitman, N. y Cano, A. (2006). El Libro Rojo de las Plantas Endémicas del Perú. Revista Peruana de Biología, 13(2), 9s–22s. https://doi.org/10.15381/rpb.v13i2.1782