terra (version 1.1-17)

expand: Expand

Description

Expand the extent of a SpatRaster. See crop if you (also) want to remove rows or columns.

You can also enlarge a SpatExtent with this method, or with algebraic notation (see examples)

Usage

# S4 method for SpatRaster
expand(x, y, filename="", overwrite=FALSE, ...) 
# S4 method for SpatExtent
expand(x, y)

Arguments

x

SpatRaster or SpatExtent

y

If x is a SpatRaster, y should be a SpatExtent, or an object from which it can be extracted (such as SpatRaster and SpatVector objects). Alternatively, you can provide two postive integers indicating the number of rows and columns that need to be added at each side (or a single postive integer when the number of rows and columns is equal)

If x is a SpatExtent, y should be a numeric vector of 1, 2, or 4 elements

filename

character. Output filename

overwrite

logical. If TRUE, filename is overwritten

...

additional arguments for writing files as in writeRaster

Value

SpatRaster or SpatExtent

See Also

crop, merge, ext

Examples

# NOT RUN {
r <- rast(xmin=-150, xmax=-120, ymin=30, ymax=60, ncol=36, nrow=18)
values(r) <- 1:ncell(r)
e <- ext(-180, -100, 40, 70)
re <- expand(r, e)

# expand with a number of rows and columns (at each side)
re2 <- expand(r, c(2,10))

# SpatExtent
e <- ext(r)
e
expand(e, 10)
expand(e, c(10, -10, 0, 20))
# }