Keri sisuni

Väljade viide

Täielik nimekiri kõigist väljundtulpadest, mida kolm parserit toodavad, ning analüütilistest veergudest, mille turba lagunemine lõplikule kaardile lisab. 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 või NaN cm Kirja pandud profiili kogusügavus; NaN, kui ühegi kihi tüsedust ei kirjeldatud 70.0
Z1 float või NaN cm 1. kihi alumine piir; NaN, kui tüsedust ei kirjeldatud 40.0
Z2 float või NaN cm 2. kihi alumine piir; NaN, kui < 2 kihti või tüsedust ei kirjeldatud 70.0
Z3 float või NaN cm 3. kihi alumine piir; NaN, kui < 3 kihti või tüsedust ei kirjeldatud NaN
Z4 float või NaN cm 4. kihi alumine piir; NaN, kui < 4 kihti või tüsedust ei kirjeldatud NaN
zmx_model float või NaN cm Mudeldajatele, mitte teadlastele. Modelleeritud profiili kogusügavus. NaN ainult siis, kui polügoonil ei ole ühtegi kihti (nlayers = 0, nt lõimis no_info) 100.0
z1_model float või NaN cm Modelleeritud 1. kihi alumine piir; NaN, kui polügoonil ei ole kihte 40.0
z2_model float või NaN cm Modelleeritud 2. kihi alumine piir; 0, kui < 2 kihti; NaN, kui polügoonil ei ole kihte 100.0
z3_model float või NaN cm Modelleeritud 3. kihi alumine piir; 0, kui < 3 kihti; NaN, kui polügoonil ei ole kihte 0.0
z4_model float või NaN cm Modelleeritud 4. kihi alumine piir; 0, kui < 4 kihti; NaN, kui polügoonil ei ole kihte 0.0

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

Väli Tüüp Väärtused Tähendus Näide
EST_TXTn str l, pl, sl, ls, s, tsl, tls, dk, … Eesti lõimise kood kihile n "sl"
EST_CRSn str r, v, k, kb, p, lu, ck või "" Koresuse tüüp kihile n; tühi, kui koresust pole "r"
LXTYPEn str SAND, FINE_SAND, LOAM, SANDY_CLAY, CLAY, PEAT, GRAVELS, … Rahvusvaheline / WRB lõimiseklass kihile n "LOAM"
CLAYn float või NaN 0–100 % Savi fraktsioon kihile n. NaN GRAVELS, PEAT ja HUMUS kihtide puhul. 15.0
SILTn float või NaN 0–100 % Tolmu fraktsioon kihile n. NaN GRAVELS, PEAT ja HUMUS kihtide puhul. 20.0
SANDn float või NaN 0–100 % Liiva fraktsioon kihile n. NaN GRAVELS, PEAT ja HUMUS kihtide puhul. 65.0
ROCKn float või NaN 0–100 % Koresuse (kivimifraktsioonide) osa kihile n 0.0
KARBn int 0 / 1 Karbonaatsuse tunnus: 1, kui kiht n on tähistatud karbonaatsena sümboliga + kas lõimise koodi ees (+ls₁) või sügavust näitava arvu ees (s+70), või kui kihi koresematerjal on r, kb või lu (r₂ls) 1
KARB_Zn float või NaN cm Sügavus, millest alates kiht n on karbonaatne: sümbolile + järgnev arv (s+70 → 70; vahemiku sl+60-90 puhul väiksem arv, 60). NaN, kui valemis sellist sügavust ei ole, ka siis, kui KARBn on 1 70.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)
fix_applied str või NULL reegel:tegevus märgised, eraldatud sümboliga \| Mida on sellel polügoonil parandatud väljaspool parsereid. 60:uid_fix:Siffer / 60:uid_fix:Loimis1: mullateadlaste polügoonipõhine parandus rakendati algväärtusele enne parsimist (60:uid_fix_skipped:…, kui algväärtus ei vastanud enam sellele, mida parandus eeldas); 60:add_prim, 65:add_prim, 65:absorbed:<uid>, 60:manual_review: turvasmuldade primmide ja geomeetria parandused, täpsemalt kihis geofix_log
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", samuti orgaaniliste kihtide puhul (LXTYPE = "PEAT" või "HUMUS"), on savi, tolmu ja liiva väärtused NaN — orgaanilisel materjalil puudub mineraalne peenese fraktsioon ja METK loimis_vastavustabel_v1 jätab need lahtrid tühjaks. Enne fraktsioonide summeerimist kontrollige alati LXTYPE või ROCK väärtust.

