---
id: "soil_horizon"
kind: "datatype"
status: "draft"
is_pii: false
name: "Soil horizon designation"
regexp: "^\\d?(?:[OPAEBCDRLHMW]|AB|AE|AC|BA|BC|BE|CB|EB|[AB]/[BC])\\d{0,2}(?:[BCD]\\d?)?[a-z]{0,3}\\d?$"
categories: ["environment", "science"]
langs: ["common"]
quality: 90
url: "https://registry.apicrafter.io/datatype/soil_horizon"
---

# Soil horizon designation (`soil_horizon`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Designation of a soil horizon in a soil profile description: a master horizon letter (O, P, A, E, B, C, D, R; FAO and WRB also L, H, M, W), optionally a transitional combination (AB, BC), a number of a subdivision (A1, A2, B21; A11 and A12 in the Australian Soil and Land Survey Field Handbook), lower case suffixes of subordinate properties (Ap, Bt, Bw, Bk2) and a leading number of a lithological discontinuity (2C). Soviet and Russian profile descriptions run the designations of a transitional horizon together (B2C1, A2B, B1C, CD) and call the forest litter A0. Single letters are horizons only in a horizon field.

- Parent datatype: [`category`](https://registry.apicrafter.io/datatype/category.md)
- Personal data (PII): no
- Categories: Environment (protected areas, biodiversity, water, weather, emissions, waste) (environment), Scientific (science)
- Countries: global
- Languages: Common to most languages (common)
- Classification: categorical

## Detection

Regular expression (Python `re`):

```
^\d?(?:[OPAEBCDRLHMW]|AB|AE|AC|BA|BC|BE|CB|EB|[AB]/[BC])\d{0,2}(?:[BCD]\d?)?[a-z]{0,3}\d?$
```

## Examples

- `A1` — Surface mineral horizon, Australian notation
- `A12` — Second subdivision of the A1 horizon
- `B21` — Upper part of the B2 horizon
- `Bt` — B horizon with illuvial clay (FAO)
- `2C` — C horizon below a lithological discontinuity
- `B2C1` — Transitional horizon in Soviet notation, soil profile database of the Armenian Soil Information System (Horizon_in)
- `A0` — Forest litter in Soviet notation
- `A11 sandy loam` (invalid example) — Horizon with a texture

## Metacrafter rules

1 rules: 1 match the field name, 0 match values.

- `soilhorizonbyname` (field, `common/environment.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Обозначение почвенного горизонта

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Soil_horizon>
- doc: <https://www.fao.org/3/a0541e/a0541e.pdf>
- doc: <https://www.publish.csiro.au/book/8129>

## Quality

Score 90/100. Missing: mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/soil_horizon.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/environment/soil_horizon.yaml>
