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")
)

Arguments

path

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().

product

character; Status and Trends product to load, see Details for available products. It is also possible to return a template raster with no data.

resolution

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.

Value

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.

Details

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.

Examples

if (FALSE) {
# 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")
}