Z1–Z4/ZMX — NULL tähendab puuduvat väärtust, nlayers ütleb miks: need on NaN (SQL NULL) nii siis, kui n > nlayers (kihti pole), kui ka siis, kui kiht on olemas, aga selle tüsedust ei kirjeldatud — seda ei arvutata juurde. Z1–Z4 on kumulatiivsed alumised piirid, seega üks teadmata kiht muudab ka kõik sügavamad piirid NaN-iks; ZMX summeerib ainult tegelikult kirja pandud tüsedused ja on NaN ainult siis, kui ühtegi ei kirjeldatud.

Mis ei ole kirjeldatud tüsedus: sulgudes olev arv on kihi alumise piiri sügavus (s(50-90)) ja sümbolile + järgnev arv on sügavus, millest alates kiht on karbonaatne (s+70, esitatud veerus KARB_Zn). Kumbki ei ole tüsedus, seega on sellise kihi piirid NaN nagu igal teisel tüseduseta kihil. Sulgude ees olevat sulgudeta tüsedust kasutatakse endiselt (r₁ls₁20-30(35) → 25 cm) ning turba >100 / üle100 tähendab vähemalt 100 cm tüsedust ja jääb väärtuseks 100.

zmx_model/z1_model–z4_model — mudeldajatele, mitte teadlastele: taastavad EstSoil-EH käitumise, kus kirjeldamata kihi tüsedus jaotatakse ülejäänud sügavuse arvelt, seega v⁰₁ls/l annab z1_model=50, z2_model=100, kuigi Z1/Z2 on mõlemad NaN. Alati arvulised kuni nlayers-ini, sellest kaugemal 0; kõik viis on NaN (SQL NULL), kui polügoonil ei ole ühtegi kihti. Ärge kasutage neid teadusliku analüüsi ega lõimisefraktsioonide kaalumise jaoks — selleks kasutage Z1–Z4.

Turbakihi tüsedus primmide järgi: turvasmuldadel (siffer_1 on AM, M, S või R koos primmidega), mille valem algab turbakihiga ilma tüseduseta, võetakse modelleeritud veergudes turbakihi tüsedus primmide järgi, mitte võrdse jaotuse alusel: üks primm 40 cm, kaks 75 cm, kolm 100 cm. Alumised kihid jagavad 100 cm-st üle jääva osa (M’ ja t/ls → z1_model=40, z2_model=100; M’’’ ja t₃/ls → 100, 100, sest sügavamale kui 100 cm ei kaardistata). Kasutatakse lõplikku sifrit, sh geomeetriaparandustega lisatud primme, ja veerge Z1–Z4 ei muudeta kunagi. Polügoonid, millel lõimise info puudub, jäävad tühjaks.

Kasutamata kihtide pesad: EST_TXT2–EST_TXT4 jne on "" (mitte NaN), kui nlayers < n. Kontrollige esmalt nlayers väärtust. Z2–Z4/zN_model järgivad oma reegleid ülalpool.


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–n Tühikutega eraldatud mullaüksuste arv polügoonis. Näitab tegelikku arvu; ainult esimesed 4 saavad eraldi veerud, seega n_siffers > 4 tähistab kärbitud rida. 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.

Turba lagunemine — analüütilised väljad

Need väljad lisab lõplikule kaardile mv_mullakaart_parsed (GeoPackage, FlatGeobuf, PostGIS) turba lagunemise samm (töötlusahela samm 3). Need ei ole parserite väljund: need näitavad, kus turvasmullad on tüsedust kaotanud ja miks.

