Specify fields for occurrence download

The living atlases store content in hundreds of different fields, and users often require thousands or millions of records at a time. To reduce time taken to download data, and limit complexity of the resulting data.frame, it is sensible to restrict the fields returned by atlas_occurrences(). This function allows easy selection of fields, or commonly-requested groups of columns, following syntax shared with dplyr::select().

Usage

# S3 method for data_request
select(.data, ..., group = c("basic", "event", "media", "assertions"))

Arguments

.data

An object of class data_request, created using galah_call()

...

zero or more individual column names to include

group

string: (optional) name of one or more column groups to include. Valid options are "basic", "event" and "assertions"

Value

A tibble specifying the name and type of each column to include in the call to atlas_counts() or atlas_occurrences().

Details

The full list of available fields can be viewed with show_all(fields).

Calling the argument group = "basic" returns the following columns:

• decimalLatitude

• decimalLongitude

• eventDate

• scientificName

• taxonConceptID

• recordID

• dataResourceName

• occurrenceStatus

Using group = "event" returns the following columns:

• eventRemarks

• eventTime

• eventID

• eventDate

• samplingEffort

• samplingProtocol

Using group = "media" returns the following columns:

• multimedia

• multimediaLicence

• images

• videos

• sounds

Using group = "assertions" returns all quality assertion-related columns. The list of assertions is shown by show_all_assertions().

See also

galah_select(), with which this function is synonymous.