% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/benchmark-suite.R
\name{run_all_benchmarks}
\alias{run_all_benchmarks}
\title{Run the full soilKey benchmark suite and (optionally) write a report}
\usage{
run_all_benchmarks(
  datasets = "auto",
  paths = NULL,
  max_n = 300L,
  level = "order",
  report_path = NULL,
  verbose = TRUE
)
}
\arguments{
\item{datasets}{\code{"auto"} (default) detects available datasets;
otherwise any subset of \code{c("bdsolos", "febr", "kssl",
"lucas_esdb", "redape")}, the literal \code{"canonical"} (only the
fixture sanity row), or \code{"all"} (every dataset regardless of
availability -- absent ones are skipped).}

\item{paths}{Named list of dataset paths (see
\code{\link{benchmark_unified}}). \code{NULL} uses the package
defaults (override the root via
\code{options(soilKey.benchmark_root = "...")}).}

\item{max_n}{Cap on pedons per dataset (keeps the run fast). Default 300.}

\item{level}{Comparison level forwarded where supported (currently the
suite reports at \code{"order"} / top level).}

\item{report_path}{File to write the Markdown report to, \code{TRUE} to
auto-name one under \code{inst/benchmarks/reports/}, or \code{NULL}
(default) for no file.}

\item{verbose}{Print progress.}
}
\value{
Invisibly, a list with \code{summary} (data.frame: dataset, system,
        n_compared, accuracy), \code{per_system} (pooled), \code{raw}
        (full \code{benchmark_unified} output), \code{weak} (zero-recall
        classes) and \code{config}.
}
\description{
Auto-detects which reference datasets are available locally, runs each via
\code{\link{benchmark_unified}}, adds the offline canonical sanity row and
the AfSP sample when present, and returns a tidy accuracy summary. When
\code{report_path} is given, a consolidated Markdown report is written.
}
\examples{
\dontrun{
res <- run_all_benchmarks(max_n = 250,
                          report_path = TRUE)
res$summary
}
}
\seealso{
\code{\link{benchmark_unified}}, \code{\link{benchmark_redape}}.
}
