cell_area: Compute the area of a cell

In restoptr: Ecological Restoration Planning

Compute the area of a cell

Description

Compute the area of a cell

Usage

cell_area(raster_layer, unit = "ha")

Arguments

raster_layer	terra::rast() Raster object.
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 area of a cell in the desired unit.

Examples

## Not run: 
habitat_data <- rast(
  system.file("extdata", "habitat_hi_res.tif", package = "restoptr")
)
cell_area(habitat_data, "ha")

## End(Not run)

restoptr documentation built on Aug. 12, 2025, 1:08 a.m.