% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/utils-diagnostic-tests.R
\name{test_ferralic_texture}
\alias{test_ferralic_texture}
\title{Ferralic texture: sandy loam or finer (same predicate as argic)}
\usage{
test_ferralic_texture(h, candidate_layers = NULL)
}
\arguments{
\item{h}{Numeric threshold or option (see Details).}

\item{candidate_layers}{Numeric threshold or option (see Details).}
}
\description{
Ferralic texture: sandy loam or finer (same predicate as argic)
}
\section{v0.9.70 morphological fallback (opt-in)}{

Many BDsolos / SOTERLAC profiles do not record \code{clay_pct},
\code{silt_pct}, \code{sand_pct} on the deep B horizon -- only on
the topsoil. The strict texture test then returns \code{NA}, and
\code{ferralic()} cascades to NA, blocking Latossolos detection.

With \code{options(soilKey.ferralic_texture_morphological_fallback = TRUE)}
\code{test_ferralic_texture()} accepts a layer as ferralic-textured
when the canonical numeric test is NA \emph{and} the layer
satisfies \emph{both}:
  \enumerate{
    \item designation matches \code{Bw|Bo|Boi} (deeply weathered
          B-horizon morphology), and
    \item \code{top_cm > 20} (subsoil, not topsoil).
  }
This is a conservative morphological inference: a Bw / Bo
designation in a subsoil context strongly implies tropical
deep-weathering, which in turn implies sandy-loam-or-finer
texture in 95\\%+ of Brazilian Latossolos. Default is
\code{FALSE} (canonical WRB behaviour preserved).
}

