terra (version 0.8-5)

values: Get or set cell values

Description

values returns all cell values of a SpatRaster (a matrix), or all the attributes of a SpatVector (a data.frame).

Usage

# S4 method for SpatRaster
values(x, mat=TRUE, ...)
# S4 method for SpatRaster,ANY
values(x, ...)<-value
# S4 method for SpatRaster,ANY
setValues(x, values, ...)
# S4 method for SpatVector
values(x, ...)
# S4 method for SpatVector,data.frame
values(x, ...)<-value

Arguments

x

SpatRaster or SpatVector

mat

logical. If TRUE, values are returned as a matrix instead of as a vector

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

values

Same as for value

...

additional arguments. none implemented

Value

matrix, vector, SpatRaster, or nothing

Details

If x is a SpatRaster:

If matrix=TRUE, a matrix is returned in which the values of each layer are represented by a column (with ncell(x) rows). The values per layer are in cell-order, that is, from top-left, to top-right and then down by row. Use as.matrix for an alternative matrix representation where the number of rows and columns matches that of x, if x has a single layer. If matrix=FALSE, the values are returned as a vector. In cell-order by layer.

If x is a SpatVector: a data.frame

Examples

# NOT RUN {
r <- rast(system.file("ex/test.tif", package="terra"))
r
v <- values(r)
values(r) <- v * 10
r

f <- system.file("ex/lux.shp", package="terra")
v <- vect(f)
x <- values(v)
x
values(v) <- x[,1:2]
v
# }