simplifyColorData: Simplify Color Data by ID

View source: R/simplifyColorData.R

simplifyColorDataR Documentation

Simplify Color Data by ID

Description

Simplify multiple Munsell color observations associated with each horizon.

This function is mainly intended for the processing of NASIS pedon/horizon data which may or may not contain multiple colors per horizon/moisture status combination. simplifyColorData will "mix" multiple colors associated with horizons in d, according to IDs specified by id.var, using "weights" (area percentages) specified by the wt argument to mix_and_clean_colors.

Note that this function doesn't actually simulate the mixture of pigments on a surface, rather, "mixing" is approximated via weighted average in the CIELAB colorspace.

The simplifyColorData function can be applied to data sources other than NASIS by careful use of the id.var and wt arguments. However, d must contain Munsell colors split into columns named "colorhue", "colorvalue", and "colorchroma". In addition, the moisture state ("Dry" or "Moist") must be specified in a column named "colormoistst".

The mix_and_clean_colors function can be applied to arbitrary data sources as long as x contains sRGB coordinates in columns named "r", "g", and "b". This function should be applied to chunks of rows within which color mixtures make sense.

Examples:

Usage

simplifyColorData(d, id.var = "phiid", wt = "colorpct", bt = FALSE)

Arguments

d

a data.frame object, typically returned from NASIS, see details

id.var

character vector with the name of the column containing an ID that is unique among all horizons in d

wt

a character vector with the name of the column containing color weights for mixing

bt

logical, should the mixed sRGB representation of soil color be transformed to closest Munsell chips? This is performed by aqp::col2Munsell()

Author(s)

D.E. Beaudette


soilDB documentation built on Sept. 11, 2024, 8:28 p.m.