Lõpliku kaardi rida on tükk. QGIS-i turbamudel võib baaskaardi ühe polügooni lõigata < 30 cm jääkturba maski järgi mitmeks tükiks, seega on lõplikul kaardil rohkem ridu kui baaskaardil. Turbast kaugel olevad polügoonid säilitavad baaskaardi geomeetria ja atribuudid ning enamik allolevatest väljadest jääb neil tühjaks (NULL).

Tüki identiteet ja lõikamine

Väli Tüüp Väärtused Tähendus
parent_unique_id str (UUID) Baaskaardi polügooni unique_id, millest tükk pärineb; võrdne unique_id-ga, kui polügooni ei lõigatud. Kõik baaskaardi id-dele tuginevad tabelid (geofix-otsused, uid-parandused, varasemad ekspordid) ühendatakse selle välja kaudu.
peat_part int 0, 1, 2, … Tüki järjekorranumber oma vanempolügooni sees, suurim esimesena. Tükk 0 säilitab vanema unique_id, teised saavad vanema id-st ja järjekorranumbrist tuletatud uue UUID (sama geomeetria korral korduval käivitusel sama).
peat_clip str none, unchanged, reshaped, split, model_failed Mida mudel polügooniga tegi. none: maskist kaugel, mudelist läbi ei läinud. unchanged: läks läbi, geomeetria sama (< 1 m² erinevus). reshaped: üks tükk, geomeetria muutus (maskile tõmmatud, kitsad ribad liidetud). split: mitu tükki. model_failed: grupis, mida mudel ei suutnud töödelda, baaskaardi geomeetria säilitati, vajab ülevaatust.
below30_frac float 0–1 Tüki pindala osakaal < 30 cm jääkturba maski sees. Ainult mudelist läbi läinud tükkidel.

Baaskaardi polügoonid, mille mudel täielikult teistega liitis, kaardil ei ole. Need on loetletud mitteruumilises kihis peat_clip_log koos tükiga, mis neelas suurema osa nende pindalast (absorbed_by), samuti kõik lõikamised ja kujumuutused.

Jääkturvas ja maakasutus (tükipõhine)

Arvutatakse iga tüki jaoks uuesti, sest lõigatud polügooni mediaan ei kehti tema tükkide kohta. Arvutatakse ainult kandidaattükkidele, ülejäänud jäävad NULL-iks: turvas esimeses lõimisekihis (EST_TXT1 t1–t3), turvas esimeses huumuseüksuses (h_type_1 = peat) või siffer_1, millest muutumisemaatriks lähtub ((A)M’, (A)M’’, (A)M’’’, (A)G1).

Väli Tüüp Ühik / väärtused Tähendus
peat_modelled bool True / False Tükk kuulub nende hulka, mille jaoks jääkturba raster arvutati: EST_TXT1 t1–t3 ja R, S, M või AM väljades siffer_1–siffer_4. Mujal on peat_remaining_cm.tif väärtus 0, mis tähendab "ei modelleeritud", mitte "turvast pole".
median_remaining_peat_cm float cm peat_remaining_cm.tif mediaan tüki ulatuses (kõik puudutatud pikslid): kuivenduse ja harimise järel alles jäänud turvas. NULL, kui peat_modelled on väär.
remaining_peat_npx float pikslid Mediaani aluseks olevate rastripikslite arv.
z_peat_total_cm float cm Kaardistatud profiili turba tüsedus enne lagunemist: lõimisevalemi turbakihid (modelleeritud sügavuse veerud) pluss huumusevalemi turvas, vanema atribuutidest.
peat_loss_cm float cm z_peat_total_cm − median_remaining_peat_cm. NULL, kui mediaan puudub.
agri_frac float 0–1 Põllumajanduslike pikslite (ELME2 baaskaardi koodid 40200, 40500) osakaal baaskaardi pikslitest, mille keskpunkt jääb tüki sisse (liiga väikestel tükkidel kõik puudutatud pikslid).
landuse_npx float pikslid agri_frac aluseks olevate baaskaardi pikslite arv.
landuse str haritav, looduslik haritav, kui agri_frac > 0.5, muidu looduslik; viik läheb looduslik kasuks, mis jätab sifri muutmata. Rohumaa loetakse looduslik-uks.

