% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/wosis-cache.R
\name{load_wosis_stratified_sample}
\alias{load_wosis_stratified_sample}
\title{Load the bundled WoSIS stratified RSG-balanced sample (v0.9.73)}
\usage{
load_wosis_stratified_sample()
}
\value{
A list with:
\itemize{
  \item \code{pedons}: list of 130 \code{PedonRecord} objects.
  \item \code{meta}: named integer vector of profiles per RSG.
  \item \code{pulled_on}: pull date.
  \item \code{endpoint}: ISRIC GraphQL endpoint URL.
  \item \code{filter}: pull strategy metadata.
  \item \code{n_pulled}: 130.
}
}
\description{
Returns a 130-profile snapshot of WoSIS GraphQL data pulled on
2026-05-09 with **stratified sampling by WRB Reference Soil Group**:
5 profiles per RSG across 26 RSGs (Acrisol, Andosol, Arenosol,
Calcisol, Cambisol, Chernozem, Cryosol, Ferralsol, Fluvisol,
Gleysol, Gypsisol, Histosol, Kastanozem, Leptosol, Luvisol,
Nitisol, Phaeozem, Planosol, Plinthosol, Podzol, Regosol,
Solonchak, Solonetz, Stagnosol, Umbrisol, Vertisol).
}
\details{
This is the recommended cache for global WRB benchmarking. Compared
to \code{load_wosis_sample()} (40 SA-only profiles, mostly Solonetz
and Phaeozem from Argentina), the stratified sample provides:

\itemize{
  \item Even coverage across the 26 most important RSGs.
  \item Richer analytical attributes -- CEC available on 26%,
        ECEC on 37%, BS on 14%, CaCO3 on 26% (vs ~0% for those
        in the SA snapshot).
  \item Geographic diversity (Angola, Brazil, USA, China, Russia,
        South Africa, Indonesia, Argentina, etc.).
}

First-ever benchmark on this sample (soilKey v0.9.73, full v0.9.69-72
fallback stack):
\itemize{
  \item Overall top-1 accuracy: 16.2\\% (n = 130)
  \item Histosol 100\\%, Arenosol 80\\%, **Leptosol 80\\%** (lifted
        from 20\\% baseline by v0.9.66 leptic rock-evidence gate),
        Cambisol 60\\%, Calcisol 40\\%
  \item 18 RSGs at 0\\% recall -- limited by data WoSIS does not
        expose (Munsell colours, base saturation, sodium for
        Solonetz, slickensides for Vertisols, etc.). Documented
        data ceiling.
}

For the live API, call \code{run_wosis_benchmark_graphql()} or
the \code{read_wosis_profiles_graphql(wrb_rsg = "...", n_max = N)}
helper (small RSG-filtered queries are tractable; large unfiltered
pulls time out as of 2026-05).
}
\section{Reference}{

  Batjes, N. H., Ribeiro, E., van Oostrum, A. (2020). Standardised
  soil profile data to support global mapping and modelling
  (WoSIS snapshot 2019). \emph{Earth System Science Data}, 12,
  299-320. \doi{10.5194/essd-12-299-2020}.
}

\examples{
\donttest{
s <- try(load_wosis_stratified_sample(), silent = TRUE)
if (!inherits(s, "try-error")) {
  length(s$pedons)
  table(vapply(s$pedons, function(p) p$site$wosis_rsg, character(1)))
}
}

}
