R: segregate

segregate {terra} | R Documentation

## 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 signature '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

    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)

[Package terra version 1.3-22 Index]