R: Rasterize vector data

rasterize {terra}

R Documentation

Rasterize vector data

Description

Transfer vector data to a raster

Usage

## S4 method for signature 'SpatVector,SpatRaster'
rasterize(x, y, field="", fun, ..., background=NA, touches=FALSE,
	update=FALSE, sum=FALSE, cover=FALSE, filename="", overwrite=FALSE, wopt=list())

Arguments

`x`	SpatVector
`y`	SpatRaster
`field`	character or numeric. If `field` is a character, it should a variable name in `x`. If `field` is numeric it typically is a single number or a vector of length `nrow(x)`. The values are recycled to `nrow(x)`
`fun`	function, summarizing function that returns a single number; for when there are multiple points in one cell. For example `mean`, `length` (to get a count), `min` or `max`. Only used if `x` consists of points
`...`	additional arguments passed to `fun` if `x` has point geometries
`background`	numeric. Value to put in the cells that are not covered by any of the features of `x`. Default is `NA`
`touches`	logical. If `TRUE`, all cells touched by lines or polygons are affected, not just those on the line render path, or whose center point is within the polygon. If `touches=TRUE`, `add` cannot be `TRUE`
`update`	logical. If `TRUE`, the values of the input SpatRaster are updated
`sum`	logical. If `TRUE`, the values of overlapping geometries are summed instead of replaced; and `background` is set to zero. Only used if `x` does not consists of points
`cover`	logical. If `TRUE` and the geometry of `x` is polygons, the fraction of a cell that is covered by the polygons is returned. This is estimated by determining presence/absence of the polygon in at least 100 sub-cells (more of there are very few cells)
`filename`	character. Output filename
`overwrite`	logical. If `TRUE`, `filename` is overwritten
`wopt`	list with additional arguments for writing files as in `writeRaster`

Value

SpatRaster

Note

To update existing raster data use the output of rasterize as second argument in cover

Examples

f <- system.file("ex/lux.shp", package="terra")
v <- vect(f)
r <- rast(v, ncols=75, nrows=100)
#x <- rasterize(v, r, "NAME_2")

#plot(x)
#lines(v)

[Package terra version 1.4-7 Index]