50% off: Unlimited data and AI learning.
State of Data and AI Literacy Report 2025

rcaiman (version 1.2.2)

colorfulness: Quantify colorfulness

Description

Quantify the colorfulness of an image

Usage

colorfulness(caim, m = NULL)

Value

A numeric vector of length one.

Arguments

caim

SpatRaster. The return of a call to read_caim() or read_caim_raw().

m

SpatRaster. A mask. For hemispherical photographs, check mask_hs(). Default (NULL) is the equivalent to enter !is.na(caim$Red).

Details

Quantify the colorfulness of an sRGB image using a bidimensional space formed by the green/red and the blue/yellow axes of the CIE LAB space, symbolized with A and B, respectively. The colorfulness index (CI) is defined as

CI=AoAp100,

where Ao and Ap are the observed and potential area of the AB plane. Ao refers to the colors from the image while Ap to the colors from the whole sRGB cube.

References

See Also

Other Tool Functions: correct_vignetting(), defuzzify(), extract_dn(), extract_feature(), extract_rl(), extract_sky_points_simple(), extract_sky_points(), extract_sun_coord(), find_sky_pixels_nonnull(), find_sky_pixels(), masking(), optim_normalize(), percentage_of_clipped_highlights(), read_bin(), read_caim_raw(), read_caim(), write_bin(), write_caim()

Examples

Run this code
caim <- read_caim() %>% normalize()
colorfulness(caim)

Run the code above in your browser using DataLab