outOfDR: Get the percentages of pixels that are out of the dynamic...

In GastonMauroDiaz/caiman: Canopy Image Analysis

Description

Get the percentages of pixels that are out of the dynamic range, i.e., the under and overexposure pixels of an image.

Usage

outOfDR(x, channel = NULL, mask = NULL, returnImages = FALSE)

## S4 method for signature 'CanopyPhoto'
outOfDR(x, channel = NULL, mask = NULL, returnImages = FALSE)

Arguments

x	CanopyPhoto.
channel	One-length character, "Red", "Green" or "Blue".
mask	BinImage. Default value NULL means that all the pixels will be taking into account in the computations. If you provide a BinImage, it must have the same extent and resolution of x. All pixels from the image covered by pixels of the mask with value 1 will be taking into account in the computations.
returnImages	logical. Default is FALSE, see Value.

Details

This algorithm classifies the pixels of x that start and end the dynamic range. These pixels are called under or overexposed because is highly probable that they are out of the dynamic range and not just in the limits.

todo

Value

By default, it returns a vector of length 3. If returnImages = TRUE, then it returns a RasterStack that has two binary layers in which 1 means under/overexposure.

todo

See Also

normalize, colorfulness.

Examples

x <- loadPhoto()
x <- normalize(x, 0, 255)
z <- makeZimage(ncol(x), lensPolyCoef())
m <- doMask(z)

outOfDR(x, mask = m)
plot(outOfDR(x, mask = m,  returnImages = TRUE))

outOfDR(x, "Blue", mask = m)
plot(outOfDR(x, "Blue", mask = m,  returnImages = TRUE))

GastonMauroDiaz/caiman documentation built on Jan. 22, 2022, 4:43 a.m.