Specifies a term-wise search (like searchbyterm) and requests
that all available records be made available for download as a
tab-delimited text file.
Usage
bigsearch(..., rfile, email, messages = TRUE, callopts = list())Arguments
- ...
arguments, must be named, see
searchbyterm()for details- rfile
A name for the results file that you will download (character). Required.
An email address where you can be contacted when your records are ready for download (character). Required.
- messages
(logical) Print progress and information messages. Default:
TRUE- callopts
(named list) Curl arguments passed on to crul::verb-GET
Details
bigsearch allows you to request records as a
tab-delimited text file. This is the best way to access a large number of
records, such as when your search results indicate that >1000 records are
available. You will be notified by email when your records are ready
for download.
Reading data
We suggest reading data in with data.table::fread() - as it's very
fast for the sometimes large datasets
you will get from using this function, and is usually robust to
formatting issues.
Examples
if (FALSE) { # \dontrun{
# replace "big@search.luv" with your own email address
bigsearch(genus = "ochotona", rfile = "pikaRecords", email = "big@search.luv")
# Pass in curl options for curl debugging
bigsearch(genus = "ochotona", rfile = "pikaRecords",
email = "big@search.luv", verbose = TRUE)
# Use more than one year query
bigsearch(class = "aves", year = c(">=1976", "<=1986"),
rfile = "test-bigsearch1", email = "big@search.luv")
} # }