Closed matildastevenson closed 9 months ago
This issue has not been completely solved, but the addition of search_taxonomy()
(#75 #81 ) has addressed the need for a function that can (1) return higher and lower taxa from any taxonomic rank, and (2) search for intermediate ranks for species
There is some merit here, but the architecture has largely moved on. Closing this until someone makes a compelling argument that further changes are needed
Currently there are four possible ways users can download taxonomic data:
select_taxa()
gives detailed taxonomic information at any requested level, and optionally includes counts, intermediate rank information and child taxon. Species don't need to have records to be included.ala_species()
gives species-level information- specifically species that the ALA has records forala_counts()
gives count information, and this can be at any rank (including intermediate ranks)ala_occurrences()
gives record information, and this can include species informationThe functionality available in these functions overlaps significantly, to the point where it is hard to explain why a user would use one function over another. For example, to get the species in the genus Callistemon there are four methods:
select_taxa("Callistemon", children = TRUE)
2.9 secsala_species(taxa = select_taxa("Callistemon"))
0.73 secsala_counts(taxa = select_taxa("Callistemon"), group_by = "species")
0.92 secsala_occurrences(taxa = select_taxa("Callistemon"))
9.8 secsAs the times indicated above show- these methods are not equal in term of speed, or in the data they return.
The main features needed from one or more taxonomic functions (or combinations of functions) are:
Suggestions:
ala_species()
as this webservice is not optimised and overlaps significantly withselect_taxa()
andala_counts()
ala_counts()
as is and keep the type argument, and make the ability to get species information more obviousselect_taxa()
for looking up taxonomic information, even though this information will eventually be available intaxize
.taxize
to ALA github organisation, and add functions includingget_alaid
, and ALA implementations of functions includingclassification
,children
,downstream
andupstream
. See function reference fortaxize
here