terra (version 1.5-17)

setValues: Set the values of raster cells or of geometry attributes

Description

Set cell values of a SpatRaster or the attributes of a SpatVector. For large SpatRaster objects use init instead to set values.

Usage

# S4 method for SpatRaster,ANY
values(x)<-value
# S4 method for SpatRaster,ANY
setValues(x, values, keeptime=TRUE, keepunits=TRUE, props=FALSE)
# S4 method for SpatVector,ANY
values(x)<-value

Arguments

x

SpatRaster or SpatVector

value

For SpatRaster: matrix or numeric, the length must match the total number of cells (ncell(x) * nlyr(x)), or be a single value. For SpatVector: data.frame, matrix, vector, or NULL

values

Same as for value

keeptime

logical. If TRUE the time stamps are kept

keepunits

logical. If FALSE the units are discarded

props

logical. If TRUE the properties (categories and color-table) are kept

Value

The same object type as x

See Also

values, init

Examples

# NOT RUN {
f <- system.file("ex/elev.tif", package="terra")
r <- rast(f)
x <- setValues(r, 1:ncell(r))
x
values(x) <- runif(ncell(x))
x
head(x)

f <- system.file("ex/lux.shp", package="terra")
v <- vect(f)
values(v) <- data.frame(ID=1:12, name=letters[1:12])
head(v)
# }