Extract and Rasterise IUCN Forest Ecosystems from Preloaded Layer

This function is deprecated and not recommended for current use. The IUCN GET ecosystem data has known quality issues and incomplete coverage. Users should supply their own forest ecosystem data.

A replacement data source from the Global Ecosystems Atlas is planned for future versions of this package.

Uso

get_iucn_forests(
  iucn_get_sf,
  iso3,
  pus,
  boundary_layer,
  include_minor_occurrence = TRUE,
  iucn_get_prefixes = c("MFT1.2", "T1.1", "T1.2", "T1.3", "T1.4", "T2.1", "T2.2", "T2.3",
    "T2.4", "T2.5", "T2.6", "TF1.1", "TF1.2"),
  excluded_prefixes = NULL,
  output_path = NULL
)

Argumentos

iucn_get_sf

sf object. IUCN GET polygons already loaded and pre-clipped to the boundary.

iso3

Character. ISO3 country code, used for naming and passed to make_normalised_raster().

pus

SpatRaster. Planning units raster over which forest coverage is computed.

boundary_layer

sf object. Used to spatially clip features if necessary.

include_minor_occurrence

Logical. If FALSE, removes minor occurrence ecosystems.

iucn_get_prefixes

Character vector of layer prefixes to retain (default is forest-related).

excluded_prefixes

Optional character vector of prefixes to exclude (e.g., "T7.1").

output_path

Optional character. Output directory to save raster.

Valor

A normalized SpatRaster showing fractional IUCN forest coverage across PUs.

Detalhes

This function filters IUCN GET polygons (already loaded as sf) to include only forest ecosystems, merges them, and calculates proportional coverage across each planning unit. The result is normalized to a 0-1 scale using elsar::make_normalised_raster().

Optionally, the result can be written to a Cloud-Optimized GeoTIFF file.

Exemplos

if (FALSE) { # \dontrun{
iucn_data <- get_iucn_ecosystems(...)
forest_layer <- get_iucn_forests_from_layer(
  iucn_get_sf = iucn_data,
  pus = pus,
  iso3 = "KEN",
  boundary_layer = boundary,
  excluded_prefixes = c("T7.1", "T7.2"),
  output_path = "outputs"
)
} # }