Each of the eBird Status and Trends products is packaged as a GeoTIFF file
(referred to as a "cube) with 52 bands, one for each week of the year. This
function loads the cube for a given product and species as a RasterStack
object.
load_raster(
path,
product = c("abundance", "abundance_seasonal", "count", "occurrence",
"abundance_lower", "abundance_upper", "template"),
resolution = c("hr", "mr", "lr")
)character; directory that the Status and Trends data for a given
species was downloaded to. This path is returned by ebirdst_download()
or get_species_path().
character; Status and Trends product to load, see Details for available products. It is also possible to return a template raster with no data.
character; the resolution of the raster data to load. The
default is to load the native ~3 km resolution ("hr"); however, for some
applications 9 km ("mr") or 27 km ("lr") data may be suitable.
A RasterStack with 52 layers for the given product, labeled by
week. Seasonal abundance will have up to four layers labeled according to
the seasons. The template raster will be returned as a RasterLayer.
The available Status and Trends data cubes are as follows:
occurrence: the expected probability of occurrence of the species,
ranging from 0 to 1, on an eBird Traveling Count by a skilled eBirder
starting at the optimal time of day with the optimal search duration and
distance that maximizes detection of that species in a region.
count: the expected count of a species, conditional on its occurrence at
the given location, on an eBird Traveling Count by a skilled eBirder
starting at the optimal time of day with the optimal search duration and
distance that maximizes detection of that species in a region.
abundance: the expected relative abundance, computed as the product of
the probability of occurrence and the count conditional on occurrence, of the
species on an eBird Traveling Count by a skilled eBirder starting at the
optimal time of day with the optimal search duration and distance that
maximizes detection of that species in a region.
abundance_lower: the lower 10th quantile of the expected relative
abundance of the species on an eBird Traveling Count by a skilled eBirder
starting at the optimal time of day with the optimal search duration and
distance that maximizes detection of that species in a region.
abundance_upper: the upper 90th quantile of the expected relative
abundance of the species on an eBird Traveling Count by a skilled eBirder
starting at the optimal time of day with the optimal search duration and
distance that maximizes detection of that species in a region.
In addition to these cubes with 52 layers (one for each week), it is possible to load:
abundance_seasonal: the expected relative abundance averaged across the
weeks within each season. The date boundaries used for the seasonal
definitions appear in ebirdst_runs and if a season failed review no
associated layer will be included.
template: a template raster covering the whole Earth and without any
data.
# NOT RUN {
# download example data
path <- ebirdst_download("example_data")
# or get the path if you already have the data downloaded
path <- get_species_path("example_data")
# load data
load_raster(path, "abundance")
# }
Run the code above in your browser using DataLab