Create a reference to an eBird sampling event file in preparation for
filtering using AWK. For working with the sightings data use
auk_sampling() if you intend to only work with checklist-level
auk_sampling(file, sep = "\t")
character; input sampling event data file, which contains checklist data from eBird.
character; the input field separator, the eBird data are tab separated so this should generally not be modified. Must only be a single character and space delimited is not allowed since spaces appear in many of the fields.
auk_sampling object storing the file reference and the desired
filters once created with other package functions.
eBird data can be downloaded as a tab-separated text file from the eBird website after submitting a request for access. In the eBird Basic Dataset (EBD) each row corresponds to a observation of a single bird species on a single checklist, while the sampling event data file contains a single row for every checklist. This function creates an R object to reference only the sampling data.
# get the path to the example data included in the package # in practice, provide path to the sampling event data # e.g. f <- "data/ebd_sampling_relFeb-2018.txt" f <- system.file("extdata/zerofill-ex_sampling.txt", package = "auk") auk_sampling(f) #> Input #> Sampling events: /private/var/folders/mg/qh40qmqd7376xn8qxd6hm5lwjyy0h2/T/RtmpAo06fk/temp_libpath15c811d2fb75b/auk/extdata/zerofill-ex_sampling.txt #> #> Output #> Filters not executed #> #> Filters #> Countries: all #> States: all #> Counties: all #> Bounding box: full extent #> Years: all #> Date: all #> Start time: all #> Last edited date: all #> Protocol: all #> Project code: all #> Duration: all #> Distance travelled: all #> Complete checklists only: no