merge {Orcs}

Merge Objects Stored in a List

Description

Complementing existing merge methods, e.g. terra::merge() for ⁠Spat*⁠ objects, which typically work with one or two inputs only, this function accepts a list of objects that are to be merged together.

Usage

## S4 method for signature 'list,missing'
merge(x, by = 1L, all = TRUE, ...)

Arguments

x

A list of objects of the same type (e.g. ⁠Spat*⁠ or data.frame).

by, all

See merge.data.frame(). Ignored if data stored in 'x' is not of class data.frame.

...

Additional arguments passed to the underlying merge method (e.g. arguments compatible with terra::merge() and terra::writeRaster() for ⁠Spat*⁠ input). Ignored if data stored in 'x' is of class data.frame.

Value

A merged object (e.g. a new ⁠Spat*⁠ object with a larger spatial extent).

Author(s)

Florian Detsch

See Also

do.call(), Reduce().

Examples

## `SpatRaster` input
dms = list.files(system.file("extdata", package = "Orcs")
                 , pattern = "ASTGTM2.*dem.tif$", full.names = TRUE)
dms = lapply(dms, terra::rast)

dem = merge(dms[3:4])
terra::plot(dem)

## data.frame input
mrg = merge(list(iris, iris, iris)
            , by = c("Species", "Sepal.Length", "Petal.Width"))
head(mrg)