load_data_coverage {ebirdst} | R Documentation |
Load eBird Status and Trends Data Coverage Products
Description
The data coverage products are packaged as individual GeoTIFF files for each
product for each week of the year. This function loads one of the available
data products for one or more weeks into R as a
SpatRaster object. Note that data must be downloaded
using ebirdst_download_data_coverage()
prior to loading it using this
function.
Usage
load_data_coverage(
product = c("spatial-coverage", "selection-probability"),
weeks = NULL,
path = ebirdst_data_dir()
)
Arguments
product |
character; data coverage raster product to load: spatial coverage or site selection probability. |
weeks |
character; one or more weeks (expressed in |
path |
character; directory to download the data to. All downloaded
files will be placed in a sub-directory of this directory named for the
data version year, e.g. "2020" for the 2020 Status Data Products. Each
species' data package will then appear in a directory named with the eBird
species code. Defaults to a persistent data directory, which can be found
by calling |
Details
In addition to the species-specific data products, the eBird Status data products include two products providing estimates of weekly data coverage at 3 km spatial resolution:
-
spatial-coverage
: a spatially smoothed estimate of the proportion of the area that was covered by eBird checklists for the given week. -
selection-probability
: a modeled estimate of the probability that the given location and habitat was sampled by eBird data in the given week.
Value
A SpatRaster with between 1 and 52 layers for
the given product for the given weeks, where the layer names are the dates
(YYYY-MM-DD
format) of the midpoint of each week.
Examples
## Not run:
# download example data if hasn't already been downloaded
ebirdst_download_data_coverage()
# load a single week of site selection probability data
load_data_coverage("selection-probability", weeks = "01-04")
# load all weeks of spatial coverage data
load_data_coverage("spatial-coverage", weeks = c("01-04", "01-11"))
## End(Not run)