| search_mtsta_distribution {mtsta} | R Documentation |
Search Species Distribution of A Regional Red List of Montane Tree Species of the Tropical Andes
Description
This function searches the Montane Tree Species of the Tropical Andes distribution database for a list of submitted species names and returns their distribution information. The search allows for approximate string matching within a given maximum distance.
Usage
search_mtsta_distribution(splist, max_distance = 0.1, typedf = "main")
Arguments
splist |
Character vector of submitted plant species names for which distribution data is to be searched. |
max_distance |
Numeric value representing the maximum allowed distance for approximate string matching. The default value is 0.1. |
typedf |
"main" return a selected columns in from mtsta_distribution "full" return all data |
Details
The function uses approximate string matching with a maximum distance specified by
the max_distance argument. It searches the mtsta distribution database for submitted
species names that match the provided names within the given distance. The function then
retrieves distribution information, including the accepted name, distribution region, unsure
distribution (if available), distribution from the World Check-list of Vascular Plants (WCVP),
taxonomic status, and the Levenshtein distance between submitted and matched species names.
Value
A data frame with the following columns:
- name_submitted
Character vector with the submitted species names.
- name_matched
Character vector with the matched species names in the database.
- accepted_name
Character vector with the accepted names of the matched species.
- distribution
Character vector with the distribution of the matched species.
- unsure_distribution
Character vector with information about unsure distribution (if available).
- distribution_wcvp
Character vector with the distribution from the World Check-list of Vascular Plants (WCVP) database for the matched species.
- taxonomic_status
Character vector indicating the taxonomic status of the matched species.
- distance
Numeric vector with the Levenshtein distance between submitted and matched species names.
See Also
Examples
# Example usage of search_mtsta_distribution function
species_list <- c("Escallonia mirtilloydes", "Ilex rimbachii", "Saurauia lehmannii")
distribution_data <- search_mtsta_distribution(species_list, max_distance = 0.2)
print(distribution_data)