This function provides a convenient way to obtain a valid uuid or image url for an input taxonomic name. As multiple silhouettes can exist for each species in PhyloPic, this function extracts the primary image.
Arguments
- name
character
. A taxonomic name. Various taxonomic levels are supported (e.g. species, genus, family). NULL can also be supplied which will skip the taxonomic filtering of the PhyloPic database.- img
A Picture or png array object from
get_phylopic()
. A list of these objects can also be supplied. Ifimg
is supplied,name
andn
are ignored. Defaults to NULL.- n
numeric
. How many uuids should be returned? Depending on the requestedname
, multiple silhouettes might exist. Ifn
exceeds the number of available images, all available uuids will be returned. This argument defaults to 1.- filter
character
. Filter uuid(s) by usage license. Use "by" to limit results to image uuids which do not require attribution, "nc" for image uuids which allow commercial usage, and "sa" for image uuids without a ShareAlike clause. The user can also combine these filters as a vector.- url
logical
. IfFALSE
(default), only the uuid is returned. IfTRUE
, a valid PhyloPic image url of the uuid is returned.
Details
This function returns uuid(s) or image url (svg) for an input
name
. If a specific image is desired, the user can make use of
pick_phylopic to visually select the desired uuid/url.