% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/benchmark-loaders.R
\name{load_kssl_pedons}
\alias{load_kssl_pedons}
\title{Load NCSS / KSSL pedons with reference USDA Soil Taxonomy classification}
\usage{
load_kssl_pedons(pedon_csv, layer_csv, head = NULL, verbose = TRUE)
}
\arguments{
\item{pedon_csv}{Path to the pedon-level CSV (one row per profile,
with site-level metadata + classification).}

\item{layer_csv}{Path to the layer-level CSV (one row per horizon,
with horizon properties).}

\item{head}{Optional integer; if not \code{NULL}, returns only the
first \code{head} pedons (useful for parser validation).}

\item{verbose}{If \code{TRUE} (default), emits a summary of the
load.}
}
\value{
A list of \code{\link{PedonRecord}} objects.
}
\description{
Reads the KSSL pedon CSV export (typically named
\code{NCSS_Pedon_Layer.csv} or similar) plus the lab-data CSV, joins
on \code{pedon_key}, and assembles a list of \code{PedonRecord}
objects. The published USDA Soil Taxonomy classification (from the
\code{Series} or \code{Subgroup} field) is attached as
\code{pedon$site$reference_usda}.
}
\details{
KSSL is the de-facto standard for validating USDA Soil Taxonomy keys
(~50k profiles, lab-grade analytical data, professional pedon
descriptions). Get the export from the USDA-NRCS NCSS Lab Data Mart
(\code{ncsslabdatamart.sc.egov.usda.gov}).
}
