The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.
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"
)These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.