galah supports two functions to look up information:
show_all() and search_all(). The first
argument to both functions is a type of information that you wish to
look up; for example to see what fields are available to filter a query
by, use:
## # A tibble: 582 × 3
## id description type
## <chr> <chr> <chr>
## 1 acceptedNameUsage Accepted name fields
## 2 acceptedNameUsageID Accepted name fields
## 3 accessRights Access rights fields
## 4 annotationsDoi <NA> fields
## 5 annotationsUid Referenced by publication fields
## 6 assertionUserId Assertions by user fields
## 7 assertions Record issues fields
## 8 assertionsCount <NA> fields
## 9 associatedMedia Associated Media fields
## 10 associatedOccurrences Associated Occurrences fields
## # ℹ 572 more rows
And to search for a specific field:
## # A tibble: 2 × 3
## id description type
## <chr> <chr> <chr>
## 1 cl2013 ASGS Australian States and Territories fields
## 2 cl22 Australian States and Territories fields
Here is a list of information types that can be used with
show_all() and search_all():
| Information type | Description | Sub-functions |
|---|---|---|
| Configuration | ||
| atlases | Show what living atlases are available | show_all_atlases(), search_atlases() |
| apis | Show what APIs & functions are available for each atlas | show_all_apis(), search_apis() |
| reasons | Show what values are acceptable as ‘download reasons’ for a specified atlas | show_all_reasons(), search_reasons() |
| Taxonomy | ||
| taxa | Search for one or more taxonomic names | search_taxa() |
| identifiers | Take a universal identifier and return taxonomic information | search_identifiers() |
| ranks | Show valid taxonomic ranks (e.g. Kingdom, Class, Order, etc.) | show_all_ranks(), search_ranks()) |
| Filters | ||
| fields | Show fields that are stored in an atlas | show_all_fields(), search_fields() |
| assertions | Show results of data quality checks run by each atlas | show_all_assertions(), search_assertions() |
| Group filters | ||
| profiles | Show what data quality profiles are available | show_all_profiles(), search_profiles() |
| lists | Show what species lists are available | show_lists(), search_lists() |
| Data providers | ||
| providers | Show which institutions have provided data | show_all_providers(), search_providers() |
| collections | Show the specific collections within those institutions | show_all_collections(), search_collections() |
| datasets | Shows all the data groupings within those collections | show_all_datasets(), search_datasets() |
show_all_ subfunctionsWhile show_all is useful for a variety of cases, you can
still call the underlying subfunctions if you prefer. Functions with the
prefix show_all_ do exactly that; they show all the
possible values of the category specified.
## # A tibble: 10 × 4
## region institution acronym url
## <chr> <chr> <chr> <chr>
## 1 Australia Atlas of Living Australia ALA https://www.ala.org.au
## 2 Austria Biodiversitäts-Atlas Österreich BAO https://biodiversityatlas.at
## 3 Brazil Sistemas de Informações sobre a Biodiversidade Brasileira SiBBr https://sibbr.gov.br
## 4 Flanders Vlaams Biodiversiteitsportaal VBP https://natuurdata.inbo.be
## 5 Global Global Biodiversity Information Facility GBIF https://gbif.org
## 6 Guatemala Sistema Nacional de Información sobre Diversidad Biológica de Guatemala SNIBgt https://snib.conap.gob.gt
## 7 Kew Kew Data Portal KDP https://data.kew.org
## 8 Portugal GBIF Portugal GBIF.pt https://www.gbif.pt
## 9 Spain GBIF Spain GBIF.es https://gbif.es
## 10 United Kingdom National Biodiversity Network NBN https://nbn.org.uk
## # A tibble: 13 × 2
## id name
## <int> <chr>
## 1 0 conservation management/planning
## 2 1 biosecurity management/planning
## 3 2 environmental assessment
## 4 3 education
## 5 4 scientific research
## 6 5 collection management
## 7 6 other
## 8 7 ecological research
## 9 8 systematic research/taxonomy
## 10 10 testing
## 11 11 citizen science
## 12 12 restoration/remediation
## 13 13 species modelling
search_ subfunctionsYou can also call subfunctions that use the search_
prefix to lookup information. search_ subfunctions differ
from show_all_ in that they require a query to work, and
they useful to search for detailed information that can’t be summarised
across the whole atlas.
search_taxa() is an especially useful function in galah.
It let’s you search for a single taxon or multiple taxa by name.
## # A tibble: 1 × 10
## search_term scientific_name taxon_concept_id rank match_type vernacular_name issues kingdom phylum class
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 reptilia REPTILIA https://biodiversity.org.au/afd/taxa/682e1228-5b3c-45ff-833b-550efd40c399 class exactMatch Snakes, Lizards, Monitors And Crocodiles noIssue Animalia Chordata Reptilia
## # A tibble: 4 × 10
## search_term scientific_name taxon_concept_id rank match_type vernacular_name issues kingdom phylum class
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 reptilia REPTILIA https://biodiversity.org.au/afd/taxa/682e1228-5b3c-45ff-833b-550efd40c399 class exactMatch Snakes, Lizards, Monitors And Crocodiles noIssue Animalia Chordata Reptilia
## 2 aves AVES https://biodiversity.org.au/afd/taxa/65625205-db74-4a87-b566-ca387b119974 class exactMatch Birds noIssue Animalia Chordata Aves
## 3 mammalia MAMMALIA https://biodiversity.org.au/afd/taxa/e9e7db31-04df-41fb-bd8d-e0b0f3c332d6 class exactMatch Mammals noIssue Animalia Chordata Mammalia
## 4 pisces PISCES https://biodiversity.org.au/afd/taxa/e22efeb4-2cb5-4250-8d71-61c48bdaa051 <NA> exactMatch Guya noIssue Animalia Chordata <NA>
Alternatively, search_identifiers() is the partner
function to search_taxa(). If we already know a taxonomic
identifier, we can search for which taxa the identifier belongs to.
## # A tibble: 1 × 9
## search_term scientific_name taxon_concept_id rank match_type vernacular_name issues kingdom phylum
## <chr> <chr> <chr> <chr> <chr> <chr> <list> <chr> <chr>
## 1 urn:lsid:biodiversity.org.au:afd.taxon:682e1228-5b3c-45ff-833b-550efd40c399 REPTILIA https://biodiversity.org.au/afd/taxa/682e1228-5b… class taxonIdMa… Snakes, Lizard… <list> Animal… Chord…
show_values() & search_values()Once a desired field is found, you can use show_values()
to understand the information contained within that field. For example,
we can show the values contained in the field
basisOfRecord.
## ! Search returned 2 matched fields.
## • Showing values for 'basisOfRecord'.
## # A tibble: 9 × 1
## basisOfRecord
## <chr>
## 1 HUMAN_OBSERVATION
## 2 PRESERVED_SPECIMEN
## 3 OCCURRENCE
## 4 OBSERVATION
## 5 MACHINE_OBSERVATION
## 6 MATERIAL_SAMPLE
## 7 LIVING_SPECIMEN
## 8 FOSSIL_SPECIMEN
## 9 MATERIAL_CITATION
Use this information to pass meaningful queries to
galah_filter().
## # A tibble: 1 × 1
## count
## <int>
## 1 148608
This works for other types of query, such as data profiles:
## ! Search returned 2 matched profiles.
## • Showing values for 'ALA'.
## # A tibble: 6 × 4
## id description filter enabled
## <int> <chr> <chr> <lgl>
## 1 94 "Exclude all records where spatial validity is \"false\"" "-spa… TRUE
## 2 96 "Exclude all records with an assertion that the scientific name provided does not match any of the names lists used by the ALA. For a full explanation of the ALA name matchi… "-ass… TRUE
## 3 97 "Exclude all records with an assertion that the scientific name provided is not structured as a valid scientific name. Also catches rank values or values such as \"UNKNOWN\"" "-ass… TRUE
## 4 99 "Exclude all records with an assertion that kingdom provided doesn't match a known kingdom e.g. Animalia, Plantae" "-ass… TRUE
## 5 100 "Exclude all records with an assertion that the scientific name provided in the record does not match the expected taxonomic scope of the resource e.g. Mammal records attribu… "-ass… TRUE
## 6 98 "Exclude all records with an assertion that the name and classification supplied can't be used to choose between 2 homonyms" "-ass… TRUE