Väljade viide¶

Täielik nimekiri kõigist väljundtulpadest, mida kolm parserit toodavad. Väljad kirjutatakse PostgreSQL-i tabelisse output_review ja on kättesaadavad ka REST API lõpp-punktide kaudu.

Siffer — Mullaliikide koodid¶

Need 7 tulpa luuakse Šifri parseri poolt iga polügooni rea kohta.

Väli	Tüüp	Väärtused / vahemik	Tähendus	Näide
`siffer_1`	str	Kehtiv šifri kood või `""`	Esimene (domineeriv) mullaliigi kood, standardiseeritud	`"Ko"`
`siffer_2`	str	Kehtiv šifri kood või `""`	Teine mullaliigi kood	`"LP"`
`siffer_3`	str	Kehtiv šifri kood või `""`	Kolmas mullaliigi kood	`"D"`
`siffer_4`	str	Kehtiv šifri kood või `""`	Neljas mullaliigi kood	`""`
`n_siffers`	int	0–4	Selles polügoonis leitud mullaliikide koodide arv	`3`
`parse_ok_s`	bool	True / False	`True`, kui grammatika tuvastas kõik koodid	`True`
`parse_error`	str	Veatekst või `""`	Tuvastamata märkide kirjeldus; edukuse korral tühi	`""`

Koodid siffer_1…siffer_4 täidetakse vasakult paremale. Kasutamata pesad on tühjad sõned, mitte NULL.

Veergu parse_ok_s kasutatakse koos parse_ok_l ja parse_ok_h veergudega kaardivaaturi veaülevaate stiilis (SLD) — need juhivad, millised polügoonid värvitakse vea või õnnestumise tähisega.

Loimis — Mulla lõimisekihid¶

Need tulbad luuakse Loimise parseri poolt. Lõimise omadusi korratakse kuni 4 sügavuskihi kohta (liited 1–4).

Kihtide piirid¶

Väli	Tüüp	Ühik	Tähendus	Näide
`nlayers`	int	—	Kirjeldatud lõimisekihtide arv (1–4)	`2`
`ZMX`	float	cm	Kirjeldatud profiili maksimaalne sügavus	`70.0`
`Z1`	float	cm	1. kihi alumine piir	`40.0`
`Z2`	float	cm	2. kihi alumine piir; `0`, kui < 2 kihti	`70.0`
`Z3`	float	cm	3. kihi alumine piir; `0`, kui < 3 kihti	`0.0`
`Z4`	float	cm	4. kihi alumine piir; `0`, kui < 4 kihti	`0.0`

Kihipõhine lõimis (n = 1 kuni 4)¶

Väli	Tüüp	Väärtused	Tähendus	Näide
`EST_TXT`n	str	`l`, `pl`, `sl`, `ls`, `s`, `tsl`, `tls`, `dk`, …	Eesti lõimise kood kihile n	`"sl"`
`EST_CRS`n	str	`r`, `v`, `k`, `kb`, `p`, `lu`, `ck` või `""`	Koresuse tüüp kihile n; tühi, kui koresust pole	`"r"`
`LXTYPE`n	str	`SAND`, `FINE_SAND`, `LOAM`, `SANDY_CLAY`, `CLAY`, `PEAT`, `GRAVELS`, …	Rahvusvaheline / WRB lõimiseklass kihile n	`"LOAM"`
`CLAY`n	float või NaN	0–100 %	Savi fraktsioon kihile n. `NaN` GRAVELS kihtide puhul.	`15.0`
`SILT`n	float või NaN	0–100 %	Tolmu fraktsioon kihile n. `NaN` GRAVELS kihtide puhul.	`20.0`
`SAND`n	float või NaN	0–100 %	Liiva fraktsioon kihile n. `NaN` GRAVELS kihtide puhul.	`65.0`
`ROCK`n	float või NaN	0–100 %	Koresuse (kivimifraktsioonide) osa kihile n	`0.0`

Diagnostilised väljad¶

Väli	Tüüp	Väärtused	Tähendus
`parse_ok_l`	bool	True / False	`True`, kui kõik kihid õnnestus parsida; kasutatakse kaardivaaturi veaülevaates
`parse_info`	str	`"successful"`, `"empty_loimis"`, `"partial_no_info"`, `"parse_error"`	Üksikasjalik parsimise tulemus
`has_no_info`	bool	True / False	`True`, kui ≥ 1 kihti ei saanud parsida
`loimis_grammar`	dict	Pesastatud sõnastik	Täielik struktureeritud parsimistulemus (andmebaasis salvestatud, kuid ei kuvata kaardivaaturi hüpikaknas)
`loimis_search`	dict	Pesastatud sõnastik	Sisemine otsinguparameetrite tõmmis (andmebaasis salvestatud, kuid ei kuvata kaardivaaturi hüpikaknas)

NaN lõimise fraktsioonides: Kruusa- või koreserikaste kihtide puhul, kus LXTYPE = "GRAVELS", on savi, tolmu ja liiva väärtused NaN. Enne fraktsioonide summeerimist kontrollige alati LXTYPE või ROCK väärtust.

Kasutamata kihtide pesad: Z2–Z4 ja EST_TXT2–EST_TXT4 jne on 0 / "" (mitte NaN), kui nlayers < n. Kontrollige esmalt nlayers väärtust.

Huumus — Orgaaniline horisont¶

Need ~96 tulpa luuakse Huumuse parseri poolt. Üksusepõhiseid välju korratakse kuni 4 mullaüksuse kohta (liited _1–_4).