Lagunemise järel muudetud atribuudid

Lagunemine muudab ainult tükke, mille peat_modelled on tõene ja millel on median_remaining_peat_cm. See kirjutab parserite veergudesse (siffer_1–4, parse_ok_s, WRB, Loimis1 veerud, Z1–Z4, z1_model–zmx_model) lagunemise järgsed väärtused, nii et kaart, rastrid ja API näitavad lagunenud mulda. Sisuliselt muutuvad ainult siffer_1 ja Loimis1 veerud: siffer_2–siffer_4, Loimis2 (lm2_ veerud) ja huumus säilitavad baaskaardi väärtused (vt ulatuse märkust töötlusahela sammus 3). Allolevad veerud säilitavad varasema väärtuse ja näitavad, mis muutus.

Väli Tüüp Väärtused Tähendus
siffer_1_base str sifri kood siffer_1 enne muutumisemaatriksit, igal real. Võrdne siffer_1-ga, kui maatriks midagi ei muutnud.
matrix_rule str nt M’’: 10-30 cm -> G1 Muutumisemaatriksi (muutumisemaatriks.xlsx, leht haritavad) rida, mis andis mullaliigi ja jääkturba järgi uue siffer_1. Ainult haritaval maal (landuse = haritav). A-variandid on kujul sama as …. NULL, kui siffer_1 ei muutunud. Muutub ainult siffer_1, siffer_2–4 jäävad.
decay_depth str loimis, model_only, NULL Kuidas sügavused muutusid. loimis: valemis on tüsedus igal turbakihil, mis tüsedust kaotab, seega valem kirjutatakse ümber (t₃40/l → t₃15/l) ja parsitakse uuesti ning koos sellega muutuvad Z1–Z4. model_only: valemis pole tüsedust, mida vähendada (t₃/l), seega muutuvad ainult modelleeritud sügavuse veerud, valem ja Z1–Z4 jäävad kaardistatud kujule. NULL: sügavused ei muutunud.
peat_loimis_cm_base float cm Lõimisekihtide turba tüsedus enne lagunemist.
peat_loimis_cm float cm Pärast lagunemist: väiksem väärtustest peat_loimis_cm_base ja median_remaining_peat_cm. Turvas kaob pinnalt allapoole, esmalt huumuse turvas, seega kui jääkturvast on rohkem kui lõimise turvast, kaob ainult huumuse turvas ja kihid jäävad.

0 cm turbakihid: turbakiht võib kaotada kogu oma tüseduse. See jääb profiili tüübiga t ja tüsedusega 0 cm (t₃0/l); selle Z ja modelleeritud veerud seab lagunemise samm, sest parser loeb sõnaselge 0 kui "tüsedus puudub".

Turba lagunemine lisab märgiseid ka välja fix_applied (vt Loimis, diagnostilised väljad):

Märgis Tähendus
79:matrix:<vana>-><uus> siffer_1 muudeti muutumisemaatriksi järgi, nt 79:matrix:M’’->G1
77:peat_depth:loimis / 77:peat_depth:model_only turbakihte vähendati, nagu väljal decay_depth
77:peat_layer_0cm vähemalt üks turbakiht vähendati 0 cm-ni
77:huumus_peat_check kadu ulatub huumusevalemi turbani, mida ümber ei kirjutata: kontrollida
79:buried_peat_not_reduced osa kaost langeks mineraalse kihi all olevale turbale, mis jäetakse nii nagu on
79:formula_not_rewritten valemis on arvud olemas, kuid seda ei õnnestunud ümber kirjutada; ainult modelleeritud sügavused
80:tarn_loimis_t3 algne sifer Tarn: Loimis1 seati väärtusele t₃

Lõpliku GeoPackage'i kihis decay_log on iga muudetud tüki kohta üks rida väärtustega enne ja pärast.


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.