terra (version 0.8-5)

hist: Histogram

Description

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

Usage

# S4 method for 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

# NOT RUN {
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)
# }