Counts such as population or livestock are usually reported per
administrative unit, while environmental covariates come as regular
raster grids. generate_density_raster() joins a table of
counts to a polygon layer, divides each count by the polygon’s
ellipsoidal area, and writes the resulting density onto a raster of the
resolution you choose.
We build four districts as polygons and a table of populations. The
key column is called district_id in the layer and
ID in the table; keys are matched without regard to case or
surrounding spaces.
library(GeoDensityR)
library(terra)
#> terra 1.9.50
districts <- terra::vect(
c("POLYGON((0 0, 2 0, 2 2, 0 2, 0 0))",
"POLYGON((2 0, 4 0, 4 2, 2 2, 2 0))",
"POLYGON((0 2, 4 2, 4 3, 0 3, 0 2))",
"POLYGON((0 3, 4 3, 4 4, 0 4, 0 3))"),
crs = "EPSG:4326"
)
districts$district_id <- c("D1", "D2", "D3", "D4")
census <- data.frame(
ID = c("D1", "D2", "D3", "D4"),
population = c(120000, 45000, 300000, 80000)
)dens <- generate_density_raster(
spatial_target = districts,
attribute_table = census,
join_spatial = "district_id",
join_attribute = "ID",
value_col = "population",
resolution = 0.1
)
dens
#> class : SpatRaster
#> size : 40, 40, 1 (nrow, ncol, nlyr)
#> resolution : 0.1, 0.1 (x, y)
#> extent : 0, 4, 0, 4 (xmin, xmax, ymin, ymax)
#> coord. ref. : lon/lat WGS 84 (EPSG:4326)
#> source(s) : memory
#> name : density
#> min value : 0.914047
#> max value : 6.096312Each cell takes the density of the polygon containing its centre, so the sum of density times cell area should be close to, but not exactly, the original total.
Two things matter in practice.
resolution is in
the units of the layer’s coordinate reference system. For a resolution
in degrees, reproject first, for example
v <- terra::project(terra::vect("boundaries.shp"), "EPSG:4326").
Areas are always computed on the ellipsoid."36,438" is read as text. Remove the separators before the
call, for example
tab$Cattle <- as.numeric(gsub(",", "", tab$Cattle)).The function warns about polygons with no matching table row, table rows with no polygon, values that cannot be converted to numbers, and layers that are not in longitude/latitude. If several polygons share a key (for example a state made of separate islands), the value is divided by their combined area, so the count is not used more than once.
v <- terra::project(terra::vect("India_State_Boundary.shp"), "EPSG:4326")
tab <- read.csv("livestock_counts.csv")
tab$Cattle <- as.numeric(gsub(",", "", tab$Cattle))
cattle <- generate_density_raster(
v, tab,
join_spatial = "State_Name",
join_attribute = "State",
value_col = "Cattle",
resolution = 0.05,
output = "cattle_density.tif"
)