R: Dimensions of a SpatRaster or SpatVector and related objects

dimensions {terra} | R Documentation

## Dimensions of a SpatRaster or SpatVector and related objects

### Description

Get the number of rows (`nrow`), columns (`ncol`), cells (`ncell`), layers (`nlyr`), sources (`nsrc`), the size `size` (`nlyr(x)*ncell(x)`), or spatial resolution of a SpatRaster.

`length` returns the number of sub-datasets in a SpatRasterDataset or SpatVectorCollection.

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 signature 'SpatRaster'
    ncol(x)

    ## S4 method for signature 'SpatRaster'
    nrow(x)

    ## S4 method for signature 'SpatRaster'
    nlyr(x)

    ## S4 method for signature 'SpatRaster'
    ncell(x)

    ## S4 method for signature 'SpatRaster'
    nsrc(x)

    ## S4 replacement method for signature 'SpatRaster,numeric'
    ncol(x)<-value

    ## S4 replacement method for signature 'SpatRaster,numeric'
    nrow(x)<-value

    ## S4 replacement method for signature 'SpatRaster,numeric'
    nlyr(x)<-value

    ## S4 method for signature 'SpatRaster'
    res(x)

    ## S4 replacement method for signature 'SpatRaster,numeric'
    res(x)<-value

    ## S4 method for signature 'SpatRaster'
    xres(x)

    ## S4 method for signature 'SpatRaster'
    yres(x)

    ## S4 method for signature 'SpatVector'
    ncol(x)

    ## S4 method for signature 'SpatVector'
    nrow(x)

    ## S4 method for signature '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

### Value

integer

### See Also

ext

### Examples

    r <- rast()
    ncol(r)
    nrow(r)
    nlyr(r)
    dim(r)
    nsrc(r)
    ncell(r)

    rr  <- c(r,r)
    nlyr(rr)
    nsrc(rr)
    ncell(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)

[Package terra version 1.4-22 Index]