% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/canonical-references.R
\name{canonical_reference}
\alias{canonical_reference}
\title{Load a canonical reference dataset from soilKey or SoilTaxonomy}
\usage{
canonical_reference(
  name = c("WRB_4th_2022", "ST_criteria_13th", "ST_features"),
  prefer_pkg = TRUE
)
}
\arguments{
\item{name}{One of \code{"WRB_4th_2022"}, \code{"ST_criteria_13th"},
\code{"ST_features"}.}

\item{prefer_pkg}{If \code{TRUE} (default), prefer the installed
SoilTaxonomy package over the vendored copy. Set to
\code{FALSE} to force the vendored copy (e.g. for
reproducibility of a specific soilKey release).}
}
\value{
The dataset as the original R object (list or data.frame).
}
\description{
Resolution order:
\enumerate{
  \item If the \code{SoilTaxonomy} package is installed AND the
        \code{prefer_pkg} argument is \code{TRUE} (default), load
        the dataset from the installed package (always fresh).
  \item Otherwise, load from the vendored copy at
        \code{inst/extdata/canonical/<name>.rda}.
}
}
\seealso{
\code{\link{wrb2022_canonical}}, \code{\link{kst13_canonical}},
  \code{\link{st_features_canonical}}.
}
