% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/diagnostics-horizons-wrb-v033.R
\name{vertic_horizon}
\alias{vertic_horizon}
\title{Vertic horizon (WRB 2022 Ch 3.1)}
\usage{
vertic_horizon(
  pedon,
  min_clay = 30,
  min_thickness = 25,
  min_le_cm = 6,
  le_max_depth_cm = 100,
  min_crack_width_cm = 0.5
)
}
\arguments{
\item{pedon}{A \code{\link{PedonRecord}}.}

\item{min_clay}{Numeric threshold or option (see Details).}

\item{min_thickness}{Numeric threshold or option (see Details).}

\item{min_le_cm}{Minimum LE sum (cm) for the COLE-based path
(default 6, per KST 13ed Ch 16).}

\item{le_max_depth_cm}{Depth window (cm) for the COLE-based path
(default 100).}

\item{min_crack_width_cm}{Minimum shrink-swell crack width (cm) for the
field-crack path. Defaults to 0.5 (WRB/USDA); the SiBCS
\code{horizonte_vertico} wrapper passes 1.0 per Embrapa
(2018) Cap 2 p.73.}
}
\value{
A \code{\link{DiagnosticResult}} recording whether the diagnostic is present, the qualifying layers, and the supporting evidence.
}
\description{
Stricter than the vertic *properties*: the vertic *horizon* requires
\\>= 30\% clay throughout, slickensides at \\>= "common" level, AND
shrink-swell cracks \\>= 0.5 cm wide. Used by Vertisols. v0.9.19
adds an OR-alternative COLE-based linear-extensibility path:
summed (\code{cole_value * thickness}) over the upper 100 cm
\\>= 6 cm passes the diagnostic even when slickensides + cracks
are not recorded (KST 13ed Ch 16 LE alternative, p 343).
}
\section{v0.9.72 designation morphological inference (opt-in)}{

Field-described Brazilian Vertissolos profiles (e.g.\ the Embrapa
Redape curated dataset) encode vertic morphology via a \code{v}
master-letter modifier in the horizon designation (\code{Bv},
\code{Bvk1}, \code{Cv}, \code{Cvz}) without recording
\code{slickensides} class or \code{shrink_swell_cracks_cm} as
numeric inputs. With
\code{options(soilKey.vertic_designation_inference = TRUE)} the
function accepts a layer as vertic when the canonical and COLE
paths both fail or are NA AND the layer has \code{clay_pct >=
min_clay} AND its designation matches a \code{v} master-letter
modifier. Default is \code{FALSE}.
}

