When conducting a search or creating a data query, it is common to identify a known taxon or group of taxa to narrow down the records or results returned. This function allows users to pass scientific names or taxonomic identifiers with pipes to provide data only for the biological group of interest.
galah_identify(..., search = TRUE)one or more scientific names (if search = TRUE) or taxonomic
identifiers (if search = FALSE); or an object of class ala_id (from
search_taxa), gbifid, or nbnid (from taxize) for
international atlases.
(logical); should the results in question be passed to
search_taxa? Ignored if an object of class ala_id, gbifid, or nbnid
is given to ....
galah_identify() is used to identify taxa you want returned in a search or
a data query. It is good to use search_taxa() and search_identifiers()
first to check that the taxa you provide to galah_identify() return the
correct results.
Specify a taxon. A valid taxon will return an identifier.
galah_identify("reptilia")
#> # A tibble: 1 x 1
#> identifier
#> <chr>
#> 1 urn:lsid:biodiversity.org.au:afd.taxon:682e1228-5b3c-45ff-833b-550efd40c399
Specify more than one taxon at a time.
galah_identify("reptilia", "mammalia", "aves", "pisces")
#> # A tibble: 4 x 1
#> identifier
#> <chr>
#> 1 urn:lsid:biodiversity.org.au:afd.taxon:682e1228-5b3c-45ff-833b-550efd40c399
#> 2 urn:lsid:biodiversity.org.au:afd.taxon:e9e7db31-04df-41fb-bd8d-e0b0f3c332d6
#> 3 urn:lsid:biodiversity.org.au:afd.taxon:5ed80139-31bb-48a8-9f57-42d8015dacbb
#> 4 urn:lsid:biodiversity.org.au:afd.taxon:e22efeb4-2cb5-4250-8d71-61c48bdaa051
Use galah_identify() to narrow your queries
galah_call() %>%
galah_identify("Eolophus") %>%
atlas_counts()
#> # A tibble: 1 x 1
#> count
#> <int>
#> 1 856571
If you already know a valid taxon identifier, add it and set search = FALSE.
galah_call() %>%
galah_identify("urn:lsid:biodiversity.org.au:afd.taxon:b2de5e40-df8f-4339-827d-25e63454a4a2",
search = FALSE) %>%
atlas_counts()
#> # A tibble: 1 x 1
#> count
#> <int>
#> 1 856571
search_taxa() to find identifiers from scientific names;
search_identifiers() for how to get names if taxonomic identifiers
are already known.