% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/perturbation-scales.R
\name{get_perturbation_scale}
\alias{get_perturbation_scale}
\title{Monte-Carlo perturbation scale for an evidence grade}
\usage{
get_perturbation_scale(grade = c("A", "B", "C", "D", "E"))
}
\arguments{
\item{grade}{One of \code{"A"} (measured), \code{"B"} (spectra-predicted),
\code{"C"} (prior-inferred), \code{"D"} (VLM-extracted) or
\code{"E"} (user-assumed).}
}
\value{
A list with three elements: \code{pct} (the half-width of the
       multiplicative perturbation, applied to most numeric attributes),
       \code{ph_abs} (the half-width of the additive perturbation applied
       to pH columns) and \code{munsell_abs} (the additive half-width for
       Munsell value / chroma columns).
}
\description{
Returns the noise magnitudes used by \code{\link{classify_with_uncertainty}}
for a cell of the given evidence grade. A measurement (grade A) is
perturbed only slightly; a user-assumed value (grade E) is perturbed
heavily, reflecting how little is actually known about it.
}
\examples{
get_perturbation_scale("A")$pct   # 0.03 -- measured values barely move
get_perturbation_scale("E")$pct   # 0.30 -- assumptions move a lot
}
