terra (version 1.0-7)

dimensions: Dimensions of a SpatRaster or SpatVector and related objects

Description

Get the number of rows (nrow), columns (ncol), cells (ncell), layers (nlyr), sources (nsrc) or the spatial resolution of a SpatRaster; (length) returns the number of sub-datasets in a SpatRasterDataset or SpatVectorCollection.

The size of a SpatRaster x is ncell(x) * nlyr(x). For a SpatVector length(x) is the same as nrow(x).

You can also set the number of rows or columns or layers. When setting dimensions, all cell values are dropped.

Usage

# S4 method for SpatRaster
ncol(x)
# S4 method for SpatRaster
nrow(x)
# S4 method for SpatRaster
nlyr(x)
# S4 method for SpatRaster
ncell(x)
# S4 method for SpatRaster
size(x)
# S4 method for SpatRaster
nsrc(x)
# S4 method for SpatRaster
res(x)
ncol(x, ...) <- value
nrow(x, ...) <- value
nlyr(x, ...) <- value
res(x) <- value
# S4 method for SpatRaster
xres(x)
# S4 method for SpatRaster
yres(x)
# S4 method for SpatVector
ncol(x)
# S4 method for SpatVector
nrow(x)
# S4 method for SpatVector
size(x, ...)
# S4 method for SpatVector
length(x)

Arguments

x

SpatRaster or SpatVector or related objecs

value

For ncol and nrow: positive integer. For res: one or two positive numbers

...

additional arguments. None implemented

Value

integer

See Also

ext

Examples

# NOT RUN {
r <- rast()
ncol(r)
nrow(r)
nlyr(r)
dim(r)
nsrc(r)
ncell(r)
size(r)

rr  <- c(r,r)
nlyr(rr)
nsrc(rr)
ncell(rr)
size(rr)

nrow(r) <- 18
ncol(r) <- 36
# equivalent to
dim(r) <- c(18, 36) 

dim(r)
dim(r) <- c(10, 10, 5)
dim(r)

xres(r)
yres(r)
res(r)

res(r) <- 1/120
# different xres and yres
res(r) <- c(1/120, 1/60)
# }