Download taxonomic data
taxinfo_download( query, fq, fields, verbose = ala_config()$verbose, use_data_table = TRUE )
query | string: (optional) query of the form field:value (e.g. "genus:Heleioporus") or a free text search ("Alaba vibex") |
---|---|
fq | string: character string or vector of strings, specifying filters
to be applied to the original query.
These are of the form "INDEXEDFIELD:VALUE" e.g. "kingdom:Fungi". See
|
fields | string vector: (optional) a vector of field names to return.
Note that the columns of the returned data
frame are not guaranteed to retain the ordering of the field names given
here. If not specified, a default list of
fields will be returned. See |
verbose | logical: show additional progress information? [default is set by ala_config()] |
use_data_table | logical: if TRUE, attempt to read the data.csv file using the fread function from the data.table package. If this fails, or use_data_table is FALSE, then read.table will be used (which may be slower) |
data frame of results, containing one row per taxon, typically with name, guid, and taxonomic information. The columns returned will depend on the field requested
Associated ALA web service: https://api.ala.org.au/#ws2
if (FALSE) { ## simplest usage x <- taxinfo_download("rk_genus:Heleioporus") ## Data for Fabaceae with specified fields x <- taxinfo_download("rk_family:Fabaceae", fields=c("guid", "parentGuid", "rk_kingdom", "rk_phylum", "rk_class", "rk_order", "rk_family", "rk_genus", "scientificName")) }