area_to_nb_cells {restoptr}

Compute the number of cells corresponding to a given area.

Description

Compute the number of cells corresponding to a given area.

Usage

area_to_nb_cells(raster_layer, area, unit = "ha")

Arguments

raster_layer

terra::rast() Raster object.

area

numeric Area.

unit

unit object or a character that can be coerced to a unit (see unit package). Must be an area unit.

Details

The input raster must have a projected coordinate system. The distortion is not corrected. It could be using the cellSize function of the terra package, but this function is currently pretty slow for large rasters. If your problem is at regional scale, the distortion should be negligible. However, at larger scales, the best is to use an equal-area projected coordinate system.

Value

numeric The number of raster cell correspond to the given area.

Examples

habitat_data <- rast(
  system.file("extdata", "habitat_hi_res.tif", package = "restoptr")
)
area_to_nb_cells(habitat_data, 20, unit = "ha")