Huumus — Orgaanilise horisondi parser¶
Mis on Huumuse väli?¶
Huumuse (huumus) väli kirjeldab mulla orgaanilist horisonti: selle tüüpi, lagunemisastet ja tüsedust. Iga mullakaardi polügoon võib sisaldada kuni nelja mullaüksust (eraldatud tühikutega) ning iga üksus võib sisaldada eraldi näitajaid mitme huumuse kihi kohta (eraldatud sümboliga /). Polügoonis võivad olla eraldi näitajad haritava ja loodusliku maa kohta (eraldatud tühikuga või tühik-kaldkriips-tühikuga /).
Lihtne näide:
th15/h5 t₂20
See kodeerib kaks mullaüksust:
| Üksus | Tähistus | Tähendus |
|---|---|---|
| 1 (ülemine kiht) | th15 |
Toorhuumus, tüsedus 15 cm |
| 1 (alumine kiht) | h5 |
Mineraalne huumushorisont, tüsedus 5 cm |
| 2 | t₂20 |
Keskmiselt lagunenud turvas, tüsedus 20 cm |
Tähistussüsteem¶
Orgaanilise horisondi tüübid¶
| Tähistus | Tüüp | Eestikeelne nimetus | Kirjeldus |
|---|---|---|---|
th[sügavus] |
Toorhuumus | Toorhuumus | Osaliselt lagunenud. Alati > 10 cm. |
t[aste][sügavus] |
Turvas | Turvas | Lagunemisaste 1 (nõrgalt), 2 (keskmiselt) või 3 (tugevalt). Alati > 10 cm. |
h[sügavus] |
Huumus | Huumus | Mineraalne huumushorisont (mull). |
[aste][sügavus] |
Kõdu | Metsakõdu | Lagunemisaste 1–3. Tüsedus ≤ 10 cm. |
0 |
Puudub | Puudub | Orgaaniline pindmine kiht puudub. |
Lagunemisaste¶
Turba ja metsakõdu puhul tähistatakse orgaanilise aine lagunemisastet alaindeksiga:
| Alaindeks | ASCII | Aste | Kirjeldus |
|---|---|---|---|
| ₁ | 1 | I (nõrgalt lagunenud) | Fibric — taimsed struktuurid on veel tuvastatavad |
| ₂ | 2 | II (keskmiselt lagunenud) | Hemic — keskmiselt lagunenud |
| ₃ | 3 | III (tugevalt lagunenud) | Sapric — tugevalt humifitseerunud, amorfne |
Sügavuse tähistamine¶
Tüsedus märgitakse sentimeetrites kas üksikväärtusena või vahemikuna:
| Tähistus | Tähendus |
|---|---|
th15 |
Toorhuumus, tüsedus 15 cm |
th15-25 |
Toorhuumus, tüsedus 15 kuni 25 cm |
2₁ |
Metsakõdu, 1. aste, tüsedus 2 cm |
Sügavus tähistab horisondi tüsedust, mitte sügavust maapinnast.
Huumushorisondi kihid¶
Sümbol / mullaüksuse sees eraldab huumushorisondi erinevate kihtide näitajaid:
th15/h5
Vasakul pool /: toorhuumus 15 cm (ülemine kiht)
Paremal pool /: mineraalne huumus 5 cm (alumine kiht)
Kui on antud ainult üks väärtus (ilma /), on eristatud ainult üks kiht.
Metsakõdu kihi esinemine üksuses¶
Ühes üksuses eristatakse erineva lagunemisastmega metsakõdu kihid sümboliga +:
5₁+3₂
See tähendab: kõdukiht 1 (tüsedus 5 cm, 1. aste) paikneb kõdukihi 2 kohal (tüsedus 3 cm, 2. aste).
Sulud¶
Sulud ( ) üksuse või näitaja ümber tähistavad katkendlikku või ebaselgelt välja kujunenud üksust või kihti. Sulud eemaldatakse enne parsimist.
Väljundväljad¶
Parser väljastab ~96 tulpa iga mullapolügooni rea kohta. Indeksid 1–4 vastavad kuni neljale polügoonis esinevale mullaüksusele.
Kvaliteet ja päritolu¶
| Väli | Tüüp | Kirjeldus |
|---|---|---|
n_siffers |
int | Tühikutega eraldatud mullaüksuste arv selles polügoonis (0–4) |
parse_ok_h |
bool | True, kui kõik mullaüksused tuvastati. Kasutatakse kaardivaaturi veaülevaates koos parse_ok_s ja parse_ok_l veergudega. |
parse_error |
str | Semikooloniga eraldatud nimekiri tuvastamata märkidest; edukuse korral tühi |
Üksusepõhised väljad (×4) — säilitatud eelmisest versioonist¶
Iga üksuse numbri n kohta (1 kuni 4):
| Väli | Tüüp | Kirjeldus |
|---|---|---|
h_raw_n |
str | Algne sisendsõne selle üksuse kohta, täpselt nii nagu see kaardil esineb |
h_has_split_n |
bool | True, kui see üksus sisaldab mitu kihti / |
h_type_n |
str | Domineeriv orgaanilise horisondi tüüp (vt tabelit allpool) |
h_depth_min_n |
float | Kõige madalam horisondi alumine piir cm-tes (NaN, kui tüsedust pole märgitud) |
h_depth_max_n |
float | Kõige sügavam horisondi alumine piir cm-tes (võrdub h_depth_min-iga üksikväärtuse puhul) |
h_type väärtused:
| Väärtus | Tähendus |
|---|---|
"th" |
Toorhuumus |
"peat" |
Turvas (mis tahes lagunemisaste) |
"humus" |
Mineraalne huumushorisont (mull) |
"litter" |
Metsakõdu |
"none" |
Orgaaniline kiht puudub (0) |
"mixed" |
Selles üksuses on rohkem kui üks tüüp (prioriteet: th > peat > humus > litter > none) |
"unknown" |
Tuvastamata märk — kontrolli parse_error |
"" |
Üksuse pesa pole täidetud (vähem kui n üksust selles reas) |
UUS — Peamine huumus (phu) — 3 andmevälja × 4 mullaüksust¶
Peamiseks huumuseks loetakse terve huumuse valem, kui kaldkriipsu ei esine, või paremal pool kaldkriipsu (/) olev valemiosa ehk madalam kiht.
| Väli | Tüüp | Väärtused |
|---|---|---|
h_phu_type_n |
str | "th", "peat", "humus", "none", "unknown"; "" kui puudub |
h_phu_min_n |
float | Peamise huumuse kihi vähim sügavus cm-tes (kihi alumine piir) |
h_phu_max_n |
float | Peamise huumuse kihi suurim sügavus cm-tes (kihi alumine piir) |
UUS — Sekundaarne huumus (lhu) — 3 andmevälja × 4 mullaüksust¶
Sekundaarseks huumuseks loetakse vasakul pool kaldkriipsu (/) olev valemiosa ehk ülemine kiht (esineb ainult juhul, kui valemis on mitu huumuse kihti).
| Väli | Tüüp | Väärtused |
|---|---|---|
h_lhu_type_n |
str | sama, mis phu; "" kui puudub |
h_lhu_min_n |
float | Sekundaarse huumuse kihi vähim sügavus cm-tes (kihi alumine piir) |
h_lhu_max_n |
float | Sekundaarse huumuse kihi suurim sügavus cm-tes (kihi alumine piir) |
UUS — Kõdu kihid O1–O3 — 9 andmevälja × 4 mullaüksust¶
Kaldkriipsust vasakul pool olev valemiosa, järjestatud alumisest ülemiseni: 01 = madalaim ehk lagunenuima kõduga kiht, 03 = kõrgeim ehk vähim lagunenud kõduga kiht.
| Väli | Tüüp | Väärtused |
|---|---|---|
h_o1_deg_n |
str | Lagunemisaste kihis 01 (₁, ₂, ₃) või "" kui puudub |
h_o1_min_n |
float | Vähim sügavus cm-tes kihis O1 |
h_o1_max_n |
float | Suurim sügavus cm-tes kihis O1 |
h_o2_deg_n |
str | Lagunemisaste kihis O2 |
h_o2_min_n |
float | Vähim sügavus cm-tes kihis O2 |
h_o2_max_n |
float | Suurim sügavus cm-tes kihis O2 |
h_o3_deg_n |
str | Lagunemisaste kihis O3 |
h_o3_min_n |
float | Vähim sügavus cm-tes kihis O3 |
h_o3_max_n |
float | Suurim sügavus cm-tes kihis O3 |
UUS — Märgendid üksutes kohta — 3 välja × 4 üksust¶
| Väli | Tüüp | Väärtused |
|---|---|---|
h_has_depth_split_n |
bool | True kui esineb / (kaldkriips); st eristuvad sügavuskihid |
h_is_agri_forest_n |
bool | True kui esineb / (tühik-kaldkriips-tühik); st eristuvad haritava ja loodusliku maa üksused |
h_depth_total_n |
float | phu ja lhu sügavuste keskmiste summa; > 40 cm = suunata kontrolli? |
Struktureeritud andmed¶
| Väli | Tüüp | Kirjeldus |
|---|---|---|
huumus_json |
dict | Täielik struktureeritud parsimistulemus — üksuse- ja kihipõhised andmed, sh lagunemisaste, sügavus (min/max) ning mitme kihi esinemine üksuses. Andmebaasis salvestatud, kuid ei kuvata kaardivaaturi hüpikaknas. |
Parsimise kattuvus¶
Parser lahendab ligikaudu 97 % andmestiku unikaalsetest toorväärtustest (testitud ~31 800 unikaalse väärtuse peal). Lahendamata kirjed koondatakse vigade tabelisse (huumus_error_lookup), mida valdkonnaeksperdid täiendavad parandustega pärast iga töötlemistsüklit.
Näited¶
Näide 1 — lihtne toorhuumus:
Toores: "th15"
n_siffers=1, parse_ok=True
h_raw_1="th15", h_type_1="th"
h_depth_min_1=15.0, h_depth_max_1=15.0
h_has_split_1=False
h_phu_type_1="th", h_phu_min_1=15.0, h_phu_max_1=15.0
Näide 2 — levinuimas üksuses toorhuumus ja selle all huumus, teises üksuses turvas:
Toores: "th15/h5 t₂20"
n_siffers=2, parse_ok=True
Unit 1: h_raw_1="th15/h5", h_has_split_1=True
phu (right/lower): h_phu_type_1="humus", h_phu_min_1=5.0, h_phu_max_1=5.0
lhu (left/upper): h_lhu_type_1="th", h_lhu_min_1=15.0, h_lhu_max_1=15.0
Unit 2: h_raw_2="t₂20", h_has_split_2=False
phu: h_phu_type_2="peat", h_phu_min_2=20.0, h_phu_max_2=20.0
Näide 3 — kõdukihid huumuse peal:
Toores: "2₁+1₂/(5-10)"
n_siffers=1, parse_ok=True
h_raw_1="2₁+1₂/(5-10)", h_has_depth_split_1=True
phu (right/lower): h_phu_type_1="humus", h_phu_min_1=5.0, h_phu_max_1=10.0
O1 (bottom litter): h_o1_deg_1="₂", h_o1_min_1=1.0
O2 (top litter): h_o2_deg_1="₁", h_o2_min_1=2.0
!!! Märkus: "Kõdukihtide järjestus"
Kõdu kihid salvestatakse järjekorras alt üles: O1 on sügavaimal asuv ehk enim lagunenud kõduga kiht, O3 on kõrgeimal asuv ehk kõige vähem lagunenud kõduga kiht. In 2₁+1₂, 1 cm tüsedune 2. lagunemisastmega kõdukiht asub 2 cm tüseda 1. lagunemisastmega kõdukihi all, seega lahtikirjutatuna
O1 = aste ₂ (1 cm) ja
O2 = aste ₁ (2 cm).
Näide 4 — kõdukihid ilma huumuse kihita:
Toores: "2₁+2₂+4₃/0"
n_siffers=1, parse_ok=True
h_raw_1="2₁+2₂+4₃/0", h_has_depth_split_1=True
phu (right): h_phu_type_1="humus", h_phu_min_1=0.0, h_phu_max_1=0.0
O1 (bottom): h_o1_deg_1="₃", h_o1_min_1=4.0
O2 (middle): h_o2_deg_1="₂", h_o2_min_1=2.0
O3 (top): h_o3_deg_1="₁", h_o3_min_1=2.0
!!! Märkus: "Paremal pool on 0"
Kui paremal pool kaldkriipsu / (madalam kiht) esineb 0, siis see klassifitseeritakse kui peamine huumus 0 tüsedusega mitte "none". Nii eristub selline alumine huumushorisont täielikult puuduvast orgaanilise aine horisondist.
Näide 5 — haritava maa ja loodusliku maa huumushorisondi eristamine (legacy):
Toores: "25-28 / th20-30"
n_siffers=1, parse_ok=True
h_raw_1="25-28 / th20-30", h_is_agri_forest_1=True, h_has_depth_split_1=True
phu (right): h_phu_type_1="th", h_phu_min_1=20.0, h_phu_max_1=30.0
lhu (left): h_lhu_type_1="humus", h_lhu_min_1=25.0, h_lhu_max_1=28.0
Haritava ja loodusliku maa eristamise märgend
Tühik-kaldkriips-tühik kombinatsioon / märgib ära h_is_agri_forest = True (tõene) ning siis arvutatakse h_depth_total (kõikide kihtide sügavuste keskmiste summa). Väärtused > 40 cm märgendatakse käsitis kontrollimise jaoks, sest need võivad tähistada algsel paberkaardil ühes polügoonis esinenud haritava ja loodusliku maa huumusvalemite eristamist kaldkriipsuga (Alar Astoveri hinnang).
Näide 6 — neli lihtsat huumuse tüsedusvahemikku (neli mullaüksust):
Toores: "18-22 20-25 20-25 20-27"
n_siffers=4, parse_ok=True
Unit 1: h_phu_type_1="humus", h_phu_min_1=18.0, h_phu_max_1=22.0
Unit 2: h_phu_type_2="humus", h_phu_min_2=20.0, h_phu_max_2=25.0
Unit 3: h_phu_type_3="humus", h_phu_min_3=20.0, h_phu_max_3=25.0
Unit 4: h_phu_type_4="humus", h_phu_min_4=20.0, h_phu_max_4=27.0
Kõdukihtide tüseduste liitmine
Kui mitu kõdukihti on eraldatud sümboliga +, salvestab h_depth_min kõige õhema alamkihi ja h_depth_max kõige paksema. Täielik kihtide kaupa jaotus on saadaval väljas huumus_json.