powoSpDist: Extract distribution of any plant species

Description

Produces a CSV file listing the geographical distribution at country and botanical subdivisions of all target species of vascular plants at Plants of the World Online (POWO).

Usage

powoSpDist(family,
           species = NULL,
           verbose = TRUE,
           save = FALSE,
           dir = "results_powoSpDist",
           filename = "output")

Value

A table with the following fields: family, genus, species, taxon_name, authors, scientific_name, native_to_country (original distribution according to political country), native_to_botanical_countries (original distribution according to botanical country), introduced_to_country (exotic distribution according to political country), introduced_to_botanical_countries (exotic distribution according to botanical country), kew_id (each species code within Kew's databases), powo_uri (URI to access each species in POWO).

Arguments

family: Either one family name or a vector of multiple families that is present in POWO.
species: Either one non-hybrid species name or a vector of multiple species that is present in POWO. If any species name is not provided, then the function will search any species from all accepted genera known for the target family.
verbose: Logical, if FALSE, a message showing each step during the POWO search will not be printed in the console in full.
save: Logical, if TRUE, the search results will be saved on disk.
dir: Pathway to the computer's directory, where the file will be saved provided that the argument save is set up in TRUE. The default is to create a directory named results_powoSpDist and the search results will be saved within a subfolder named after the current date.
filename: Name of the output file to be saved. The default is to create a file entitled output.

Author

Debora Zuanny & Domingos Cardoso

Examples

Run this code

if (FALSE) {
library(expowo)

powoSpDist(family = "Lecythidaceae",
           species = "Lecythis pisonis",
           save = FALSE,
           dir = "results_powoSpDist",
           filename = "L_pisonis_distribution")
}