Users may wish to see the specific values within a chosen field, profile
or list to narrow queries or understand more about the information of
interest. show_values()
provides users with these values. search_values()
allows users for search for specific values within a specified field.
Arguments
- df
A search result from
search_fields()
,search_profiles()
orsearch_lists()
.- all_fields
If
TRUE
,show_values()
also returns all raw data columns (columns included prior to the dataset's ingestion into the ALA). For many lists, this will include raw scientific names and vernacular names. For conservation lists like the EPBC list, this also includes columns containing each species' conservation status information. Default is set toFALSE
. Currently only implemented for metadata typelists
.- query
A string specifying a search term. Not case sensitive.
Details
Each Field contains categorical or numeric values. For example:
The
field
"year" contains values 2021, 2020, 2019, etc.The
field
"stateProvince" contains values New South Wales, Victoria, Queensland, etc. These are used to narrow queries withfilter()
orgalah_filter()
.
Each Profile consists of many individual quality filters. For example, the "ALA" profile consists of values:
Exclude all records where spatial validity is FALSE
Exclude all records with a latitude value of zero
Exclude all records with a longitude value of zero
Each List contains a list of species, usually by taxonomic name. For example, the Endangered Plant species list contains values:
Acacia curranii (Curly-bark Wattle)
Brachyscome papillosa (Mossgiel Daisy)
Solanum karsense (Menindee Nightshade)
Examples
if (FALSE) { # \dontrun{
# Show values in field 'cl22'
search_fields("cl22") |>
show_values()
# This is synonymous with `request_metadata() |> unnest()`.
# For example, the previous example can be run using:
request_metadata() |>
filter(field == "cl22") |>
unnest() |>
collect()
# Search for any values in field 'cl22' that match 'tas'
search_fields("cl22") |>
search_values("tas")
# See items within species list "dr19257"
search_lists("dr19257") |>
show_values()
} # }