R: Histogram

hist {terra} | R Documentation

## Histogram

### Description

Create a histogram of the values of a SpatRaster. For large datasets a sample of `maxcell` is used.

### Usage

    ## S4 method for signature 'SpatRaster'
    hist(x, layer, maxcell=1000000, plot=TRUE, main, ...)

### Arguments

`x` | SpatRaster
`layer` | integer (or character) to indicate layer number (or name). Can be used to subset the layers to plot in a multilayer SpatRaster
`maxcell` | integer. To regularly sample very large objects
`plot` | logical. Plot the histogram or only return the histogram values
`main` | character. Main title(s) for the plot. Default is the value of `names`
`...` | additional arguments. See `hist`

### Value

This function is principally used for plotting a histogram, but it also returns an object of class "histogram" (invisibly if `plot=TRUE`).

### See Also

`pairs, boxplot`

### Examples

    r1 <- r2 <- rast(nrows=50, ncols=50)
    values(r1) <- runif(ncell(r1))
    values(r2) <- runif(ncell(r1))
    rs <- r1 + r2
    rp <- r1 * r2

    opar <- par(no.readonly =TRUE)
    par(mfrow=c(2,2))
    plot(rs, main='sum')
    plot(rp, main='product')
    hist(rs)
    a <- hist(rp)
    a
    x <- c(rs, rp, sqrt(rs))
    hist(x)
    par(opar)

[Package terra version 1.3-22 Index]