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:
Arguments
- d
a
data.frameobject, 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()