colorfulness: Quantify colorfulness

In GastonMauroDiaz/rcaiman: CAnopy IMage ANalysis

Quantify colorfulness

Description

Quantify the colorfulness of an image

Usage

colorfulness(caim, m = NULL)

Arguments

caim	SpatRaster. The output of read_caim() or read_caim_raw().
m	SpatRaster. A mask. For hemispherical photographs, check select_sky_vault_region(). 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 = \dfrac{A_o}{A_p} \cdot 100,

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

Value

A numeric vector of length one.

Note

An early version of this function was used in \insertCiteMartin2020;textualrcaiman.

References

\insertAllCited

See Also

Other Tool Functions: calc_oor_index(), calc_spherical_distance(), correct_vignetting(), defuzzify(), display_caim(), extract_dn(), extract_feature(), extract_rel_radiance(), extract_sky_points(), extract_sun_coord(), find_sky_pixels(), masking(), optim_dist_to_black(), optim_normalize(), percentage_of_clipped_highlights(), read_bin(), read_caim(), read_caim_raw(), read_ootb_sky_model(), sor_filter(), vicinity_filter(), write_bin(), write_caim(), write_ootb_sky_model()

Examples

caim <- read_caim() %>% normalize_minmax()
colorfulness(caim)

GastonMauroDiaz/rcaiman documentation built on April 14, 2025, 9:39 a.m.