% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/benchmark-febr-loader.R
\name{load_febr_pedons}
\alias{load_febr_pedons}
\title{Load the Embrapa FEBR superconjunto into a list of PedonRecords}
\usage{
load_febr_pedons(
  path,
  head = NULL,
  require_classification = c("sibcs", "any", "wrb", "usda"),
  verbose = TRUE
)
}
\arguments{
\item{path}{Path to \code{febr-superconjunto.txt}.}

\item{head}{Optional integer; if not \code{NULL}, return only the
first \code{head} unique profiles after grouping.}

\item{require_classification}{One of \code{c("any", "sibcs", "wrb",
"usda")}. Default \code{"sibcs"}: drop profiles whose
chosen classification is NA. \code{"any"} keeps profiles
with at least one of the three.}

\item{verbose}{If \code{TRUE} (default), summarises the load.}
}
\value{
A list of \code{\link{PedonRecord}} objects.
}
\description{
Reads the FEBR \code{febr-superconjunto.txt} export (one row per
camada / horizon, with the profile-level classification denormalised
onto every row), groups rows by \code{(dataset_id, observacao_id)},
and returns a list of \code{\link{PedonRecord}} objects with all
three reference taxa attached on \code{$site}: \code{reference_sibcs}
(raw FEBR string, e.g. "LATOSSOLO VERMELHO"),
\code{reference_usda}, \code{reference_wrb}.
}
\details{
Drops profiles whose \code{taxon_sibcs} is NA (no usable reference).
Drops camadas with no horizon-depth information (no
\code{profund_sup} / \code{profund_inf}).
}
