hist: Histogram

In terra: Spatial Data Analysis

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, maxnl=16, main, ...)

Arguments

x	SpatRaster
layer	positive integer or character to indicate layer numbers (or names). If missing, all layers up to maxnl are used
maxcell	integer. To regularly sample very large objects
plot	logical. Plot the histogram or only return the histogram values
maxnl	positive integer. The maximum number of layers to use. Ignored if layer is not missing
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)

terra documentation built on Oct. 13, 2023, 5:08 p.m.