get_names() is now implemented. (the inverse function to get_ids())
Table-based functions
The functions that return the full Darwin Core table are now part of the by_ family:
ids() -> by_name()
descendants() -> by_rank()
descendants(id = ...) -> by_id()
common_names()-> by_common() not implemented
new: filter_by(), a generic method which powers each of the by_ methods. (Note, these are all filtering joins, which are way faster than literal dplyr::filter when given long vectors).
synonyms() returns accepted name and known synonyms, according to the authority
Helper functions
clean_names() (unchanged, but still could use some work).
mutate_db() apply custom R functions to create a new column (unchanged)
top level database functions
(unchanged parts of the namespace)
td_create() Create (download and install) a local copy of a given database provider
td_connect() Create a connection to a monetdblite database
taxa_tbl() Return a taxon table -- a database connection if available, otherwise a memoized download kept in memory.
Revised core API:
Vector-based functions
These return a vector, not a table
get_ids()works ~ as it does intaxizeget_names()is now implemented. (the inverse function toget_ids())Table-based functions
The functions that return the full Darwin Core table are now part of the
by_family:ids()->by_name()descendants()->by_rank()descendants(id = ...)->by_id()common_names()->by_common()not implementednew:
filter_by(), a generic method which powers each of theby_methods. (Note, these are all filtering joins, which are way faster than literaldplyr::filterwhen given long vectors).synonyms()returns accepted name and known synonyms, according to the authorityHelper functions
clean_names()(unchanged, but still could use some work).mutate_db()apply custom R functions to create a new column (unchanged)top level database functions
(unchanged parts of the namespace)
td_create()Create (download and install) a local copy of a given database providertd_connect()Create a connection to a monetdblite databasetaxa_tbl()Return a taxon table -- a database connection if available, otherwise a memoized download kept in memory.