GeoDensityR

CRAN status

Census and survey counts are usually published per administrative unit (districts, states, tracts), while environmental data come as regular raster grids. GeoDensityR joins a table of counts to a polygon layer, divides each count by the polygon’s area on the ellipsoid, and writes the resulting density onto a raster of the resolution you choose. The result is a terra SpatRaster that can be stacked with climate or land-cover layers.

Installation

From CRAN:

install.packages("GeoDensityR")

Development version from GitHub:

# install.packages("remotes")
remotes::install_github("sahalpaladan/GeoDensityR")

Example

library(GeoDensityR)
library(terra)

# Four districts as polygons, and a table of populations
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
)

terra::plot(dens, main = "People per square kilometre")

spatial_target can be a terra::SpatVector, an sf object or a path to a shapefile, and attribute_table can be a data frame or a path to a CSV file. Use output = "density.tif" to write the result to disk.

Things to know

See vignette("GeoDensityR") for a longer walk-through.

Citation

Paladan S, Chanda MM (2026). GeoDensityR: Generate Density Rasters from Polygon and Census Data. R package version 0.2.2. https://doi.org/10.32614/CRAN.package.GeoDensityR

Contributing

Bug reports and pull requests are welcome. See CONTRIBUTING.md.

License

MIT