ext: Create, get or set a SpatExtent

Description

Get a SpatExtent of a SpatRaster, SpatVector, or other spatial objects. Or create a SpatExtent from a vector (length=4; order=xmin, xmax, ymin, ymax)

You can set the extent of a SpatRaster, but you cannot set the extent of a SpatVector (see rescale for that). See set.ext to set the extent in place.

Usage

# S4 method for SpatRaster
ext(x, cells=NULL)
# S4 method for SpatVector
ext(x)
# S4 method for numeric
ext(x, ..., xy=FALSE)
# S4 method for SpatRaster,SpatExtent
ext(x)<-value
# S4 method for SpatRaster,numeric
ext(x)<-value

Value

A SpatExtent object.

Arguments

x: SpatRaster, SpatVector, numeric vector of length four (xmin, xmax, ymin, ymax), or missing (in which case the output is the global extent in lon-lat coordinates)
cells: positive integer (cell) numbers to subset the extent to area covered by these cells
value: SpatExtent, or numeric vector of length four (xmin, xmax, ymin, ymax)
...: if x is a single numeric value, additional numeric values for xmax, ymin, and ymax
xy: logical. Set this to TRUE to indicate that coordinates are in (xmin, ymin, xmax, ymax) order, instead of in the terra standard order of (xmin, xmax, ymin, ymax)

Examples

Run this code

ext()

r <- rast()
e <- ext(r)
as.vector(e)
as.character(e)

ext(r) <- c(0, 2.5, 0, 1.5)
r
er <- ext(r)

round(er)
# go "in"
floor(er)
# go "out"
ceiling(er)

ext(r) <- e

Run the code above in your browser using DataLab