terra (version 1.5-12)

segregate: segregate

Description

Create a SpatRaster with a layer for each class (value, or subset of the values) in the input SpatRaster. For example, if the input has vegetation types, this function will create a layer (presence/absence; dummy variable) for each of these classes. Classes and cell values are always truncated to integers.

This is called "one-hot encoding" or "dummy encoding" (for a dummy encoding scheme you can remove (any) one of the output layers as it is redundant).

Usage

# S4 method for SpatRaster
segregate(x, classes=NULL, keep=FALSE, other=0, filename="", ...)

Arguments

x

SpatRaster

classes

numeric. The values (classes) for which layers should be made. If NULL all classes are used

keep

logical. If TRUE, cells that are of the class represented by a layer get that value, rather than a value of 1

other

numeric. Value to assign to cells that are not of the class represented by a layer

filename

character. Output filename

...

additional arguments for writing files as in writeRaster

Value

SpatRaster

Examples

# NOT RUN {
r <- rast(nrows=5, ncols=5)
values(r) <- rep(c(1:4, NA), each=5)
b <- segregate(r)
bb <- segregate(r, keep=TRUE, other=NA)
# }