terra (version 1.1-4)

cells: Get cell numbers

Description

Get the cell numbers covered by a SpatVector or SpatExtent. Or that match values in a vector; or all non NA values.

Usage

# S4 method for SpatRaster,missing
cells(x, y)
# S4 method for SpatRaster,numeric
cells(x, y)
# S4 method for SpatRaster,SpatVector
cells(x, y, method="simple", weights=FALSE, touches=is.lines(y))
# S4 method for SpatRaster,SpatExtent
cells(x, y)

Arguments

x

SpatRaster

y

SpatVector, SpatExtent, 2-column matrix representing points, numeric representing values to match, or missing

method

character. method for extracting values with points. The default is "simple", the alternative is "bilinear"

weights

logical. If TRUE and y has polygons, the fraction of each cell that is covered is returned as well

touches

logical. If TRUE, values for all cells touched by lines or polygons are extracted, not just those on the line render path, or whose center point is within the polygon. Not relevant for points

Value

matrix if y is a SpatVector, otherwise a vector.

Examples

# NOT RUN {
r <- rast(ncols=10, nrows=10)
values(r) <- 1:ncell(r)
r[c(1:25, 31:100)] <- NA
r <- ifel(r > 28, r + 10, r)

# get all non-NA cell numbers
cells(r)

# get cell numbers that match values
cells(r, c(28,38))

m <- cbind(x=c(0,10,-30), y=c(40,-10,20))
cellFromXY(r, m)

v <- vect(m)
cells(r, v)

f <- system.file("ex/lux.shp", package="terra")
v <- vect(f)
r <- rast(v)
#cv <- cells(r, v) 

#z  <- cells(r,ext(v))
#xy <- xyFromCell(r, z)
#plot(v)
#points(xy)

# }