% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/benchmark-kssl-gpkg.R
\name{canonicalise_kst13ed_gg}
\alias{canonicalise_kst13ed_gg}
\title{Canonicalise a USDA Great Group label to a KST 13ed-compatible key}
\usage{
canonicalise_kst13ed_gg(gg)
}
\arguments{
\item{gg}{Character vector of Great Group names (lower case, no
whitespace).}
}
\value{
Character vector of canonical keys. Unmapped names pass
        through. NA stays NA. Empty input returns empty vector.
}
\description{
Maps both obsolete (pre-KST 13ed) and modern Great Group names to a
single canonical key, so that direct equality between predicted and
reference Great Group names ignores edition-driven renaming. Names
that have no known mapping pass through unchanged.
}
\details{
Examples of the canonicalisation (each pair is rendered equivalent):
\itemize{
  \item \code{"haplaquolls"} (KST 8) === \code{"endoaquolls"} (KST 13ed)
  \item \code{"pellusterts"} (KST 8) === \code{"hapluderts"} (KST 13ed)
  \item \code{"camborthids"} (KST 8) === \code{"haplocambids"} (KST 13ed)
  \item \code{"vitrandepts"} (KST 8) === \code{"vitrudands"} (KST 13ed)
}
}
\references{
Soil Survey Staff (2022), Keys to Soil Taxonomy 13ed,
            Ch 4 (Order keys); previous editions for the obsolete
            names.
}
