% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/key-usda.R
\name{classify_usda}
\alias{classify_usda}
\title{Classify a pedon under USDA Soil Taxonomy (13th edition)}
\usage{
classify_usda(pedon, rules = NULL, on_missing = c("warn", "silent", "error"))
}
\arguments{
\item{pedon}{A \code{\link{PedonRecord}}.}

\item{rules}{Optional pre-loaded rule set.}

\item{on_missing}{One of \code{"warn"} (default), \code{"silent"},
\code{"error"}.}
}
\value{
A \code{\link{ClassificationResult}} with deepest-level
        taxon name. Each level's trace is in \code{$trace}.
}
\description{
Walks the canonical 4-level USDA key (Order -> Suborder ->
Great Group -> Subgroup) using YAML rule files at:
\itemize{
  \item \code{inst/rules/usda/key.yaml}: Order key (12 entries)
  \item \code{inst/rules/usda/suborders/<order>.yaml}
  \item \code{inst/rules/usda/great-groups/<order>.yaml}
  \item \code{inst/rules/usda/subgroups/<order>.yaml}
}
}
\details{
Stops at the deepest level for which a YAML rule file is
available (e.g. v0.8.x: Gelisols full Path C; other 11 Orders at
Order level only).
}
\references{
Soil Survey Staff (2022). Keys to Soil Taxonomy, 13th
  edition. USDA Natural Resources Conservation Service.
}
