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

setValues {terra} | R Documentation

## 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 replacement method for signature 'SpatRaster,ANY'
    values(x)<-value

    ## S4 method for signature 'SpatRaster,ANY'
    setValues(x, values, time=TRUE, props=FALSE)

    ## S4 replacement method for signature '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`
`time` | logical. If `TRUE` the time stamps are kept
`props` | logical. If `TRUE` the properties (categories and color-table) are kept

### Value

The same object type as `x`

### See Also

`values`, `init`

### Examples

    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)

[Package terra version 1.3-22 Index]