Kvaliteet ja päritolu¶

Väli	Tüüp	Väärtused	Tähendus	Näide
`n_siffers`	int	0–4	Tühikutega eraldatud mullaüksuste arv polügoonis	`2`
`parse_ok_h`	bool	True / False	`True`, kui kõik mullaüksused tuvastati; kasutatakse kaardivaaturi veaülevaates	`True`
`parse_error`	str	Veatekst või `""`	Semikooloniga eraldatud tuvastamata märgid; edukuse korral tühi	`""`

Üksusepõhised väljad (n = 1 kuni 4) — säilitatud eelmisest versioonist¶

Väli	Tüüp	Väärtused	Tähendus	Näide
`h_raw_`n	str	Mis tahes sõne või `""`	Algne sisendsõne üksusele n, täpselt nii nagu kaardil	`"th15/h5"`
`h_has_split_`n	bool	True / False	`True`, kui see üksus sisaldab metsa/põllu `/` jaotust	`True`
`h_type_`n	str	vt allpool	Domineeriv orgaanilise horisondi tüüp üksusele n	`"th"`
`h_depth_min_`n	float	cm või NaN	Kõige madalam horisondi piir; `NaN`, kui tüsedust pole	`15.0`
`h_depth_max_`n	float	cm või NaN	Kõige sügavam horisondi piir; võrdub `h_depth_min`-iga üksikväärtusel	`15.0`

h_type väärtused:

Väärtus	Tähendus
`"th"`	Toorhuumus — osaliselt lagunenud
`"peat"`	Turvas — mis tahes lagunemisaste (1-3)
`"humus"`	Mineraalne huumushorisont (mull)
`"litter"`	Metsakõdu — mis tahes lagunemisaste (1-3), ≤ 10 cm
`"none"`	Orgaaniline kiht puudub (`0`)
`"mixed"`	Mitu tüüpi selles üksuses; domineeriv tüüp prioriteediga th > peat > humus > litter
`"unknown"`	Tuvastamata märk — vt `parse_error`
`""`	Pesa pole täidetud (vähem kui n üksust selles reas)

UUS — Peamine huumus (phu) — 3 × 4 üksust¶

Valem paremal pool / (madalam kiht) või terve valem, kui / puudub.

Väli	Tüüp	Väärtused	Näide
`h_phu_type_`n	str	`"th"`, `"peat"`, `"humus"`, `"none"`, `"unknown"`, `""`	`"humus"`
`h_phu_min_`n	float	cm või NaN	`5.0`
`h_phu_max_`n	float	cm või NaN	`10.0`

UUS — Sekundaarne huumus (lhu) — 3 × 4 üksust¶

Valem vasakul pool / (ülemine kiht) juhul, kui on mitu huumuse kihti.

Väli	Tüüp	Väärtused	Näide
`h_lhu_type_`n	str	sama, mis phu; `""` kui puudub	`"th"`
`h_lhu_min_`n	float	cm või NaN	`15.0`
`h_lhu_max_`n	float	cm või NaN	`15.0`

UUS — Kõdu kihid O1–O3 — 9 × 4 ü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	Näide
`h_o1_deg_`n	str	`"₁"`, `"₂"`, `"₃"`, `""`	`"₂"`
`h_o1_min_`n	float	cm või NaN	`1.0`
`h_o1_max_`n	float	cm või NaN	`1.0`
`h_o2_deg_`n	str	sama, mis O1	`"₁"`
`h_o2_min_`n	float	cm või NaN	`2.0`
`h_o2_max_`n	float	cm või NaN	`2.0`
`h_o3_deg_`n	str	sama, mis O1	`"₃"`
`h_o3_min_`n	float	cm või NaN	`4.0`
`h_o3_max_`n	float	cm või NaN	`4.0`

UUS — Märgendid üksutes kohta — 3 × 4 üksust¶

Väli	Tüüp	Väärtused
`h_has_depth_split_`n	bool	`True` kui `/` on olemas
`h_is_agri_forest_`n	bool	`True` kui `/` (tühik-kaldkriips-tühik) on olemas
`h_depth_total_`n	float	phu ja lhu sügavuste keskmiste summa; kui > 40 cm = suunata kontrolli?

Struktureeritud andmed¶

Väli	Tüüp	Tähendus
`huumus_json`	dict	Täielik struktureeritud parsimistulemus: üksuse- ja kihipõhised andmed, sh lagunemisaste, sügavus ning metsa/põllu osad. Andmebaasis salvestatud, kuid ei kuvata kaardivaaturi hüpikaknas.

Märkused kolme väljundtabeli ühendamise kohta¶

Kõik kolm parserit töötlevad sama polügoonide kogumit. Väljundid ühendatakse polügooni unikaalse identifikaatori (unique_id) abil. Täielik polügooni kirje ühendab tulbad kõigist kolmest parserist:

SELECT s.unique_id,
       s.siffer_1, s.siffer_2, s.n_siffers,
       l.EST_TXT1, l.CLAY1, l.Z1, l.nlayers,
       h.h_type_1, h.h_depth_max_1
FROM   siffer_parsed  s
JOIN   loimis_parsed  l USING (unique_id)
JOIN   huumus_parsed  h USING (unique_id);

PostgreSQL-i materialiseeritud vaade mv_mullakaart_parsed ühendab juba kõik kolm väljundit ja seda pärib ka kaardirakendus.