Package: soilKey 0.9.97

Hugo Rodrigues

soilKey: Automated Soil Profile Classification per 'WRB' 2022, 'SiBCS' 5 and 'USDA' Soil Taxonomy 13

Implements deterministic classification keys for the World Reference Base for Soil Resources ('WRB') 2022, 4th edition (IUSS Working Group WRB, 2022, ISBN:979-8-9862451-1-9), the Brazilian System of Soil Classification ('SiBCS') 5th edition (Santos et al., 2018, ISBN:978-85-7035-800-4) and the United States Department of Agriculture ('USDA') Soil Taxonomy 13th edition (Soil Survey Staff, 2022, <https://www.nrcs.usda.gov/resources/guides-and-instructions/keys-to-soil-taxonomy>). Provides a unified profile representation with explicit per-attribute provenance, multimodal extraction from field reports and photos via vision-language models (VLM), spatial priors from 'SoilGrids' (Poggio et al., 2021, <doi:10.5194/soil-7-217-2021>) and national soil maps, and gap-filling of soil attributes from visible-near-infrared (Vis-NIR) or mid-infrared (MIR) spectra via the Open Soil Spectral Library ('OSSL'; Safanelli et al., 2025, <doi:10.7717/peerj.18908>). The taxonomic key itself is never delegated to a large language model (LLM); LLMs are restricted to schema-validated extraction. Each classification result reports a key trace, a provenance-aware evidence grade, and ambiguities that further measurement would resolve.

Authors:Hugo Rodrigues [aut, cre]

soilKey_0.9.97.tar.gz
soilKey_0.9.97.tar.gz(r-4.7-any)soilKey_0.9.97.tar.gz(r-4.6-any)
soilKey_0.9.97.tgz(r-4.6-emscripten)
manual.pdf |manual.html
card.svg |card.png
soilKey/json (API)
NEWS

# Install 'soilKey' in R:
install.packages('soilKey', repos = c('https://cran.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/hugomachadorodrigues/soilkey/issues

Pkgdown/docs site:https://hugomachadorodrigues.github.io

Datasets:

On CRAN:

Conda:

4.28 score 38 scripts 893 exports 6 dependencies

Last updated from:52ec21dd0b. Checks:4 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK362
source / vignettesOK328
linux-release-x86_64OK339
wasm-releaseOK169

Exports:%||%abrupt_textural_differenceacric_andisol_usdaacric_oxisol_usdaacrisolaeolic_materialaeric_oxisol_usdaaeric_subgroup_usdaal_rich_spodic_usdaalbaquult_qualifying_usdaalbeluvic_glossaealbicalbic_horizon_usdaalbic_subgroup_usdaalboll_qualifying_usdaalfic_subgroup_usdaalfisol_qualifying_usdaalfisol_usdaalic_andisol_usdaalisolandic_propertiesandic_soil_properties_usdaandic_subgroup_usdaandisol_qualifying_usdaandisol_usdaandosolanhydrous_conditions_usdaanionic_subgroup_usdaannotate_wrb_from_usdaanthraquicanthric_horizonsaqualf_qualifying_usdaaquand_qualifying_usdaaquandic_subgroup_usdaaquent_qualifying_usdaaquept_qualifying_usdaaquert_qualifying_usdaaquic_conditions_usdaaquic_subgroup_usdaaquoll_qualifying_usdaaquult_qualifying_usdaarenic_subgroup_usdaarenic_textureargicargic_aqpargic_aridisol_usdaargic_mollisol_usdaargic_subgroup_usdaargic_with_strong_clay_filmsargillic_clay_films_testargillic_or_kandic_usdaargillic_usdaargillic_within_usdaargissoloargissolo_acinzentadoargissolo_amareloargissolo_bruno_acinzentadoargissolo_vermelhoargissolo_vermelho_amareloaridisol_qualifying_usdaaridisol_usdaartefactsas_aqpatividade_argila_altaattach_lucas_spectraaudit_argic_strong_filmsauto_set_proj_envavailable_esdb_attributesB_espodicoB_incipienteB_latossolicoB_niticoB_planicoB_texturalbatch_robustnessbenchmark_afspbenchmark_bdsolosbenchmark_lucas_2018benchmark_performancebenchmark_redapebenchmark_run_classificationbenchmark_unifiedbenchmark_wrb_vs_usdacalcaric_materialcalciccalcic_horizon_usdacalcic_subgroup_usdacambiccambic_aqpcambissolocambissolo_fluvicocambissolo_haplicocambissolo_histicocambissolo_humicocanonical_referencecanonicalise_kst13ed_ggcarater_acricocarater_aliticocarater_arenicocarater_argiluvicocarater_cambissolicocarater_cambissolico_argcarater_carbonaticocarater_chernossolicocarater_coesocarater_duricocarater_ebanicocarater_espessarenicocarater_espodicocarater_espodico_profundocarater_eutricocarater_ferricocarater_fluvicocarater_gleissolicocarater_hidromorficocarater_hipocarbonaticocarater_humico_espessocarater_latossolicocarater_lepticocarater_leptofragmentariocarater_luvissolicocarater_nitossolicocarater_palicocarater_perferricocarater_petroplinticocarater_placicocarater_planossolicocarater_plinticocarater_psamiticocarater_redoxicocarater_retratilcarater_rubricocarater_salicocarater_salinocarater_saproliticocarater_sodicocarater_solodicocarater_sombricocarater_terricocarater_tionicocarater_vertissolicocerosidadechernicchernossolochernossolo_argiluvicochernossolo_ebanicochernossolo_haplicochernossolo_rendzicochernozemchernozem_strictclaric_materialclassification_robustnessClassificationResultclassify_allclassify_by_spectral_neighboursclassify_from_documentsclassify_sibcsclassify_sibcs_familiaclassify_usdaclassify_via_smartsolos_apiclassify_with_engine_heuristicclassify_wrb2022clear_kst13_cacheclear_ossl_cachecombine_priorscompare_enginescompare_smartsoloscompute_kicompute_krcontato_liticocontato_litico_fragmentariocontinuous_rockcryic_conditionscryoturbation_usdacumulic_subgroup_usdadensiaquept_qualifying_usdaDiagnosticResultdistroficodolomitic_materialdownload_bdsolosdownload_extdata_cachedownload_ossl_subsetdownload_ossl_subset_with_labelsdownload_redape_datasetduric_horizonduric_subgroup_usdaduripaduripan_usdadystric_subgroup_usdaentic_subgroup_usdaentisol_usdaepisaturation_usdaespodossoloespodossolo_ferri_humiluvicoespodossolo_ferriluvicoespodossolo_humiluvicoeutric_inceptisol_usdaeutric_oxisol_usdaeutric_subgroup_usdaeutroficoevaluate_rsg_testsextract_horizons_from_pdfextract_munsell_from_photoextract_site_from_fieldsheetfamilia_andicofamilia_atividade_argilafamilia_constituicao_esqueleticafamilia_distribuicao_cascalhosfamilia_grupamento_texturalfamilia_labelfamilia_mineralogia_areiafamilia_mineralogia_argila_geralfamilia_mineralogia_argila_latossolofamilia_organossolo_espessurafamilia_organossolo_lenhosidadefamilia_organossolo_material_subjacentefamilia_oxidos_ferrofamilia_prefixo_profundidadefamilia_saturacao_aluminiofamilia_saturacao_basesfamilia_subgrupamento_texturalfamilia_tipo_horizonte_superficialFamilyAttributefebr_index_munsellferralicferralsolferricferric_subgroup_usdafibric_predominant_usdafibric_subgroup_usdafibricofill_from_spectrafill_munsell_from_spectrafluvaquentic_usdafluvent_qualifying_usdafluventic_usdafluvic_materialfolist_qualifying_usdafolistic_epipedon_usdafolistic_subgroup_usdaformat_wrb_namefragicfragipafragipan_usdafrasic_qualifying_usdafrom_aqpfulvic_andisol_usdagelisol_usdaglacic_layer_usdagleissologleissolo_haplicogleissolo_melanicogleissolo_salicogleissolo_tiomorficogleyic_propertiesgleysolglossic_subgroup_usdagrossarenic_subgroup_usdaGSM_DEPTHSgypsicgypsic_horizon_usdagypsic_subgroup_usdagypsiric_materialhalaquept_qualifying_usdahalic_subgroup_usdaharmonize_to_gsmhemic_subgroup_usdahemicohistel_qualifying_usdahistic_epipedon_usdahistic_horizonhistic_subgroup_usdahistosol_qualifying_usdahistosol_usdahorizonte_A_antropicohorizonte_A_chernozemicohorizonte_A_fracohorizonte_A_humicohorizonte_A_moderadohorizonte_A_proeminentehorizonte_calcicohorizonte_concrecionariohorizonte_E_albicohorizonte_gleihorizonte_histicohorizonte_litoplinticohorizonte_petrocalcicohorizonte_plinticohorizonte_sulfuricohorizonte_verticohortichumic_andisol_usdahumic_inceptisol_usdahumic_oxisol_usdahumic_spodic_usdahumic_subgroup_usdahumilluvic_subgroup_usdahumult_qualifying_usdahydragrichydraquent_qualifying_usdahydric_andisol_usdahydric_subgroup_usdahypersulfidic_materialhyposulfidic_materialinceptisol_qualifying_usdainceptisol_usdainspect_bdsolos_csvirragrickandic_horizon_usdakandic_oxisol_usdakanhapl_qualifying_usdakastanozemkastanozem_strictkst13_canonicalkst13_codeskst13_criterialamellic_subgroup_usdalatossololatossolo_amarelolatossolo_brunolatossolo_ki_krlatossolo_vermelholatossolo_vermelho_amareloleptic_featureslimnic_materiallimnic_usdalimoniclithic_contact_usdalithic_discontinuitylixisolload_afsp_pedonsload_afsp_sampleload_bdsolos_csvload_embrapa_pedonsload_febr_pedonsload_kssl_nasis_sampleload_kssl_pedonsload_kssl_pedons_gpkgload_kssl_pedons_with_nasisload_kssl_sampleload_lucas_pedonsload_lucas_soil_2018load_ossl_modelsload_redape_pedonsload_rulesload_wosis_sampleload_wosis_stratified_samplelookup_esdblookup_mapbiomas_soloslookup_soilgridsluvisolluvissololuvissolo_cromicoluvissolo_haplicomake_acrisol_canonicalmake_alisol_canonicalmake_andosol_canonicalmake_anthrosol_canonicalmake_arenosol_canonicalmake_argissolo_canonicalmake_calcisol_canonicalmake_cambisol_canonicalmake_cambissolo_canonicalmake_chernossolo_canonicalmake_chernozem_canonicalmake_cryosol_canonicalmake_durisol_canonicalmake_empty_horizonsmake_espodossolo_canonicalmake_ferralsol_canonicalmake_fluvisol_canonicalmake_gleissolo_canonicalmake_gleysol_canonicalmake_gypsisol_canonicalmake_histosol_canonicalmake_kastanozem_canonicalmake_latossolo_canonicalmake_leptosol_canonicalmake_lixisol_canonicalmake_luvisol_canonicalmake_luvissolo_canonicalmake_neossolo_canonicalmake_nitisol_canonicalmake_nitossolo_canonicalmake_organossolo_canonicalmake_phaeozem_canonicalmake_planosol_canonicalmake_planossolo_canonicalmake_plinthosol_canonicalmake_plintossolo_canonicalmake_podzol_canonicalmake_retisol_canonicalmake_solonchak_canonicalmake_solonetz_canonicalmake_stagnosol_canonicalmake_synthetic_pedon_with_spectramake_technosol_canonicalmake_umbrisol_canonicalmake_vertisol_canonicalmake_vertissolo_canonicalmelanic_andisol_usdamelanic_epipedon_usdamineral_materialMockVLMProvidermollicmollic_epipedon_usdamollisol_qualifying_usdamollisol_usdamudanca_textural_abruptamulmic_materialnatric_horizonnatric_horizon_usdanatric_subgroup_usdaneossoloneossolo_fluviconeossolo_litoliconeossolo_quartzareniconeossolo_regoliticonitic_horizonnitossolonitossolo_brunonitossolo_hapliconitossolo_vermelhonitric_subgroup_usdanormalise_febr_sibcsnormalise_febr_usdanormalise_febr_wrbnormalise_kssl_subgroupochric_epipedon_usdaollama_is_runningorganic_materialorganossoloorganossolo_folicoorganossolo_haplicoorganossolo_tiomorficoorganotechnic_materialornithogenic_materialossl_library_templateoxic_horizon_usdaoxic_usdaoxisol_usdaoxyaquic_subgroup_usdapachic_subgroup_usdapale_qualifying_usdapaleargid_qualifying_usdapanpaicpedon_json_schemapedon_to_spcPedonRecordpermafrost_within_usdapetrocalcicpetrocalcic_subgroup_usdapetroduricpetroferric_contact_usdapetrogypsicpetrogypsic_horizon_usdapetrogypsic_subgroup_usdapetronodic_subgroup_usdapetroplinthicphaeozempi_to_confidencepick_enginepick_engine_batchpisoplinthicplacic_horizon_usdaplaggicplanic_featuresplanosolplanossoloplanossolo_haplicoplanossolo_natricoplinth_subgroup_usdaplinthaquox_qualifying_usdaplinthicplinthic_subgroup_usdaplintossoloplintossolo_argiluvicoplintossolo_haplicoplintossolo_petricoposterior_classifypredict_from_spectrapredict_lab_from_spectrapredict_munsell_from_spectrapredict_ossl_mblpredict_ossl_plsr_localpredict_ossl_pretrainedpredict_xyz_from_spectrapreprocess_spectrapreticprior_consistency_checkprotocalcic_propertiesprotogypsic_propertiesprotoverticpsamment_qualifying_usdapsammentic_subgroup_usdaqual_abrupticqual_acericqual_acricqual_acroxicqual_activicqual_albicqual_alcalicqual_alicqual_aluandicqual_andicqual_anofluvicqual_anthraquicqual_anthricqual_anthromollicqual_archaicqual_arenicqual_arenicolicqual_aricqual_bathyspodicqual_biocrusticqual_brunicqual_bryicqual_calcaricqual_calcicqual_cambicqual_capillaricqual_carbicqual_carbonaticqual_carbonicqual_chernicqual_chloridicqual_chromicqual_clayicqual_coarsicqual_cohesicqual_columnicqual_cordicqual_cryicqual_cumulicqual_cutanicqual_densicqual_differenticqual_dolomiticqual_dorsicqual_drainicqual_duricqual_dystricqual_ekranicqual_endicqual_endoabrupticqual_endocalcaricqual_endocalcicqual_endodolomiticqual_endoduricqual_endodystricqual_endoeutricqual_endogleyicqual_endogypsicqual_endolepticqual_endostagnicqual_endothionicqual_endothyricqual_enticqual_epicqual_epidystricqual_epieutricqual_escalicqual_eutricqual_eutrosilicqual_evapocrusticqual_ferralicqual_ferricqual_ferriticqual_fibricqual_floaticqual_fluvicqual_folicqual_fracticqual_garbicqual_gelicqual_gelistagnicqual_geoabrupticqual_gericqual_gibbsicqual_gilgaicqual_glacicqual_gleyicqual_glossicqual_greyzemicqual_grumicqual_gypsicqual_gypsiricqual_haplicqual_hemicqual_histicqual_horticqual_humicqual_hydragricqual_hydricqual_hydrophobicqual_hyperalbicqual_hyperalicqual_hyperartefacticqual_hypercalcicqual_hyperdystricqual_hypereutricqual_hypergypsicqual_hypernatricqual_hyperorganicqual_hypersalicqual_hyperskeleticqual_hypersodicqual_hyperspodicqual_hypocalcicqual_hypogypsicqual_hyposalicqual_hyposodicqual_immissicqual_inclinicqual_irragricqual_isolaticqual_isoptericqual_kalaicqual_lamellicqual_lapiadicqual_laxicqual_lepticqual_lignicqual_limnicqual_linicqual_lithicqual_litholinicqual_lixicqual_loamicqual_luvicqual_magnesicqual_mahicqual_mawicqual_mazicqual_melanicqual_mineralicqual_mochipicqual_mollicqual_mulmicqual_murshicqual_muusicqual_naramicqual_natricqual_nechicqual_neobrunicqual_neocambicqual_niticqual_nudiargicqual_nudilithicqual_nudinatricqual_ochricqual_ombricqual_organotechnicqual_ornithicqual_orthofluvicqual_ortsteinicqual_oxyaquicqual_oxygleyicqual_pachicqual_pantofluvicqual_pellicqual_pelocrusticqual_petricqual_petrocalcicqual_petroduricqual_petrogypsicqual_petroplinthicqual_petrosalicqual_pisoplinthicqual_placicqual_plaggicqual_plinthicqual_posicqual_preticqual_profondicqual_profundihumicqual_proticqual_protoandicqual_protoargicqual_protocalcicqual_protogypsicqual_protospodicqual_protoverticqual_pufficqual_pyricqual_rapticqual_reductaquicqual_reducticqual_reductigleyicqual_relocaticqual_rendzicqual_reticqual_rheicqual_rhodicqual_rockicqual_rubicqual_rusticqual_salicqual_sapricqual_saprolithicqual_silandicqual_silticqual_skeleticqual_sodicqual_solimovicqual_sombricqual_somericqual_spodicqual_spolicqual_stagnicqual_subaquaticqual_sulfaticqual_sulfidicqual_takyricqual_technicqual_tephricqual_terricqual_thionicqual_thixotropicqual_thyricqual_tidalicqual_tonguicqual_toxicqual_transporticqual_turbicqual_umbricqual_urbicqual_uterquicqual_vermicqual_verticqual_veticqual_vitricqual_wapnicqual_xanthicqual_yermicquartzipsamment_qualifying_usdaread_febr_pedonsreducing_conditionsrendoll_qualifying_usdareportreport_htmlreport_pdfreport_to_qgisresolve_wrb_qualifiersretic_propertiesrhodic_subgroup_usdarun_classify_apprun_demorun_sibcs_grande_gruporun_sibcs_keyrun_sibcs_subgruporun_sibcs_subordemrun_taxa_listrun_taxonomic_keyrun_usda_great_grouprun_usda_keyrun_usda_subgrouprun_usda_suborderrun_wrb_keyruptic_histic_subgroup_usdaruptic_subgroup_usdasalicsalic_horizon_usdasalic_subgroup_usdasapric_predominant_usdasapric_subgroup_usdasapricosave_ossl_modelsshrink_swell_crackssideralic_propertiessmr_aridic_usdasmr_torric_usdasmr_udic_usdasmr_ustic_usdasmr_xeric_usdasodic_subgroup_usdasoil_classes_at_locationsoil_moisture_regime_usdasoil_organic_carbonsoil_temperature_regime_usdasoilgrids_usda_lutsoilgrids_wrb_lutsolimovic_materialsombricsombric_subgroup_usdaspatial_priorspatial_prior_embrapaspatial_prior_soilgridssphagnic_usdaspodicspodic_andisol_usdaspodic_horizon_usdaspodic_subgroup_usdaspodosol_usdast_features_canonicalstagnic_propertiesstr_cryic_usdastr_gelic_usdasubgrupo_planossolo_espessossubgrupo_planossolo_mesicossubgrupo_plintossolo_endico_concrecionariosubgrupo_plintossolo_endico_litoplinticosubgrupo_plintossolo_espessossulfic_subgroup_usdasulfidic_materials_usdasulfuric_horizon_usdatakyric_propertiestechnic_featurestechnic_hard_materialtephric_materialterricterric_usdatest_abrupt_textural_changetest_al_saturation_abovetest_al_saturation_belowtest_andic_alfetest_artefacts_concentrationtest_bs_abovetest_bs_belowtest_bulk_density_belowtest_caco3_concentrationtest_carbonates_presenttest_caso4_concentrationtest_cec_per_claytest_cec_per_clay_abovetest_chernic_colortest_clay_abovetest_clay_increase_argictest_coarse_texture_throughouttest_designation_patterntest_duripan_concentrationtest_ec_concentrationtest_ecec_per_claytest_esp_abovetest_fe_dcb_abovetest_ferralic_texturetest_ferralic_thicknesstest_fluvic_stratificationtest_gleyic_featurestest_minimum_thicknesstest_mollic_base_saturationtest_mollic_colortest_mollic_organic_carbontest_mollic_structuretest_mollic_thicknesstest_oc_abovetest_ph_belowtest_plinthite_concentrationtest_salic_producttest_slickensides_presenttest_spodic_aluminum_irontest_stagnic_patterntest_texture_argictest_top_at_or_abovetexture_class_from_pctthaptic_subgroup_usdathapto_humic_usdathionictrain_pls_from_ossltsitelicturbic_subgroup_usdaultic_subgroup_usdaultisol_qualifying_usdaultisol_usdaumbric_epipedon_usdaumbric_horizonumbric_subgroup_usdausda_to_wrb_rsgvalidate_pedon_jsonvermic_subgroup_usdavertic_aridisol_usdavertic_horizonvertic_propertiesvertic_subgroup_usdavertisolvertisol_qualifying_usdavertisol_usdavertissolovertissolo_ebanicovertissolo_haplicovertissolo_hidromorficovitrand_qualifying_usdavitrandic_subgroup_usdavitric_propertiesvitric_subgroup_usdavlm_pick_providervlm_providerwassent_qualifying_usdawassist_qualifying_usdawrb06_code_to_rsgwrb2022_canonicalxanthic_subgroup_usdayermic_properties

Dependencies:clidata.tableR6rlangwithryaml

Benchmarking soilKey against WoSIS

Rendered fromv06_wosis_benchmark.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Começando com soilKey (PT-BR)

Rendered fromv01_getting_started_pt.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Cross-system classification: WRB 2022, SiBCS 5, USDA Soil Taxonomy

Rendered fromv03_cross_system_correlation.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

End-to-end pipeline: Gemma 4 + spatial + spectral + key + GIS export

Rendered fromv07_end_to_end_pipeline.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

End-to-end WRB 2022 classification with Ch 6 names

Rendered fromv02_classify_wrb_end_to_end.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Getting started with soilKey

Rendered fromv01_getting_started.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

KSSL + NASIS: multi-level USDA Soil Taxonomy benchmark

Rendered fromv08_kssl_nasis_multilevel.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Spatial prior + OSSL spectra pipeline (Modules 3 & 4)

Rendered fromv05_spatial_spectra_pipeline.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Um perfil real do A ao Z (estilo Embrapa, em portugues)

Rendered fromv09_perfil_embrapa_pt.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Vision-language extraction of pedon data (Module 2)

Rendered fromv04_vlm_extraction.Rmdusingknitr::rmarkdownon May 19 2026.

Last update: 2026-05-19
Started: 2026-05-19

Readme and manuals

Help Manual

Help pageTopics
Abrupt textural difference (WRB 2022 Ch 3.2.1)abrupt_textural_difference
Acric Subgroup helper (Andisols Acrudoxic / Acraquoxic / Acrustoxic / etc.)acric_andisol_usda
Acric Oxisol Suborder helper (Acroperox/Acrudox/Acrustox/Acraquox) Pass when oxic or kandic horizon has ECEC < 1.5 cmol/kg clay AND pH (KCl) >= 5.0.acric_oxisol_usda
Acrisol RSG diagnostic (WRB 2022)acrisol
Aeolic material (WRB 2022 Ch 3.3.1)aeolic_material
Aeric Subgroup (for Oxisols Aquox) - chroma-3 below epipedon Already defined for Aquods; here we add Oxisol-specific variant (any 10+ cm horizon below A with chroma >= 3 in 50%+ peds).aeric_oxisol_usda
Aeric Subgroup helper (Aquods) Pass when ochric epipedon is present (vs. histic/umbric/etc).aeric_subgroup_usda
Aluminum-rich spodic helper (Alaquods, Alorthods, KST Ch 14)al_rich_spodic_usda
Albic-over-argillic qualifying (Albaquults) Pass when albic horizon overlies an argillic horizon directly.albaquult_qualifying_usda
Albeluvic glossae (WRB 2022 Ch 3.2.2)albeluvic_glossae
Albic horizon (WRB 2022)albic
Albic horizon (USDA, KST 13ed Ch 3)albic_horizon_usda
Albic Subgroup helper (Albaquultic / Albaquic)albic_subgroup_usda
Albolls qualifier: mollic + albic + argillic.alboll_qualifying_usda
Alfic Subgroup helper (Spodosols): argillic or kandic with BS >= 35%alfic_subgroup_usda
Alfisol Order qualifier Pass when argillic OR kandic horizon present + BS >= 35% in some part.alfisol_qualifying_usda
Alfisols (USDA Cap 5): argillic/kandic/natric horizon + base saturation >= 35% at the implicit reference depth.alfisol_usda
Alic Subgroup helper (Andisols) Pass when al_kcl_cmol > 2.0 in a 10+ cm layer between 25 and 50 cm.alic_andisol_usda
Alisol RSG diagnostic (WRB 2022)alisol
Andic properties (WRB 2022)andic_properties
Andic soil properties (USDA, KST 13ed Ch 3, p 32)andic_soil_properties_usda
Andic Subgroup helper (USDA, KST 13ed)andic_subgroup_usda
Andisol Order qualifier (USDA, KST 13ed Ch 3, p 7)andisol_qualifying_usda
Andisols (USDA Cap 6): andic soil properties >= 60% of thickness.andisol_usda
Andosol RSG gate (WRB 2022 Ch 4, p 104)andosol
Anhydrous conditions (USDA Soil Taxonomy, 13th edition)anhydrous_conditions_usda
Anionic Subgroup helper (Oxisols)anionic_subgroup_usda
Annotate KSSL/NASIS pedons with a derived WRB Reference Soil Groupannotate_wrb_from_usda
Anthraquic horizon (WRB 2022): puddled-rice / paddy plough layer. v0.3.3 detects via designation pattern 'Apl|Ap|Hh'.anthraquic
Anthric horizons (WRB 2022)anthric_horizons
Aqualf Suborder qualifier (aquic conditions in argillic Alfisol).aqualf_qualifying_usda
Aquands Suborder qualifier (Cap 6, p 117) Pass when histic OR aquic conditions in 40-50 cm with redox features. Simplified: histic OR aquic_conditions(max_top=50).aquand_qualifying_usda
Aquandic Subgroup helper (Spodosols / others) Aquic + Andic.aquandic_subgroup_usda
Aquent Suborder qualifier (Entisol with aquic conditions <50 cm).aquent_qualifying_usda
Aquept Suborder qualifieraquept_qualifying_usda
Aquerts qualifier (Vertisols with aquic conditions) Pass when aquic_conditions within 50 cm.aquert_qualifying_usda
Aquic conditions (USDA Soil Taxonomy, 13th edition)aquic_conditions_usda
Aquic Subgroup helper (within 100 cm of mineral soil surface)aquic_subgroup_usda
Aquolls qualifier (aquic conditions in mollic).aquoll_qualifying_usda
Aquult Suborder qualifier Pass when aquic_conditions within 50 cm.aquult_qualifying_usda
Arenic / Grossarenic Subgroup helper (Spodosols)arenic_subgroup_usda
Arenic texture (WRB 2022)arenic_texture
Argic horizon (WRB 2022)argic
Argic / argillic horizon via aqp::getArgillicBounds()argic_aqp
Argic Aridisol helper - argillic-or-kandic in Argids/Cryids/etc.argic_aridisol_usda
Argic Mollisol Suborder helper - delegates argillic_within_usda.argic_mollisol_usda
Argic Subgroup helper (Endoaquods/Fragiaquods): argillic or kandic. Synonym of ultic at this level. Re-exported for naming clarity.argic_subgroup_usda
Test whether a pedon's argic horizon has strong clay filmsargic_with_strong_clay_films
Test for clay-illuviation evidence (KST 13ed Ch 3 p 4)argillic_clay_films_test
Argillic-or-Kandic helper (USDA, used in Spodosols Subgroups)argillic_or_kandic_usda
Argillic horizon (USDA Soil Taxonomy)argillic_usda
Argillic horizon helper (USDA, KST 13ed Ch 3)argillic_within_usda
Argissolos (SiBCS Cap 4, p 114; conceito Cap 3, p 86-88)argissolo
Argissolos Acinzentados (SiBCS Cap 5)argissolo_acinzentado
Argissolos Amarelos (SiBCS Cap 5)argissolo_amarelo
Argissolos Bruno-Acinzentados (SiBCS Cap 5)argissolo_bruno_acinzentado
Argissolos Vermelhos (SiBCS Cap 5)argissolo_vermelho
Argissolos Vermelho-Amarelos (catch-all dos Argissolos)argissolo_vermelho_amarelo
Aridisol Order qualifier (USDA, KST 13ed, Ch 2) Pass when the soil has aridic SMR AND any one of: argillic, natric, kandic, calcic, petrocalcic, gypsic, petrogypsic, salic, duripan, cambic, sulfuric horizon. Also requires no other prior order match.aridisol_qualifying_usda
Aridisols (USDA Cap 7): aridic moisture regime + ochric/anthropic + subsurface diagnostic. v0.8 simplification: detected via aridity proxies (low EC OR salic OR caracter combinations) + non-mollic surface + low OC (no organic accumulation).aridisol_usda
Artefacts (WRB 2022 Ch 3.3.2)artefacts
Convert one or more PedonRecord objects to an aqp SoilProfileCollectionas_aqp
Atividade da fracao argila (SiBCS Cap 1, p 30)atividade_argila_alta
Attach LUCAS 2018 Vis-NIR spectra to a list of PedonRecord objectsattach_lucas_spectra
Audit the strong-clay-films exclusion across a list of pedonsaudit_argic_strong_films
Auto-detect PROJ_LIB and GDAL_DATA directoriesauto_set_proj_env
List ESDB Raster Library attributes available at a given rootavailable_esdb_attributes
Horizonte B espodico (SiBCS Cap 2, p 62-65; v0.7)B_espodico
Horizonte B incipiente (SiBCS Cap 2, p 59-61; v0.7)B_incipiente
Horizonte B latossolico (SiBCS Cap 2, p 57-59; v0.7 strict)B_latossolico
Horizonte B nitico (SiBCS Cap 2, p 61-62; v0.7)B_nitico
Horizonte B planico (SiBCS Cap 2, p 65-66; v0.7)B_planico
Horizonte B textural (SiBCS Cap 2, p 54-57; v0.7 strict)B_textural
Batch robustness across many pedonsbatch_robustness
Benchmark soilKey WRB predictions against AfSP ground truthbenchmark_afsp
Benchmark soilKey classifiers against BDsolos national reference labelsbenchmark_bdsolos
Run the LUCAS Soil 2018 / ESDB WRB benchmarkbenchmark_lucas_2018
Run the soilKey performance benchmarkbenchmark_performance
Benchmark soilKey SiBCS predictions against the Redape gold standardbenchmark_redape
Run a benchmark across one of the loaded pedon listsbenchmark_run_classification
Unified cross-dataset benchmark across SiBCS / WRB / USDAbenchmark_unified
Benchmark soilKey WRB predictions against a USDA-derived ground truthbenchmark_wrb_vs_usda
Calcaric material (WRB 2022 Ch 3.3.3): \>= 2% CaCO3 throughout the fine earth, primary carbonates from the parent material.calcaric_material
Calcic horizon (WRB 2022)calcic
Calcic horizon (USDA, delegates to WRB calcic).calcic_horizon_usda
Calcic Subgroup helper - delegates to calcic_horizon_usda within 'max_top_cm'.calcic_subgroup_usda
Cambic horizon (WRB 2022)cambic
Cambic horizon via aqp::getCambicBounds()cambic_aqp
Cambissolos (SiBCS Cap 4, p 113; conceito Cap 3, p 88-89)cambissolo
Cambissolos Fluvicos (Cap 6): carater fluvico.cambissolo_fluvico
Cambissolos Haplicos (catch-all).cambissolo_haplico
Cambissolos Histicos (Cap 6): horizonte histico sem espessura para Organossolo.cambissolo_histico
Cambissolos Humicos (Cap 6): horizonte A humico.cambissolo_humico
Load a canonical reference dataset from soilKey or SoilTaxonomycanonical_reference
Canonicalise a USDA Great Group label to a KST 13ed-compatible keycanonicalise_kst13ed_gg
Carater acrico (SiBCS Cap 1, p 31)carater_acrico
Carater alitico (SiBCS Cap 1, p 32)carater_alitico
Carater arenico (SiBCS Cap 5)carater_arenico
Carater argiluvico (SiBCS Cap 1; Cap 6)carater_argiluvico
Carater cambissolico (SiBCS Cap 14)carater_cambissolico
Carater cambissolico (Argissolos - Cap 5)carater_cambissolico_arg
Carater carbonatico (SiBCS Cap 1, p 33)carater_carbonatico
Carater chernossolico (SiBCS Cap 5; A chernozemico + Ta alta)carater_chernossolico
Carater coeso (SiBCS Cap 1, pp 32-33)carater_coeso
Carater durico (SiBCS Cap 1)carater_durico
Carater ebanico (SiBCS Cap 1; Cap 7 e Cap 17)carater_ebanico
Carater espessarenico (SiBCS Cap 5)carater_espessarenico
Carater espodico (SiBCS Cap 1, p 35; Cap 8)carater_espodico
Carater B espodico profundo (SiBCS Cap 8)carater_espodico_profundo
Carater eutrico (SiBCS Cap 1, p 35)carater_eutrico
Carater ferrico (SiBCS Cap 1, p 35; Cap 5 e Cap 10)carater_ferrico
Carater fluvico (SiBCS Cap 1, p 35-36): camadas estratificadas + distribuicao irregular de C organico. Reuso de fluvic_material (WRB).carater_fluvico
Carater gleissolico (SiBCS Cap 5; horizonte_glei em posicao nao-Gleissolo)carater_gleissolico
Carater hidromorfico (SiBCS Cap 8)carater_hidromorfico
Carater hipocarbonatico (SiBCS Cap 1, p 33): CaCO3 entre 50 e 150 g/kg.carater_hipocarbonatico
Carater espesso-humico (SiBCS Cap 5, p 119)carater_humico_espesso
Carater latossolico (SiBCS Cap 5)carater_latossolico
Carater leptico (SiBCS Cap 5; contato litico em 50-100 cm)carater_leptico
Carater leptofragmentario (SiBCS Cap 5; Cr / fragmentary 50-100 cm)carater_leptofragmentario
Carater luvissolico (SiBCS Cap 5; Ta + S alta)carater_luvissolico
Carater nitossolico (SiBCS Cap 5)carater_nitossolico
Carater palico (SiBCS Cap 11)carater_palico
Carater perferrico (SiBCS Cap 1; Cap 6 CX Perferricos)carater_perferrico
Carater petroplintico (SiBCS Cap 5)carater_petroplintico
Carater placico (SiBCS Cap 5; horizonte placico cementado por Fe/Mn)carater_placico
Carater planossolico (SiBCS Cap 5)carater_planossolico
Carater plintico (SiBCS Cap 1, p 36): plintita >= 5% em quantidade insuficiente para horizonte plintico.carater_plintico
Carater psamitico (SiBCS Cap 10)carater_psamitico
Carater redoxico (SiBCS Cap 1, p 36-37): feicoes redoximorficas em quantidade pelo menos comum, dentro da secao de controle. 'epirredoxico' se dentro de 50 cm; 'endorredoxico' se 50-150 cm.carater_redoxico
Carater retratil (SiBCS Cap 1, p 33)carater_retratil
Carater rubrico (SiBCS Cap 1; Cap 10 Latossolos Brunos)carater_rubrico
Carater salico (SiBCS Cap 1, p 38): CE >= 7 dS/m em alguma epoca.carater_salico
Carater salino (SiBCS Cap 1, p 39): 4 <= CE < 7 dS/m.carater_salino
Carater saprolitico (SiBCS Cap 5)carater_saprolitico
Carater sodico (SiBCS Cap 1, p 39): saturacao por sodio (PST) >= 15%.carater_sodico
Carater solodico (SiBCS Cap 1, p 39): PST entre 6% e < 15%.carater_solodico
Carater sombrico (SiBCS Cap 1; Cap 5 PV)carater_sombrico
Carater terrico (SiBCS Cap 14)carater_terrico
Carater tionico (SiBCS Cap 9; Cap 1 thionic-related)carater_tionico
Carater vertissolico (SiBCS Cap 6)carater_vertissolico
Cerosidade quantitativa (SiBCS Cap 13, p 207; Cap 1)cerosidade
Chernic horizon (WRB 2022): the cherozemic-style mollic with very high biological activity (worm holes, casts, coprolites). v0.3.3: delegates to mollic + worm_holes_pct >= 50 (proxy for "biological homogenization").chernic
Chernossolos (SiBCS Cap 4, p 113; conceito Cap 3, p 89-90)chernossolo
Chernossolos Argiluvicos (Cap 7): B textural abaixo do A chernozemico.chernossolo_argiluvico
Chernossolos Ebanicos (Cap 7): caracter ebanico em B. v0.7.1: detecta via Munsell em B - hue 7.5YR ou mais amarelo: V<4 + C<3 umido; OR hue mais vermelho 7.5YR: preto/cinza muito escuro.chernossolo_ebanico
Chernossolos Haplicos (catch-all).chernossolo_haplico
Chernossolos Rendzicos (Cap 7): A chernozemico + (calcico/petrocalcico OR carater carbonatico).chernossolo_rendzico
Chernozem RSG diagnostic (WRB 2022)chernozem
Chernozem RSG gate (strengthened, WRB 2022 Ch 4, p 111)chernozem_strict
Claric material (WRB 2022 Ch 3.3.4): light-coloured fine earth with Munsell criteria.claric_material
Robustness of classification under input perturbationclassification_robustness
ClassificationResult: structured outcome of running a keyClassificationResult
Classify a pedon across all three taxonomic systemsclassify_all
Classify a soil by spectral similarity to OSSL reference profilesclassify_by_spectral_neighbours
Build a fully-classified `PedonRecord` from documents in one callclassify_from_documents
Classifica um pedon segundo o SiBCS 5a edicao (1o + 2o + 3o + 4o niveis)classify_sibcs
Classifica um perfil no 5o nivel categorico do SiBCS (Familia)classify_sibcs_familia
Classify a pedon under USDA Soil Taxonomy (13th edition)classify_usda
Classify a PedonRecord via Embrapa's SmartSolosExpert REST APIclassify_via_smartsolos_api
Classify a pedon with the engine chosen by `pick_engine()`classify_with_engine_heuristic
Classify a pedon under WRB 2022classify_wrb2022
Clear the in-memory KST13 cacheclear_kst13_cache
Clear the soilKey OSSL cacheclear_ossl_cache
Combine multiple spatial priors via weighted geometric meancombine_priors
Side-by-side comparison of soilKey vs aqp diagnostic enginescompare_engines
Cross-validate the local SiBCS classifier against the SmartSolosExpert APIcompare_smartsolos
Ki (silica:alumina molar) - SiBCS Cap 1, p 32compute_ki
Kr (silica:sesquioxidos molar) - SiBCS Cap 1, p 32compute_kr
Contato litico (SiBCS Cap 1, p 40): rocha continua dura. Reuso de 'continuous_rock' via designacao R / Cr.contato_litico
Contato litico fragmentario (SiBCS Cap 1, p 40): rocha fragmentada.contato_litico_fragmentario
Continuous rock (WRB 2022 Ch 3.2.5)continuous_rock
Cryic conditions (WRB 2022)cryic_conditions
Cryoturbation (USDA Soil Taxonomy, 13th edition)cryoturbation_usda
Cumulic Subgroup helper (Mollorthels / Umbrorthels)cumulic_subgroup_usda
Densiaquept qualifying (densic contact within 100 cm)densiaquept_qualifying_usda
DiagnosticResult: structured outcome of a diagnostic testDiagnosticResult
Solo distrofico (SiBCS Cap 1, p 30)distrofico
Dolomitic material (WRB 2022 Ch 3.3.5): \>= 2% Mg-rich carbonate, CaCO3/MgCO3 < 1.5. v0.3.3: detects via designation pattern 'kdo|do|magn' as proxy when ratio data missing.dolomitic_material
Download the BDsolos consulta-publica CSV (experimental, requires chromote)download_bdsolos
Download one or more soilKey lazy-fetch caches from GitHub Releasedownload_extdata_cache
Download an OSSL subset and return an `ossl_library` artefactdownload_ossl_subset
Download an OSSL subset and attach WRB / SiBCS / USDA labelsdownload_ossl_subset_with_labels
Download the curated Redape GeoTab dataset (Vaz et al 2023)download_redape_dataset
Duric horizon (WRB 2022)duric_horizon
Duric Subgroup helper (USDA Spodosols)duric_subgroup_usda
Duripa (SiBCS Cap 2, p 74; v0.7)duripa
Duripan (USDA, KST 13ed Ch 3, pp 36-37)duripan_usda
Dystric Subgroup helper (Vertisols Dystr*) Pass when BS (NH4OAc) < 50% in some part of the upper 100 cm.dystric_subgroup_usda
Entic Subgroup helper (Spodosols)entic_subgroup_usda
Entisols (USDA Cap 8): catch-all for soils that don't match any other Order. Always passes.entisol_usda
Episaturation helper (USDA, KST 13ed Ch 3, p 41) Pass when aquic conditions PLUS perched water (saturation type "episaturation").episaturation_usda
Espodossolos (SiBCS Cap 4, p 112; conceito Cap 3, p 90-91)espodossolo
Espodossolos Ferri-humiluvicos (Cap 8): B espodico tipo Bhs OR catch-all dos espodossolos.espodossolo_ferri_humiluvico
Espodossolos Ferriluvicos (Cap 8): B espodico tipo Bs (Fe + Al, baixo OC iluvial).espodossolo_ferriluvico
Espodossolos Humiluvicos (Cap 8): B espodico tipo Bh (org. + Al, pouco/sem Fe).espodossolo_humiluvico
Eutric Inceptisol Suborder helper (Eutrudepts) Pass when BS (NH4OAc) >= 60% in some part of upper 75 cm.eutric_inceptisol_usda
Eutric Oxisol Suborder helper (Eutroperox/Eutrudox/etc.) Pass when BS (NH4OAc) >= 35% in all layers within 125 cm.eutric_oxisol_usda
Eutric Subgroup helper (Andisols) Pass when base_saturation (sum-of-cations) >= 50% in some part.eutric_subgroup_usda
Solo eutrofico (SiBCS Cap 1, p 30)eutrofico
Evaluate the test block of a single RSGevaluate_rsg_tests
Extract horizons from a soil description PDFextract_horizons_from_pdf
Extract Munsell color from a profile photoextract_munsell_from_photo
Extract site metadata from a field-sheet imageextract_site_from_fieldsheet
Familia: propriedades andicas (Cap 1, p 42-43)familia_andico
Familia: subgrupamento de atividade da fracao argila (Cap 18, p 287)familia_atividade_argila
Familia: constituicao esqueletica (Cap 1, p 48)familia_constituicao_esqueletica
Familia: distribuicao de cascalhos no perfil (Cap 1, p 47-48)familia_distribuicao_cascalhos
Familia: grupamento textural (Cap 1, p 46)familia_grupamento_textural
Constroi label textual de Familia a partir de 'classify_sibcs_familia'familia_label
Familia: mineralogia da fracao areia (Cap 18, p 286)familia_mineralogia_areia
Familia: mineralogia da fracao argila (geral, nao-Latossolos)familia_mineralogia_argila_geral
Familia: mineralogia da fracao argila para Latossolos (Cap 18, p 286-287)familia_mineralogia_argila_latossolo
Familia: espessura > 100 cm de material organico em Organossolos (Cap 18, p 287)familia_organossolo_espessura
Familia: lenhosidade em Organossolos (Cap 18, p 288)familia_organossolo_lenhosidade
Familia: material subjacente em Organossolos (Cap 18, p 287)familia_organossolo_material_subjacente
Familia: teor de oxidos de ferro (Cap 1, p 42)familia_oxidos_ferro
Familia: prefixo de profundidade epi-/meso-/endo- (Cap 18, p 284-285)familia_prefixo_profundidade
Familia: saturacao por aluminio - "alico" (Cap 18, p 285)familia_saturacao_aluminio
Familia: saturacao por bases (Cap 18, p 285)familia_saturacao_bases
Familia: subgrupamento textural (Cap 18, p 283; em validacao)familia_subgrupamento_textural
Familia: tipo de horizonte diagnostico superficial (Cap 2)familia_tipo_horizonte_superficial
Classe S4-like para atributos de Familia (5o nivel SiBCS)FamilyAttribute
Curated index of FEBR datasets that carry Munsell colorsfebr_index_munsell
Ferralic horizon (WRB 2022)ferralic
Ferralsol RSG gate (WRB 2022 Ch 4, p 110)ferralsol
Ferric horizon (WRB 2022)ferric
Ferric Subgroup helper (Ferrudalfs) Pass when iron-rich (fe_dcb_pct >= 4%) horizon present in B.ferric_subgroup_usda
Fibric_predominant_usda: Fibrists Suborder qualifierfibric_predominant_usda
Fibric Subgroup helper (Haplohemists / Haplowassists / Sulfiwassists) Pass when fibric layers cumulative thickness >= 25 cm in control section below surface tier.fibric_subgroup_usda
Material organico fibrico (SiBCS Cap 14)fibrico
Fill missing soil attributes from spectra via OSSLfill_from_spectra
Fill missing Munsell colors on a PedonRecord from Vis-NIR spectrafill_munsell_from_spectra
Fluvaquentic Subgroup helper (irregular OC decrease + aquic)fluvaquentic_usda
Fluvent Suborder qualifier (irregular OC decrease in 25-125 cm, OR layered alluvial designation).fluvent_qualifying_usda
Fluventic Subgroup helper (irregular OC decrease, NO aquic req.)fluventic_usda
Fluvic material (WRB 2022)fluvic_material
Folists Suborder qualifier (KST 13ed, Ch 10, p 200)folist_qualifying_usda
Folistic epipedon (USDA Soil Taxonomy, 13th edition)folistic_epipedon_usda
Folistic Subgroup helper (folistic_epipedon present)folistic_subgroup_usda
Format a WRB 2022 soil name with qualifiersformat_wrb_name
Fragic horizon (WRB 2022): a high-bulk-density horizon with restricted rooting. v0.3.3: detects via bulk_density_g_cm3 >= 1.65 AND structure grade massive/very firm OR designation pattern 'x'/'Bx'.fragic
Fragipa (SiBCS Cap 2, p 73-74; v0.7)fragipa
Fragipan (USDA, KST 13ed Ch 3, p 38)fragipan_usda
Frasiwassists Subgroup helper (Wassists)frasic_qualifying_usda
Convert an aqp SoilProfileCollection back to a list of PedonRecordfrom_aqp
Fulvic Andisols: similar to melanic but with melanic_index > 1.70 (more humic acid). v0.8: detected via OC >= 6 in cumulative 30 cm but WITHOUT melanic_epipedon (since melanic requires index <= 1.70).fulvic_andisol_usda
Gelisols (USDA Cap 9): gelic conditions / permafrost.gelisol_usda
Glacic layer (USDA Soil Taxonomy, 13th edition)glacic_layer_usda
Gleissolos (SiBCS Cap 4, p 112-113; conceito Cap 3, p 91-93)gleissolo
Gleissolos Haplicos (catch-all).gleissolo_haplico
Gleissolos Melanicos (Cap 9): horizonte hístico < 40 cm OR A humico, proeminente, chernozemico.gleissolo_melanico
Gleissolos Salicos (Cap 9): caracter salico em < 100 cm.gleissolo_salico
Gleissolos Tiomorficos (Cap 9): materiais sulfidricos OR horizonte sulfurico em < 100 cm.gleissolo_tiomorfico
Gleyic properties (WRB 2022)gleyic_properties
Gleysol RSG gate (WRB 2022 Ch 4, p 103)gleysol
Glossic Subgroup helper (Glossaqualfs, Glossocryalfs, Glossudalfs) Pass when interfingering of albic materials into argillic horizon is detected. v0.8 proxy: albic + argillic + lateral chroma <= 2 on argillic boundary.glossic_subgroup_usda
Default-value-for-NULL operator%||% grapes-or-or-grapes
Grossarenic Subgroup helper: sandy throughout, spodic >= 125 cm.grossarenic_subgroup_usda
Default GlobalSoilMap depth intervals (cm)GSM_DEPTHS
Gypsic horizon (WRB 2022)gypsic
Gypsic horizon (USDA, delegates to WRB gypsic).gypsic_horizon_usda
Gypsic Subgroup helper - delegates to gypsic_horizon_usda.gypsic_subgroup_usda
Gypsiric material (WRB 2022 Ch 3.3.7): \>= 5% gypsum that is primary (not secondary). Without a "secondary fraction" schema column, v0.3.3 treats any layer with caso4_pct >= 5 as gypsiric unless it explicitly carries gypsic-horizon designation.gypsiric_material
Halic helper for Halaquepts Pass when EC >= 8 dS/m within 100 cm.halaquept_qualifying_usda
Halic Subgroup helper (Haplosaprists)halic_subgroup_usda
Harmonise pedons to GlobalSoilMap depth intervalsharmonize_to_gsm
Hemic Subgroup helperhemic_subgroup_usda
Material organico hemico (SiBCS Cap 14)hemico
Histels Suborder qualifier (USDA, KST 13ed)histel_qualifying_usda
Histic epipedon (USDA Soil Taxonomy, 13th edition)histic_epipedon_usda
Histic horizon (WRB 2022)histic_horizon
Histic Subgroup helper (in Spodosols, Aquods) Pass when histic_epipedon_usda passes.histic_subgroup_usda
Histosols Order qualifier (USDA, KST 13ed, Ch 2, p 7)histosol_qualifying_usda
Histosols (USDA Cap 10): organic materials >= 40 cm in 0-100. Refined v0.8.4 - now uses histosol_qualifying_usda (40 cm threshold) instead of WRB histic_horizon (10 cm).histosol_usda
Horizonte A antropico (SiBCS) (SiBCS Cap 2, p 53)horizonte_A_antropico
Horizonte A chernozemico (SiBCS Cap 2, p 50-51)horizonte_A_chernozemico
Horizonte A fraco (SiBCS Cap 2, p 53): cor clara + estrutura grao simples/macica + OC < 6 g/kg; OR espessura < 5 cm.horizonte_A_fraco
Horizonte A humico (SiBCS Cap 2, p 51-52)horizonte_A_humico
Horizonte A moderado (SiBCS Cap 2, p 53-54): catch-all. Returns TRUE quando o solo tem horizonte superficial mas nao se enquadra nas demais classes diagnosticas superficiais.horizonte_A_moderado
Horizonte A proeminente (SiBCS Cap 2, p 52-53)horizonte_A_proeminente
Horizonte calcico (SiBCS Cap 2, p 71-72; v0.7)horizonte_calcico
Horizonte concrecionario (SiBCS Cap 2, p 68-69; v0.7)horizonte_concrecionario
Horizonte E albico (SiBCS Cap 2, p 66-67; v0.7)horizonte_E_albico
Horizonte glei (SiBCS Cap 2, p 69-71; v0.7)horizonte_glei
Horizonte histico (SiBCS Cap 2, p 49-50)horizonte_histico
Horizonte litoplintico (SiBCS Cap 2, p 69; v0.7)horizonte_litoplintico
Horizonte petrocalcico (SiBCS Cap 2, p 72; v0.7)horizonte_petrocalcico
Horizonte plintico (SiBCS Cap 2, p 67-68; v0.7)horizonte_plintico
Horizonte sulfurico (SiBCS Cap 2, p 72-73; v0.7)horizonte_sulfurico
Horizonte vertico (SiBCS Cap 2, p 73; v0.7)horizonte_vertico
Hortic horizon (WRB 2022): garden / kitchen-midden topsoil. Diagnostic criteria: thickness \>= 20 cm, dark colour (mollic-like), high P (Mehlich-3 P >= 100 mg/kg or P2O5_1pct_citric >= 175 mg/kg), high SOC.hortic
Humic Andisols Subgroup helper Pass when mollic OR umbric epipedon present.humic_andisol_usda
Humic Inceptisol Suborder helper (Hum*) Pass when umbric or mollic epipedon present + thick (>= 25 cm).humic_inceptisol_usda
Humic-Oxisol Subgroup helper Pass when cumulative organic carbon mass is >= 16 kg/m2 between surface and 100 cm (computed as SUM(OC% * bulk_density * dz)). v0.8 proxy: uses default bulk_density 1.0 g/cm3 if unavailable.humic_oxisol_usda
Humic-spodic Suborder/GG check (>= 6% OC in 10+ cm of spodic)humic_spodic_usda
Humic Subgroup helper (Humic Duricryods / Humic Placocryods) Pass when spodic horizon has >= 6% OC in 10+ cm.humic_subgroup_usda
Humilluvic Subgroup helper (Luvihemists)humilluvic_subgroup_usda
Humult Suborder qualifier (Ultisols with thick humus accumulation) Pass when 0.9% OC weighted average in 0-15 cm AND/OR organic carbon mass >= 12 kg/m2 in 0-100 cm (proxy via humic_oxisol_usda with lower threshold).humult_qualifying_usda
Hydragric horizon (WRB 2022): subsoil hydric horizon under anthraquic. v0.3.3 detects via designation pattern 'Bg|Brg' immediately below an anthraquic-like topsoil.hydragric
Hydric Aquent helper (Hydraquents) Pass when surface 0-50 has high water content (n value high). v0.8 proxy: water_content_1500kpa >= 80% in surface.hydraquent_qualifying_usda
Hydric (Andisols): 1500 kPa water retention >= 70% on undried samples throughout a 35+ cm layer within 100 cm.hydric_andisol_usda
Hydric Subgroup helper (Histosols Cryofibrists / Sphagnofibrists / etc.)hydric_subgroup_usda
Hypersulfidic material (WRB 2022 Ch 3.3.8): \>= 0.01% inorganic sulfidic S, pH \>= 4, capable of severe acidification on aerobic incubation.hypersulfidic_material
Hyposulfidic material (WRB 2022 Ch 3.3.9): same S and pH as hypersulfidic but does NOT consist of hypersulfidic (i.e. not capable of severe acidification). v0.3.3: returns sulfidic layers that don't meet hypersulfidic.hyposulfidic_material
Inceptisol Order qualifier Pass when a cambic horizon is present (no argillic, no spodic, no mollic, etc. - enforced by prior order exclusion).inceptisol_qualifying_usda
Inceptisols (USDA Cap 11): cambic horizon (or several alternative subsurface diagnostics: folistic/histic/mollic with thin sub, salic, sodium-affected sub).inceptisol_usda
Diagnostic inspection of a BDsolos CSV before loadinginspect_bdsolos_csv
Irragric horizon (WRB 2022): topsoil thickened by irrigation deposits. v0.3.3: thickness >= 20 cm + sediment-derived structure proxied via designation 'Apk|Apg|Au'.irragric
Kandic horizon (USDA, KST 13ed Ch 3, p 45)kandic_horizon_usda
Kandic Suborder helper for Oxisols (Kandiperox/Kandiudox/Kandiustox) Delegates to kandic_horizon_usda.kandic_oxisol_usda
Kanhapl qualifying helper (Kanhapludults / Kanhaplustults / etc.) Pass when kandic horizon present BUT NOT meeting Pale criteria (i.e. younger / less developed kandic).kanhapl_qualifying_usda
Kastanozem RSG diagnostic (WRB 2022)kastanozem
Kastanozem RSG gate (strengthened, WRB 2022 Ch 4, p 112)kastanozem_strict
Keys to Soil Taxonomy 13th edition canonical referencekst13_canonical
Load the canonical KST 13ed code -> taxon-name lookup tablekst13_codes
Load the canonical KST 13ed criteria for a single taxon codekst13_criteria
Lamellic Subgroup helper (Spodosols Haplorthods)lamellic_subgroup_usda
Latossolos (SiBCS Cap 4, p 113; conceito Cap 3, p 93-94)latossolo
Latossolos Amarelos (Cap 10): matiz \>= 7.5YR (mais amarelo).latossolo_amarelo
Latossolos Brunos (Cap 10): matiz \>= 7.5YR + valor \<= 4 + croma \<= 5 (cores brunadas) OR caracter retratil.latossolo_bruno
Ki/Kr para Latossolos (SiBCS Cap 10, p 173-176)latossolo_ki_kr
Latossolos Vermelhos (Cap 10): matiz \<= 2.5YR (mais vermelho).latossolo_vermelho
Latossolos Vermelho-Amarelos (catch-all).latossolo_vermelho_amarelo
Leptic features (WRB 2022)leptic_features
Limnic material (WRB 2022 Ch 3.3.10): subaquatic deposits (coprogenous earth, diatomaceous earth, marl, gyttja). v0.3.3: detects via 'rock_origin %in% c("lacustrine", "marine")' or designation pattern.limnic_material
Limnic Subgroup helper (Histels)limnic_usda
Limonic horizon (WRB 2022 Ch 3.1)limonic
Lithic contact within X cm of the surface (USDA Subgroup helper)lithic_contact_usda
Lithic discontinuity (WRB 2022 Ch 3.2.7)lithic_discontinuity
Lixisol RSG diagnostic (WRB 2022)lixisol
Load Africa Soil Profiles (AfSP) v1.2 as PedonRecord objectsload_afsp_pedons
Load the bundled AfSP stratified sample (v0.9.77)load_afsp_sample
Load a BDsolos CSV export as a list of PedonRecord objectsload_bdsolos_csv
Load Embrapa dadosolos pedons with reference SiBCS classificationload_embrapa_pedons
Load the Embrapa FEBR superconjunto into a list of PedonRecordsload_febr_pedons
Load the bundled KSSL + NASIS morphological-enriched sample (v0.9.75)load_kssl_nasis_sample
Load NCSS / KSSL pedons with reference USDA Soil Taxonomy classificationload_kssl_pedons
Load KSSL / NCSS pedons from the ncss_labdata GeoPackageload_kssl_pedons_gpkg
Load KSSL pedons enriched with NASIS morphologyload_kssl_pedons_with_nasis
Load the bundled KSSL/NCSS lab-data sample (v0.9.74)load_kssl_sample
Load EU-LUCAS / ESDB pedons with reference WRB classificationload_lucas_pedons
Load the LUCAS Soil 2018 Topsoil release as a list of PedonRecord objectsload_lucas_soil_2018
Load curated soil profiles from the Embrapa Redape GeoTab datasetload_redape_pedons
Load a soilKey rule set (YAML)load_rules
Load the bundled WoSIS South-America sampleload_wosis_sample
Load the bundled WoSIS stratified RSG-balanced sample (v0.9.73)load_wosis_stratified_sample
Look up an ESDB raster value at WGS84 coordinateslookup_esdb
Look up a MapBiomas Solos raster value at WGS84 coordinateslookup_mapbiomas_solos
Look up a SoilGrids 250m soil property at WGS84 coordinateslookup_soilgrids
Luvisol RSG diagnostic (WRB 2022)luvisol
Luvissolos (SiBCS Cap 4, p 113; conceito Cap 3, p 95-96)luvissolo
Luvissolos Cromicos (Cap 11): caracter cromico (cores fortes em B). Aplicado pela presenca de Munsell vermelho-amarelado em B com cromas altos.luvissolo_cromico
Luvissolos Haplicos (catch-all).luvissolo_haplico
Build the canonical Acrisol fixturemake_acrisol_canonical
Build the canonical Alisol fixturemake_alisol_canonical
Build the canonical Andosol fixturemake_andosol_canonical
Build the canonical Anthrosol fixturemake_anthrosol_canonical
Build the canonical Arenosol fixturemake_arenosol_canonical
Perfil canonico de Argissolo (SiBCS 5a ed., Cap 5)make_argissolo_canonical
Build the canonical Calcisol fixturemake_calcisol_canonical
Build the canonical Cambisol fixturemake_cambisol_canonical
Perfil canonico de Cambissolo (SiBCS 5a ed., Cap 6)make_cambissolo_canonical
Perfil canonico de Chernossolo (SiBCS 5a ed., Cap 7)make_chernossolo_canonical
Build the canonical Chernozem fixturemake_chernozem_canonical
Build the canonical Cryosol fixturemake_cryosol_canonical
Build the canonical Durisol fixturemake_durisol_canonical
Build an empty horizons data.table with the canonical schemamake_empty_horizons
Perfil canonico de Espodossolo (SiBCS 5a ed., Cap 8)make_espodossolo_canonical
Build the canonical Ferralsol fixturemake_ferralsol_canonical
Build the canonical Fluvisol fixturemake_fluvisol_canonical
Perfil canonico de Gleissolo (SiBCS 5a ed., Cap 9)make_gleissolo_canonical
Build the canonical Gleysol fixturemake_gleysol_canonical
Build the canonical Gypsisol fixturemake_gypsisol_canonical
Build the canonical Histosol fixturemake_histosol_canonical
Build the canonical Kastanozem fixturemake_kastanozem_canonical
Perfil canonico de Latossolo (SiBCS 5a ed., Cap 10)make_latossolo_canonical
Build the canonical Leptosol fixturemake_leptosol_canonical
Build the canonical Lixisol fixturemake_lixisol_canonical
Build the canonical Luvisol fixturemake_luvisol_canonical
Perfil canonico de Luvissolo (SiBCS 5a ed., Cap 11)make_luvissolo_canonical
Perfil canonico de Neossolo Litolico (SiBCS 5a ed., Cap 12)make_neossolo_canonical
Build the canonical Nitisol fixturemake_nitisol_canonical
Perfil canonico de Nitossolo Vermelho (SiBCS 5a ed., Cap 13)make_nitossolo_canonical
Perfil canonico de Organossolo (SiBCS 5a ed., Cap 14)make_organossolo_canonical
Build the canonical Phaeozem fixturemake_phaeozem_canonical
Build the canonical Planosol fixturemake_planosol_canonical
Perfil canonico de Planossolo (SiBCS 5a ed., Cap 15)make_planossolo_canonical
Build the canonical Plinthosol fixturemake_plinthosol_canonical
Perfil canonico de Plintossolo (SiBCS 5a ed., Cap 16)make_plintossolo_canonical
Build the canonical Podzol fixturemake_podzol_canonical
Build the canonical Retisol fixturemake_retisol_canonical
Build the canonical Solonchak fixturemake_solonchak_canonical
Build the canonical Solonetz fixturemake_solonetz_canonical
Build the canonical Stagnosol fixturemake_stagnosol_canonical
Build a synthetic PedonRecord with attached spectra (testing aid)make_synthetic_pedon_with_spectra
Build the canonical Technosol fixturemake_technosol_canonical
Build the canonical Umbrisol fixturemake_umbrisol_canonical
Build the canonical Vertisol fixturemake_vertisol_canonical
Perfil canonico de Vertissolo (SiBCS 5a ed., Cap 17)make_vertissolo_canonical
Melanic Andisols: melanic_epipedon present.melanic_andisol_usda
Melanic epipedon (USDA Soil Taxonomy, 13th edition)melanic_epipedon_usda
Mineral material (WRB 2022 Ch 3.3.11): < 20% SOC AND < 35% volume artefacts containing >= 20% organic carbon. The complement of organic_material / organotechnic_material.mineral_material
Mollic horizon (WRB 2022)mollic
Mollic epipedon (USDA Soil Taxonomy, 13th edition)mollic_epipedon_usda
Mollisol Order qualifier (USDA, KST 13ed, Ch 12) Pass when mollic_epipedon AND BS (NH4OAc) >= 50% in upper 100 cm.mollisol_qualifying_usda
Mollisols (USDA Cap 12): mollic epipedon + base saturation >= 50%.mollisol_usda
Mudanca textural abrupta (SiBCS Cap 1, p 30-31)mudanca_textural_abrupta
Mulmic material (WRB 2022 Ch 3.3.12): mineral material developed from organic material; \>= 8% SOC, with low BD, structural / chroma criteria.mulmic_material
Natric horizon (WRB 2022)natric_horizon
Natric horizon helper (USDA, KST 13ed Ch 3)natric_horizon_usda
Natric Subgroup helper for Natraquerts.natric_subgroup_usda
Neossolos (SiBCS Cap 4, p 111-112; conceito Cap 3, p 96-97)neossolo
Neossolos Fluvicos (Cap 12): caracter fluvico em < 150 cm.neossolo_fluvico
Neossolos Litolicos (Cap 12): contato litico ou litico fragmentario \<= 50 cm.neossolo_litolico
Neossolos Quartzarenicos (Cap 12): textura areia/areia franca em todos os horizontes ate 150 cm + 95% quartzo.neossolo_quartzarenico
Neossolos Regoliticos (catch-all dos Neossolos).neossolo_regolitico
Nitic horizon (WRB 2022)nitic_horizon
Nitossolos (SiBCS Cap 4, p 114; conceito Cap 3, p 97-98)nitossolo
Nitossolos Brunos (Cap 13): matiz \>= 7.5YR + valor <= 4 + croma <= 5.nitossolo_bruno
Nitossolos Haplicos (catch-all).nitossolo_haplico
Nitossolos Vermelhos (Cap 13): matiz \<= 2.5YR.nitossolo_vermelho
Nitric Subgroup helper (Anhyturbels / Anhyorthels)nitric_subgroup_usda
Canonicalise FEBR SiBCS names to match soilKey rule outputs.normalise_febr_sibcs
Normalise FEBR USDA taxon strings to USDA Soil Taxonomy Ordernormalise_febr_usda
Normalise FEBR WRB taxon strings to RSG-onlynormalise_febr_wrb
Normalise KSSL USDA subgroup labels for benchmark comparisonnormalise_kssl_subgroup
Ochric epipedon (USDA Soil Taxonomy, 13th edition)ochric_epipedon_usda
Is the local Ollama HTTP API reachable?ollama_is_running
Organic material (WRB 2022 Ch 3.3.13): \>= 20% SOC + recognisability criteria. v0.3.3: SOC threshold only.organic_material
Organossolos (SiBCS Cap 4, chave do 1o nivel; conceito Cap 3, p 99-101)organossolo
Organossolos Folicos (Cap 14): horizonte O histico (drenado). Detectado via designation pattern \"^O\".organossolo_folico
Organossolos Haplicos (catch-all).organossolo_haplico
Organossolos Tiomorficos (Cap 14): materiais sulfidricos OR horizonte sulfurico em < 100 cm.organossolo_tiomorfico
Organotechnic material (WRB 2022 Ch 3.3.14): \>= 35% volume of artefacts that themselves contain \>= 20% organic C. Soil itself has < 20% SOC.organotechnic_material
Ornithogenic material (WRB 2022 Ch 3.3.15): bird-influenced topsoil. Mehlich-3 P >= 750 mg/kg + designation pattern 'Aornit|Bornit'.ornithogenic_material
Synthetic OSSL South America demo subsetossl_demo_sa
Canonical schema for an `ossl_library` objectossl_library_template
Oxic horizon (USDA, KST 13ed, Ch 3) Delegates to WRB 'ferralic'.oxic_horizon_usda
Oxic horizon (USDA Soil Taxonomy)oxic_usda
Oxisol (USDA Cap 13): oxic horizon, excluding profiles with an argillic horizon overlying the oxic.oxisol_usda
Oxyaquic Subgroup helper (Spodosols, Mollisols, etc.)oxyaquic_subgroup_usda
Pachic Subgroup helper (Andisols, Mollisols) Pass when mollic OR umbric epipedon is >= 50 cm thick.pachic_subgroup_usda
Pale qualifying helper (Paleudults / Paleustults / Palexerults / Palehumults / Paleaquults)pale_qualifying_usda
Paleargid qualifying helper Pass when argillic horizon has continuous clay films AND clay >> 35% in upper 10 cm (proxy for old, well-developed argillic). v0.8 proxy: argillic + clay_pct >= 35 in upper 30 cm.paleargid_qualifying_usda
Panpaic horizon (WRB 2022 Ch 3.1)panpaic
JSON Schema for a soilKey PedonRecordpedon_json_schema
Convert a soilKey PedonRecord to an aqp SoilProfileCollectionpedon_to_spc
PedonRecord: structured representation of a single pedonPedonRecord
Permafrost (USDA Soil Taxonomy, 13th edition)permafrost_within_usda
Petrocalcic horizon (WRB 2022)petrocalcic
Petrocalcic Subgroup helper (Aridisols Petrocalcids) Cemented calcic horizon with cementation_class >= "strongly".petrocalcic_subgroup_usda
Petroduric horizon (WRB 2022): cemented duric.petroduric
Petroferric contact helper (USDA, KST 13ed Ch 3, p 48)petroferric_contact_usda
Petrogypsic horizon (WRB 2022): cemented gypsic.petrogypsic
Petrogypsic horizon helper (USDA)petrogypsic_horizon_usda
Petrogypsic Subgroup helper - delegate to petrogypsic_horizon_usdapetrogypsic_subgroup_usda
Petronodic Subgroup helper (Aridisols) Pass when 5%+ rock fragments cemented by carbonates within 100 cm. v0.8 proxy: caco3_pct >= 15 AND coarse_fragments_pct >= 5.petronodic_subgroup_usda
Petroplinthic horizon (WRB 2022): cemented plinthic.petroplinthic
Phaeozem RSG diagnostic (WRB 2022)phaeozem
Map a 95% prediction interval to a [0, 1] confidence scorepi_to_confidence
Choose the best diagnostic engine for a single pedonpick_engine
Per-pedon batch engine recommendationpick_engine_batch
Pisoplinthic horizon (WRB 2022): pisolitic plinthic. v0.3.3 detects via designation pattern 'Bspl' / 'Bvpi' or via plinthite \>= 15% AND structure_type containing 'pisol'.pisoplinthic
Placic horizon (USDA, KST 13ed Ch 3, pp 47-48)placic_horizon_usda
Plaggic horizon (WRB 2022): sod-derived topsoil >= 20 cm with low BD AND independent evidence of human input.plaggic
Planic features (WRB 2022)planic_features
Planosol RSG gate (WRB 2022 Ch 4, p 107)planosol
Planossolos (SiBCS Cap 4, p 112; conceito Cap 3, p 101-102)planossolo
Planossolos Haplicos (catch-all).planossolo_haplico
Planossolos Natricos (Cap 15): caracter sodico em \< 100 cm.planossolo_natrico
Plinth qualifying helper (Plinth*ults) Pass when plinthite >= 5% in 50%+ of layers within 150 cm.plinth_subgroup_usda
Plinthaquox qualifying helper (Aquox: continuous plinthite phase) Pass when plinthite >= 50% in some 10+ cm layer (continuous phase proxy).plinthaquox_qualifying_usda
Plinthic horizon (WRB 2022)plinthic
Plinthic Subgroup helper (Oxisols) Pass when plinthite >= 5% in any horizon within 125 cm.plinthic_subgroup_usda
Plintossolos (SiBCS Cap 4, p 113; conceito Cap 3, p 102-104)plintossolo
Plintossolos Argiluvicos (Cap 16): horizonte plintico + B textural OR carater argiluvico.plintossolo_argiluvico
Plintossolos Haplicos (catch-all).plintossolo_haplico
Plintossolos Petricos (Cap 16): horizonte concrecionario OR litoplintico (sem horizonte plintico precedendo).plintossolo_petrico
Bayesian posterior classifier (optional)posterior_classify
Predict soil properties from spectrapredict_from_spectra
Predict CIE Lab from Vis-NIR reflectance spectrapredict_lab_from_spectra
Predict Munsell hue / value / chroma from Vis-NIR reflectance spectrapredict_munsell_from_spectra
Memory-based learning prediction against the OSSL librarypredict_ossl_mbl
Local PLSR prediction against the OSSL librarypredict_ossl_plsr_local
Pre-trained OSSL predictionpredict_ossl_pretrained
Predict CIE XYZ tristimulus values from Vis-NIR reflectance spectrapredict_xyz_from_spectra
Predict from a soilKey_pls_modelpredict.soilKey_pls_model
Pre-process Vis-NIR or MIR spectrapreprocess_spectra
Pretic horizon (WRB 2022): "Amazonian Dark Earth" (terra preta de indio) horizon - thick anthropogenic surface with high P, SOC, and incorporated charcoal / pottery.pretic
Print method for soilKey_pls_modelprint.soilKey_pls_model
Check consistency between a deterministic RSG assignment and a spatial priorprior_consistency_check
Protocalcic properties (WRB 2022 Ch 3.2.8)protocalcic_properties
Protogypsic properties (WRB 2022 Ch 3.2.9): visible secondary gypsum \>= 1% but below the gypsic gate.protogypsic_properties
Protovertic horizon (WRB 2022 Ch 3.1)protovertic
Psamment Suborder qualifier (sandy texture: clay + 2*silt < 30 AND no clay films / argillic).psamment_qualifying_usda
Psammentic Subgroup helper (Aquorthels)psammentic_subgroup_usda
Abruptic qualifier (ap): abrupt textural difference within 100 cm.qual_abruptic
Aceric qualifier (ae): pH (1:1 H2O) <= 5 in some layer within the upper 50 cm. Used for sub-aerially exposed acid-sulfate soils (Solonchaks, Gleysols on former tidal flats). v0.9.1: numeric pH gate only; v0.9.2 adds the cross-check against 'thionic' / sulfidic material to disambiguate from naturally acidic Histosols.qual_aceric
Acric qualifier (ac): argic horizon + low CEC + high Al. v0.9: argic + CEC < 24 cmolc/kg clay + exch Al > Ca+Mg+K+Na.qual_acric
Acroxic qualifier (ax): andic + extremely low effective exchange complex (Ca + Mg + K + Na exch + 1 N KCl Al-exch <= 2 cmol+/kg fine earth) in some layer of the andic part within 100 cm.qual_acroxic
Activic supplementary qualifier (av): active aluminium >= 5 cmol/kg WRB 2022 Ch 5: "KCl-extractable Al ('al_kcl_cmol') >= 5 cmol(c)/kg in any layer in upper 100 cm." Proxy via existing 'al_cmol' (exchangeable Al) when al_kcl_cmol absent.qual_activic
Albic qualifier (ab): albic horizon <= 100 cm.qual_albic
Alcalic supplementary qualifier (ac): pH (H2O) >= 9.0 WRB 2022 Ch 5: "Strongly alkaline reaction (pH H2O >= 9 in any layer within 100 cm of the soil surface)."qual_alcalic
Alic qualifier (al): argic + high CEC + high Al saturation.qual_alic
Aluandic qualifier (aa): andic properties + Al-dominant active component (Al / (Al + 0.5 Si) >= 0.5 in mass).qual_aluandic
Andic qualifier (an): andic OR vitric properties combined >= 30 cm. v0.9 simplification: passes if andic_properties or vitric_properties passes within 100 cm.qual_andic
Anofluvic qualifier (af): fluvic material only at depth >= 50 cmqual_anofluvic
Anthraquic qualifier (aq): anthraquic horizon (puddled-rice surface).qual_anthraquic
Anthric qualifier (ak): anthric properties.qual_anthric
Anthromollic qualifier (am): anthric horizon overlying spodicqual_anthromollic
Archaic supplementary qualifier (ah): archeological contextqual_archaic
Arenic qualifier (ar): texture sand or loamy sand >= 30 cm in <= 100 cm.qual_arenic
Arenicolic supplementary qualifier (an): faunal sand burrowsqual_arenicolic
Aric qualifier (ar): mineral surface horizon homogenised by ploughing - designation pattern 'Ap', 'Apk', 'Apc', etc., starting within the upper 30 cm.qual_aric
Bathyspodic supplementary qualifier (bs): spodic at 100-200 cm depthqual_bathyspodic
Biocrustic supplementary qualifier (bk): biological soil crustqual_biocrustic
Brunic qualifier (br): _incipient-only_ subsurface alteration - cambic horizon within the upper 100 cm AND no argic, spodic, ferralic, or nitic horizon present. Used by WRB 2022 Ch 4 for Arenosols that have begun to develop a weak Bw without crossing into Cambisol / Acrisol / Lixisol / Ferralsol territory; in those RSGs the cambic alone is the gating diagnostic and Brunic would be redundant.qual_brunic
Bryic supplementary qualifier (by): bryophyte cover at surfacequal_bryic
Calcaric qualifier (cl): calcaric material >= 25 cm in upper 100 cm.qual_calcaric
Calcic qualifier (cc): calcic horizon <= 100 cm.qual_calcic
Cambic qualifier (cm): cambic horizon <= 50 cm.qual_cambic
Capillaric supplementary qualifier (cp): capillary rise zone WRB 2022 Ch 5: "Capillary rise from a shallow water table to within 50 cm of the soil surface; flagged via redox concentrations (>=2%) + fine texture (clay+silt > 50%)."qual_capillaric
Carbic qualifier (cb): spodic horizon dominated by humus illuviation. v0.9.1: spodic + OC >= 6% in some spodic layer (the WRB threshold for Carbic / "humus-Podzol" expression).qual_carbic
Carbonatic supplementary qualifier (cn): >= 50% carbonatesqual_carbonatic
Carbonic supplementary qualifier (cb): high SOC content (>= 6%)qual_carbonic
Chernic qualifier (ch): chernic horizon (intensely worm-mixed mollic-like) within 100 cm.qual_chernic
Chloridic supplementary qualifier (cl): high chloride WRB 2022 Ch 5: "Containing >= 4 cmol(c)/kg chloride OR EC >= 8 dS/m within 100 cm." Proxy via electrical conductivity field ('ec_ds_m') when chloride is unavailable.qual_chloridic
Chromic qualifier (cr): hue redder than 7.5YR + chroma > 4 (in upper subsoil 25-150 cm).qual_chromic
Clayic qualifier (ce): clay >= 60% texture for a layer >= 30 cm in the upper 100 cm.qual_clayic
Coarsic qualifier (cr): >= 70% coarse fragments by volume in upper 100 cmqual_coarsic
Cohesic supplementary qualifier (co): cohesive horizon (extra-firm dry) WRB 2022 Ch 5: "Containing layers with extreme dry consistence AND moist consistence very firm." Implementation: matches via 'consistence_dry' ("extremely hard") OR 'consistence_moist' ("very firm"), within 100 cm.qual_cohesic
Columnic supplementary qualifier (cm): columnar / prismatic structure WRB 2022 Ch 5: "Columnar or strong prismatic structure (associated with natric horizons)."qual_columnic
Cordic supplementary qualifier (cd): cordic horizonqual_cordic
Cryic qualifier (cy): cryic horizon <= 100 cm.qual_cryic
Cumulic qualifier (cu): a layer of recent depositional material added on top of an existing soil. v0.9.3.B proxy: 'layer_origin' is fluvic / aeolic / solimovic at the top of the profile, OR the uppermost mineral horizon's designation matches '^[AC]u?\d?' (cumulic-style suffix).qual_cumulic
Cutanic qualifier (ct): visible illuvial clay coatings on argic- horizon ped surfaces (the "Cutanic Luvisol" / "Cutanic Argissol" signature). v0.9.1: argic horizon passes AND the schema column 'clay_films_amount' contains "common", "many", or "continuous" (or "shiny" - common Brazilian descriptor for nitic surfaces) in some argic layer.qual_cutanic
Densic qualifier (dn): bulk density >= 1.8 g/cm3 in some root- restricting layer within 100 cm.qual_densic
Differentic supplementary qualifier (df): contrasting layers WRB 2022 Ch 5: "Strong differences (texture, mineralogy, color) between adjacent layers without abrupt textural transition (mild clay-increase 1.2-1.4x ratio)."qual_differentic
Dolomitic qualifier (do): dolomitic material in upper 100 cm.qual_dolomitic
Dorsic supplementary qualifier (do): dorsal-ridge microreliefqual_dorsic
Drainic qualifier (dr): artificially drained organic soil. v0.9.1: site$drainage_class or site$land_use carries an explicit _artificial_ drainage marker AND organic_material passes. Natural drainage classes (e.g. "very poorly drained", "well drained") do NOT trigger Drainic on their own.qual_drainic
Duric qualifier (du): duric horizon <= 100 cm.qual_duric
Dystric qualifier (dy): low base saturation throughout. v0.9: BS < 50% from 20 to 100 cm in mineral material.qual_dystric
Ekranic qualifier (ek): impervious cover (asphalt, concrete) starting within 5 cm of the surface. v0.9.1: technic_hard_material with top depth <= 5 cm.qual_ekranic
Endic supplementary qualifier (ec): generic "in deep horizon" markerqual_endic
Endoabruptic supplementary qualifier (eea): abrupt textural change deepqual_endoabruptic
Endocalcaric qualifier (cae): calcaric only at depth >= 50 cmqual_endocalcaric
Endocalcic qualifier (cam): calcic horizon between 50 and 100 cm.qual_endocalcic
Endodolomitic qualifier (dme): dolomitic only at depth >= 50 cmqual_endodolomitic
Endoduric supplementary qualifier: duric horizon at depth >= 50 cmqual_endoduric
Endodystric supplementary qualifier (eds): dystric only at depthqual_endodystric
Endoeutric supplementary qualifier (eee): eutric only at depthqual_endoeutric
Endogleyic qualifier (eng): gleyic conditions between 50 and 100 cm.qual_endogleyic
Endogypsic supplementary qualifier: gypsic horizon at depth >= 50 cmqual_endogypsic
Endoleptic supplementary qualifier (lle): rock contact 50-100 cmqual_endoleptic
Endostagnic qualifier (ens): stagnic conditions between 50 and 100 cm.qual_endostagnic
Endothionic supplementary qualifier (etn): thionic at depth >= 50 cmqual_endothionic
Endothyric supplementary qualifier (etc): thyric only at depth >= 50qual_endothyric
Entic qualifier (et): albic horizon AND NOT spodicqual_entic
Epic supplementary qualifier (ep): generic "in shallow horizon"qual_epic
Epidystric supplementary qualifier (epd): dystric only in upper 50 cmqual_epidystric
Epieutric supplementary qualifier (eee): eutric only in upper 50 cmqual_epieutric
Escalic supplementary qualifier (es): terraced / stepped morphologyqual_escalic
Eutric qualifier (eu): high base saturation. v0.9: BS >= 50% throughout 20-100 cm.qual_eutric
Eutrosilic qualifier (es): silandic + base saturation >= 50% in some layer of the silandic part within 100 cm.qual_eutrosilic
Evapocrustic supplementary qualifier (ev): evaporite surface crustqual_evapocrustic
Ferralic qualifier (fl): ferralic horizon <= 150 cm.qual_ferralic
Ferric qualifier (fr): ferric horizon <= 100 cm.qual_ferric
Ferritic qualifier (fr): high free-Fe in fine earthqual_ferritic
Fibric qualifier (fi): organic material whose dominant decomposition class in the upper 100 cm is fibric (>= 2/3 fiber). v0.9.1: thickness-weighted dominance via Oi designation.qual_fibric
Floatic qualifier (fc): Histosol that floats on water.qual_floatic
Fluvic qualifier (fv): fluvic material >= 25 cm thick starting <= 75 cm.qual_fluvic
Folic qualifier (fo): folic horizon at the soil surface. v0.9 delegates to histic_horizon with surface-only filter.qual_folic
Fractic qualifier (fc): fractures (cracks) within 100 cmqual_fractic
Garbic qualifier (ga): >= 20% organic-waste artefacts (landfill refuse) in the upper 100 cm. v0.9.1 proxy: designation pattern ('Cgarb|garb|landfill|refuse'). Hard schema column 'artefacts_garbic_pct' scheduled for v0.9.2.qual_garbic
Gelic supplementary qualifier (gl): permafrost or strong frost activity WRB 2022 Ch 5: "Permafrost within 200 cm of the soil surface OR gelic materials." Modifier of cryic_conditions for non-Cryosols.qual_gelic
Gelistagnic supplementary qualifier (gst): stagnic in cold conditions WRB 2022 Ch 5: "Stagnic features (perched water) in cryic regime." Compose: stagnic_pattern + cryic_conditions.qual_gelistagnic
Geoabruptic supplementary qualifier (ga): abrupt change at lithological boundary WRB 2022 Ch 5: "Abrupt textural / mineralogical change at a lithological discontinuity (e.g., 2C horizon below B)." Implementation: designation pattern containing "2C" or "3C" (numeric prefix indicates lithologic discontinuity).qual_geoabruptic
Geric qualifier (gr): in some layer at <= 100 cm, the effective exchange complex (sum of bases + 1 N KCl Al-exchangeable) does not exceed 1.5 cmol+/kg fine earth, OR the soil shows net positive charge (delta pH = pH_KCl - pH_H2O > 0). The "or" path makes Geric / Posic overlap by design (per WRB Ch 5).qual_geric
Gibbsic qualifier (gi): high gibbsite (>= 25%) in fine earthqual_gibbsic
Gilgaic supplementary qualifier (gi): gilgai microrelief WRB 2022 Ch 5: "Gilgai microrelief (associated with vertic shrinking/swelling soils)." Site-level field detection.qual_gilgaic
Glacic qualifier (gc): >= 75% ice by volume within 100 cm. v0.9.1 proxy: cryic conditions + designation pattern ('ice|gel|glac'). Schema column 'ice_pct' scheduled for v0.9.2.qual_glacic
Gleyic qualifier (gl): gleyic properties throughout a layer >= 25 cm starting <= 75 cm + reducing conditions.qual_gleyic
Glossic qualifier (gs): mollic horizon penetrated by albeluvic tongues (glossae). Diagnostic of Glossic Chernozems / Phaeozems on the steppe / forest-steppe transition.qual_glossic
Greyzemic qualifier (gz): mollic / umbric overlain by albic-like layerqual_greyzemic
Grumic qualifier (gr): strong fine granular surface horizon (self-mulching Vertisol).qual_grumic
Gypsic qualifier (gy): gypsic horizon <= 100 cm.qual_gypsic
Gypsiric qualifier (gc): gypsiric material >= 25 cm in upper 100 cm.qual_gypsiric
Haplic qualifier (ha): no other principal qualifier of the RSG applies. Always passes; the qualifier resolution machinery uses it as the default when no other qualifier matched.qual_haplic
Hemic qualifier (hc): organic material whose dominant decomposition class in the upper 100 cm is hemic (1/6 - 2/3 fiber). v0.9.1: thickness-weighted dominance via Oe designation.qual_hemic
Histic qualifier (hi): histic horizon at or near the surface.qual_histic
Hortic qualifier (ht): hortic horizon (long-cultivated dark surface).qual_hortic
Humic qualifier (hu): >= 1% SOC in upper 50 cm (weighted average).qual_humic
Hydragric qualifier (hg): hydragric horizon (puddled-rice subsurface).qual_hydragric
Hydric qualifier (hy): water content at 1500 kPa >= 100% (undried fine earth, WRB 2022). v0.9.1 accepts the air-dried equivalent (>= 70%) when the lab protocol pre-dries; the result is flagged as "potentially over-permissive" via the 'notes' field when the value falls in the 70-100% band.qual_hydric
Hydrophobic supplementary qualifier (hf): water-repellent surfacequal_hydrophobic
Hyperalbic qualifier (ha): albic horizon thicker than 100 cm in a _contiguous_ run (extremely deep eluvial bleaching, common in giant Podzols of tropical white-sand systems and the deepest Stagnosol / Planosol profiles). Non-contiguous albic layers separated by an illuvial Bs / Bt do NOT count toward the threshold.qual_hyperalbic
Hyperalic qualifier (yl): argic horizon with Al saturation >= 50% in some layer of the argic part within 100 cm. Stronger version of Alic.qual_hyperalic
Hyperartefactic qualifier (yr): >= 80% artefacts (any type) in the upper 100 cm.qual_hyperartefactic
Hypercalcic qualifier (yc): calcic horizon AND CaCO3 >= 50% in some calcic layer.qual_hypercalcic
Hyperdystric qualifier (yd): base saturation < 5% throughout the upper 100 cm (mineral soil layers only). Stronger than Dystric (BS < 50%).qual_hyperdystric
Hypereutric qualifier (ye): base saturation >= 80% throughout the upper 100 cm. Stronger than Eutric (BS >= 50%).qual_hypereutric
Hypergypsic qualifier (yg): gypsic horizon AND gypsum >= 60% in some gypsic layer.qual_hypergypsic
Hypernatric supplementary qualifier (hyna): very high Na (>= 70% ESP)qual_hypernatric
Hyperorganic supplementary qualifier (hyo): SOC >= 18% (peat-like) WRB 2022 Ch 5: "Containing organic carbon >= 18% by mass in any layer >= 10 cm thick." A stronger version of `Carbonic`.qual_hyperorganic
Hypersalic qualifier (yz): EC (1:5 H2O extract) >= 30 dS/m in some layer within the upper 100 cm. Stronger than the Salic horizon (default >= 15 dS/m).qual_hypersalic
Hyperskeletic qualifier (hk): coarse fragments >= 90% throughout the upper 100 cm.qual_hyperskeletic
Hypersodic qualifier (yo): ESP >= 50% in some layer within 100 cm. Stronger than Sodic (default ESP >= 6%).qual_hypersodic
Hyperspodic qualifier (hp): spodic horizon with very strong active Al + Fe accumulation (Al_ox + 0.5 * Fe_ox >= 1.5%) - twice the minimum spodic threshold per WRB Ch 3.1. v0.9.1 also requires p-retention >= 85% in the same layers when available.qual_hyperspodic
Hypocalcic qualifier (jc): CaCO3 >= 5% AND < 15% in some layer within 100 cm (between protocalcic 0.5% and the calcic-horizon 15% threshold). Marks the broad "carbonate-bearing" middle band that doesn't meet the Calcic horizon.qual_hypocalcic
Hypogypsic qualifier (jg): gypsum >= 1% AND < 5% in some layer within 100 cm (below the gypsic-horizon threshold but above the protogypsic-properties bare-detection bar).qual_hypogypsic
Hyposalic qualifier (jz): EC (1:5 H2O extract) >= 4 dS/m AND < 15 dS/m in some layer within the upper 100 cm. Used for soils too weak to qualify as Solonchak but still carrying a salinity tag.qual_hyposalic
Hyposodic qualifier (jo): ESP >= 6% AND < 15% in some layer within 100 cm. Marginal sodicity tag.qual_hyposodic
Immissic supplementary qualifier (im): atmospheric immissionqual_immissic
Inclinic supplementary qualifier (in): tilted / inclined position WRB 2022 Ch 5: site has a slope >= 10% (relevo declivoso). Implementation: site$slope_pct (when populated) >= 10 OR parent_material / forma_relevo flagging steep terrain.qual_inclinic
Irragric qualifier (ir): irragric horizon (irrigation-deposited surface).qual_irragric
Isolatic qualifier (il): isolated technic materialqual_isolatic
Isopteric supplementary qualifier (ip): termite / ant biogenesisqual_isopteric
Kalaic supplementary qualifier (ka): dry-season puffed surface layerqual_kalaic
Lamellic qualifier (ll): thin (< 5 cm) clay-enriched lamellae, typical of sandy Luvisols / Alisols / Acrisols. v0.9.3.B proxy: designation pattern 'lamell' / 'E&Bt' / '&Bt' / 'Bt(t)?\d?lam' in any subsurface layer.qual_lamellic
Lapiadic supplementary qualifier (lp): karren / lapies bedrock featuresqual_lapiadic
Laxic supplementary qualifier (lx): loose / non-cohesive surface WRB 2022 Ch 5: "Surface horizon with loose dry consistence and single-grain or massive structure."qual_laxic
Leptic qualifier (le): continuous rock <= 100 cm.qual_leptic
Lignic supplementary qualifier (lg): wood content in organic horizon WRB 2022 Ch 5: "Containing recognisable wood remains (>= 25% by volume or weight) in organic material." Implementation: 'woody_fragments_pct' or layer_origin matching wood.qual_lignic
Limnic qualifier (lm): limnic material (lacustrine / marine subaquatic deposits) anywhere in the profile.qual_limnic
Linic qualifier (li): continuous artificial geomembrane within 100 cm. v0.9.1 proxy: designation pattern ('linic|geomemb|liner').qual_linic
Lithic qualifier (lt): continuous rock starting within 10 cm. Tighter depth gate than Leptic (which is <= 100 cm) and Nudilithic (== 0 cm).qual_lithic
Litholinic supplementary qualifier (ll): stratified soil on rockqual_litholinic
Lixic qualifier (lx): argic + low CEC, low Al.qual_lixic
Loamic qualifier (lo): loam-class texture >= 30 cm in the upper 100 cm.qual_loamic
Luvic qualifier (lv): argic + high CEC, low Al saturation.qual_luvic
Magnesic qualifier (mg): exchangeable Ca/Mg < 1 in upper 100 cm.qual_magnesic
Mahic supplementary qualifier (mh): manure-derived dark surface WRB 2022 Ch 5: "Topsoil enriched by long-term manure / compost application; oc_pct >= 4%, base_saturation_pct >= 50%, and p_mehlich >= 100 mg/kg."qual_mahic
Mawic qualifier (mw): moss-fibre-dominant peatqual_mawic
Mazic qualifier (mz): structureless / massive surface horizon (Vertisol). Diagnostic of slaked, crusted Vertisol surfaces.qual_mazic
Melanic qualifier (me): andic + dark high-OC surface horizon. v0.9.1: thickness >= 30 cm within upper 50 cm, OC weighted >= 6%, Munsell value <= 2 and chroma <= 2 (moist). Melanic Index >= 1.7 (the canonical UV-OD ratio) is deferred to v0.9.2.qual_melanic
Mineralic supplementary qualifier (mn): predominantly mineral WRB 2022 Ch 5: "Predominantly mineral material in upper 100 cm (oc_pct < 12% averaged over depth)."qual_mineralic
Mochipic supplementary qualifier (mp): mottled mochi-like patternqual_mochipic
Mollic qualifier (mo): mollic horizon.qual_mollic
Mulmic qualifier (ml): mulmic material in upper 100 cm.qual_mulmic
Murshic qualifier (mr): partly drained organic with strong decompositionqual_murshic
Muusic qualifier (mu): high-fibre peat (non-moss-specific)qual_muusic
Naramic supplementary qualifier (na): salt-crust morphologyqual_naramic
Natric qualifier (na): natric horizon <= 100 cm.qual_natric
Nechic supplementary qualifier (ne): aeolian / loess deposit patternqual_nechic
Neobrunic qualifier (nb): "young" cambic-like horizonqual_neobrunic
Neocambic qualifier (nc): "young" cambic horizon with weak developmentqual_neocambic
Nitic qualifier (ni): nitic horizon <= 100 cm.qual_nitic
Nudiargic qualifier (nu): argic horizon at the surfacequal_nudiargic
Nudilithic qualifier (nt): continuous rock at the soil surface (top_cm == 0).qual_nudilithic
Nudinatric qualifier (nn): natric horizon at the surfacequal_nudinatric
Ochric qualifier (oh): SOC >= 0.2% upper 10 cm + no mollic/umbric.qual_ochric
Ombric qualifier (om): rain-fed Histosol.qual_ombric
Organotechnic qualifier (ot): organotechnic material in upper 100 cm.qual_organotechnic
Ornithic qualifier (oc): ornithogenic material (bird-influenced topsoil) in the upper 50 cm.qual_ornithic
Orthofluvic qualifier (of): fluvic material 50-100 cmqual_orthofluvic
Ortsteinic qualifier (os): cemented spodic horizon. v0.9.1: spodic horizon + cementation_class strongly OR indurated.qual_ortsteinic
Oxyaquic qualifier (oa): saturation regime without reductionqual_oxyaquic
Oxygleyic qualifier (og): gleyic regime with predominant oxidationqual_oxygleyic
Pachic qualifier (pc): mollic OR umbric horizon >= 50 cm thick.qual_pachic
Pantofluvic qualifier (pf): fluvic material throughout 0-100 cmqual_pantofluvic
Pellic qualifier (pe): in the upper 30 cm, Munsell value <= 4 moist AND chroma <= 2 moist. Diagnostic of "black" (dark) Vertisols.qual_pellic
Pelocrustic supplementary qualifier (pc): clayey surface crustqual_pelocrustic
Petric qualifier (pt): any petro-cemented horizon (petrocalcic / petroduric / petrogypsic / petroplinthic) within 100 cm.qual_petric
Petrocalcic qualifier (pc): petrocalcic horizon <= 100 cm.qual_petrocalcic
Petroduric qualifier (pd): petroduric horizon <= 100 cm.qual_petroduric
Petrogypsic qualifier (pg): petrogypsic horizon <= 100 cm.qual_petrogypsic
Petroplinthic qualifier (pp): petroplinthic horizon <= 100 cm.qual_petroplinthic
Petrosalic qualifier (ptso): cemented salic horizonqual_petrosalic
Pisoplinthic qualifier (px): pisoplinthic horizon within 100 cm.qual_pisoplinthic
Placic qualifier (pi): thin (<= 25 mm = 2.5 cm) cemented Fe pan, typically inside or just above a spodic horizon. v0.9.1: a layer with cementation_class strongly or indurated AND thickness <= 2.5 cm, anywhere in the upper 100 cm.qual_placic
Plaggic qualifier (pa): plaggic horizon (sod-amended surface).qual_plaggic
Plinthic qualifier (pl): plinthic horizon <= 100 cm.qual_plinthic
Posic qualifier (po): net positive permanent charge (pH_KCl > pH_H2O) in some layer at <= 100 cm. Diagnostic of the most weathered Ferralsols where free Fe / Al oxides dominate the surface charge.qual_posic
Pretic qualifier (pt): pretic (pre-Columbian Amerindian dark earth) horizon.qual_pretic
Profondic qualifier (pf): argic horizon that continues, with no clay decrease, down to or below 150 cm. v0.9.3.B: requires 'argic' to pass AND at least one argic layer with 'bottom_cm >= 150'.qual_profondic
Profundihumic qualifier (ph): SOC >= 1.4% to depth >= 100 cmqual_profundihumic
Protic qualifier (pr): Arenosol (or Regosol) with NO incipient subsurface horizon - i.e. an A-over-C profile where no cambic, no argic, no spodic, no ferralic, no nitic horizon is present in the upper 100 cm. v0.9.1 implements as the conjunction of the "no B horizon" diagnostics.qual_protic
Protoandic supplementary qualifier (pan): early-stage andic WRB 2022 Ch 5: "Andic-like properties below the strict threshold (oxalate Al+Fe 0.4-2.0%)."qual_protoandic
Protoargic supplementary qualifier (pra): early-stage argic WRB 2022 Ch 5: "Clay increase 2-6 percentage points (below the canonical argic threshold)."qual_protoargic
Protocalcic qualifier (qc): protocalcic properties (incipient carbonate accumulation) within the upper 100 cm. Wraps 'protocalcic_properties'.qual_protocalcic
Protogypsic qualifier (qg): protogypsic properties (incipient gypsum accumulation) within the upper 100 cm. Wraps 'protogypsic_properties'.qual_protogypsic
Protospodic supplementary qualifier (psp): early-stage spodic WRB 2022 Ch 5: "Spodic-like horizon meeting weakened criteria (Al+Fe oxalate < 0.5% but pyrophosphate > 0.05%)." Lacking pyrophosphate field; we proxy via spodic candidate horizons that fail strict spodic.qual_protospodic
Protovertic qualifier (qv): protovertic horizon (vertic-spectrum lower bound, no slickensides yet but the clay + structure / shrink-swell signal is already present) within the upper 100 cm. Wraps 'protovertic' and is mutually exclusive with the strict Vertic qualifier.qual_protovertic
Puffic supplementary qualifier (pf): puffed surfacequal_puffic
Pyric supplementary qualifier (py): fire-affected horizon WRB 2022 Ch 5: "Containing layers with charcoal / soot / fire-baked material (visual or chemical evidence)." Implementation: 'layer_origin' or designation matching fire-related text.qual_pyric
Raptic supplementary qualifier (rp): stratification breakqual_raptic
Reductaquic qualifier (ra): aquic + reductive at depthqual_reductaquic
Reductic qualifier (rd): permanently reducing conditions caused by anthropogenic gas / liquid emissions (typical of Technosols on landfills). v0.9.1: reducing_conditions + Technic context.qual_reductic
Reductigleyic qualifier (rg): gleyic + reductivequal_reductigleyic
Relocatic qualifier (rl): relocated material (Arenosols / Regosols)qual_relocatic
Rendzic qualifier (rz): mollic horizon directly over calcaric material (or limestone), shallow. Defined as Mollic + (Calcaric OR continuous rock with carbonate parent material).qual_rendzic
Retic qualifier (rt): retic properties <= 100 cm.qual_retic
Rheic qualifier (rh): water-fed Histosol.qual_rheic
Rhodic qualifier (ro): hue redder than 5YR + value < 4 + dry no more than 1 unit higher than moist (in upper subsoil 25-150 cm).qual_rhodic
Rockic qualifier (rk): rock-dominated organic horizonqual_rockic
Rubic qualifier (rb): red Munsell hue <= 5YR AND chroma >= 4 in some layer within the upper 100 cm. Less strict than Rhodic (which requires <= 2.5YR + value < 4); useful as a supplementary tag for tropical soils with reddish colours that don't reach the Rhodic threshold.qual_rubic
Rustic qualifier (rs): iron-dominated spodic illuviation. v0.9.1: spodic + OC < 1% AND active iron (Fe_ox) >= 0.5% in the same spodic layer (humus-poor, Fe-rich ortstein / Bs).qual_rustic
Salic qualifier (sz): salic horizon <= 100 cm.qual_salic
Sapric qualifier (sa): organic material whose dominant decomposition class in the upper 100 cm is sapric (rubbed fiber < 1/6). v0.9.1: thickness-weighted dominance via Oa designation.qual_sapric
Saprolithic supplementary qualifier (sp): saprolite parent materialqual_saprolithic
Silandic qualifier (sn): andic properties + Si-dominant active component (Al / (Al + 0.5 Si) < 0.5 in mass; allophane-rich).qual_silandic
Siltic qualifier (sl): silt or silt-loam texture >= 30 cm in the upper 100 cm.qual_siltic
Skeletic qualifier (sk): coarse fragments >= 40% averaged over 100 cm.qual_skeletic
Sodic qualifier (so): ESP >= 6% (incl. SAR-derived).qual_sodic
Solimovic qualifier (sv): solimovic material (mass-movement deposits).qual_solimovic
Sombric qualifier (sm): sombric horizon (humus-illuviated layer at depth) within 200 cm. WRB excludes layers that simultaneously meet spodic or ferralic criteria from being Sombric - those have specific qualifiers of their own. v0.9.1 enforces both exclusions.qual_sombric
Someric qualifier (sm): anthric epipedon over chernic / mollicqual_someric
Spodic qualifier (sd): spodic horizon <= 200 cm.qual_spodic
Spolic qualifier (sp): >= 20% mineral spoil artefacts (mining / industrial-process slag) in the upper 100 cm. v0.9.1 proxy: designation pattern ('Cspol|spoil|slag|mine') or 'rock_origin == "spoil"'. Hard schema column 'artefacts_spolic_pct' scheduled for v0.9.2.qual_spolic
Stagnic qualifier (st): stagnic properties <= 75 cm.qual_stagnic
Subaquatic qualifier (sq): permanently under water. v0.9.1: site$drainage_class == "subaquatic" or "submerged".qual_subaquatic
Sulfatic supplementary qualifier (su): high sulfate content WRB 2022 Ch 5: "Containing >= 25% gypsum or >= 5% sulfate by mass."qual_sulfatic
Sulfidic qualifier (sf): hyper- OR hyposulfidic material in upper 100 cm (the WRB Sulfidic qualifier covers either acidification class).qual_sulfidic
Takyric qualifier (ty): takyric properties in upper 50 cm.qual_takyric
Technic qualifier (tc): >= 20% artefacts in upper 100 cm OR equivalent geomembrane / technic-hard cover.qual_technic
Tephric qualifier (tf): tephric material >= 30 cm in upper 100 cm.qual_tephric
Terric qualifier (te): terric horizon (anthropogenic added mineral material on top of cultivated land).qual_terric
Thionic qualifier (tn): thionic horizon within 100 cm.qual_thionic
Thixotropic supplementary qualifier (tx): thixotropic behaviorqual_thixotropic
Thyric qualifier (ty): organic technic material in upper 100 cmqual_thyric
Tidalic qualifier (td): subject to tidal flooding. v0.9.1: site$drainage_class contains "tidal".qual_tidalic
Tonguic qualifier (tg): tongues of A horizon penetrating into Bqual_tonguic
Toxic qualifier (tx): toxic concentration of organic or inorganic constituents.qual_toxic
Transportic qualifier (tr): transported material (Technosols / Regosols)qual_transportic
Turbic qualifier (tb): cryoturbation features within 100 cm. v0.9.1 proxy: cryic conditions + designation pattern ('turb|jj|cryot') OR slickensides "common"/"many" in a cryic profile.qual_turbic
Umbric qualifier (um): umbric horizon.qual_umbric
Urbic qualifier (ub): >= 20% urbic artefacts (rubble, refuse) in the upper 100 cm.qual_urbic
Uterquic supplementary qualifier (uq): bidirectional water regimequal_uterquic
Vermic qualifier (vm): >= 50% bioturbation by worm casts / krotovinas in the upper 100 cm. v0.9.1: 'worm_holes_pct >= 50'.qual_vermic
Vertic qualifier (vr): vertic horizon <= 100 cm.qual_vertic
Vetic qualifier (vt): CEC (1 N NH4OAc, pH 7) by clay does not exceed 6 cmol+/kg clay in some layer at <= 100 cm. Stronger than the ferralic-CEC threshold (<= 16 cmol+/kg clay).qual_vetic
Vitric qualifier (vi): vitric properties >= 30 cm within 100 cm.qual_vitric
Wapnic qualifier (wp): soft, moist limnic material >= 80% CaCO3qual_wapnic
Xanthic qualifier (xa): ferralic + hue 7.5YR or yellower + value >= 4 + chroma >= 5.qual_xanthic
Yermic qualifier (ye): yermic properties in upper 50 cm.qual_yermic
Quartzipsamment helper (Quartzipsamments: >= 95% resistant minerals)quartzipsamment_qualifying_usda
Load FEBR datasets as a list of PedonRecord objectsread_febr_pedons
Reducing conditions (WRB 2022 Ch 3.2.10) - per-pedon test wrapping 'test_reducing_conditions'.reducing_conditions
Rendolls qualifier: shallow soil over carbonate parent material. Pass when CaCO3 >= 40% in subsurface AND profile depth < 100 cm to a contact.rendoll_qualifying_usda
Render a soilKey classification reportreport
Render a soilKey classification report as self-contained HTMLreport_html
Render a soilKey classification report as PDFreport_pdf
Export a classification result + pedon to a QGIS GeoPackagereport_to_qgis
Resolve WRB 2022 qualifiers for a Reference Soil Groupresolve_wrb_qualifiers
Retic properties (WRB 2022)retic_properties
Rhodic Subgroup helper (Oxisols, Mollisols, etc.) Pass when 50%+ colors have hue <= 2.5YR AND value <= 3 in B horizons 25-125 cm.rhodic_subgroup_usda
Launch the soilKey interactive classification Shiny apprun_classify_app
Launch the soilKey Shiny demo (one-screen GUI)run_demo
Resolve o grande grupo (3o nivel) de um pedon classificado em uma subordem SiBCSrun_sibcs_grande_grupo
Roda a chave SiBCS 5a edicao sobre um pedonrun_sibcs_key
Resolve o subgrupo (4o nivel) de um pedon classificado em um Grande Grupo SiBCSrun_sibcs_subgrupo
Resolve a subordem de um pedon ja classificado em uma ordem SiBCSrun_sibcs_subordem
Iterate a flat taxa list and evaluate tests in canonical orderrun_taxa_list
Run a taxonomic key (system-agnostic engine)run_taxonomic_key
Run the USDA Great Group key for a given Suborderrun_usda_great_group
Run the USDA Soil Taxonomy Order key over a pedonrun_usda_key
Run the USDA Subgroup key for a given Great Grouprun_usda_subgroup
Run the USDA Suborder key for a given Orderrun_usda_suborder
Run the WRB 2022 key over a pedonrun_wrb_key
Ruptic-Histic Subgroup helperruptic_histic_subgroup_usda
Ruptic Subgroup helper (Histoturbels / Historthels)ruptic_subgroup_usda
Salic horizon (WRB 2022)salic
Salic horizon (USDA, delegates to WRB salic).salic_horizon_usda
Salic Subgroup helper Wraps salic_horizon_usda. Used for Salaquerts/Salitorrerts/etc.salic_subgroup_usda
Sapric_predominant_usda: Saprists Suborder qualifier Pass when thickness of sapric > thickness of fibric+hemic in 0-130 cm.sapric_predominant_usda
Sapric Subgroup helper (Sphagnofibrists)sapric_subgroup_usda
Material organico saprico (SiBCS Cap 14)saprico
Save / load trained OSSL-backed PLSR modelsload_ossl_models save_ossl_models
Shrink-swell cracks (WRB 2022 Ch 3.2.12) - per-pedon test wrapping 'test_shrink_swell_cracks'.shrink_swell_cracks
Sideralic properties (WRB 2022 Ch 3.2.13)sideralic_properties
Aridic soil moisture regime (USDA)smr_aridic_usda
Torric soil moisture regime (USDA)smr_torric_usda
Udic soil moisture regime (USDA)smr_udic_usda
Ustic soil moisture regime (USDA)smr_ustic_usda
Xeric soil moisture regime (USDA)smr_xeric_usda
Sodic Subgroup helper - delegate to natric_horizon (USDA)sodic_subgroup_usda
Likely soil classes at a geographic location (spatial classification aid)soil_classes_at_location
Soil moisture regime helper (USDA, KST 13ed Ch 3, pp 50-52)soil_moisture_regime_usda
Soil organic carbon (WRB 2022 Ch 3.3.16): organic C that does NOT belong to artefacts. v0.3.3: any layer with oc_pct >= 0.1 and artefacts_industrial_pct < 35.soil_organic_carbon
Soil temperature regime helper (USDA, KST 13ed Ch 3, pp 53-58)soil_temperature_regime_usda
SoilGrids -> USDA Soil Order lookup table (placeholder)soilgrids_usda_lut
SoilGrids -> WRB code lookup tablesoilgrids_wrb_lut
Solimovic material (WRB 2022 Ch 3.3.17): hetero genous mass-movement material on slopes / footslopes (formerly "colluvic"). v0.3.3: detects via 'rock_origin == "colluvial"' OR 'layer_origin == "solimovic"'.solimovic_material
Sombric horizon (WRB 2022): subsurface accumulation of humus that qualified neither as spodic nor as a true mollic-like horizon (low-base-saturation cool tropical highlands). v0.3.3 detects via designation pattern + OC criteria (BS < 50, OC > 0.6, depth > 25 cm).sombric
Sombric Subgroup helper (Oxisols Sombri-) Pass when sombric horizon (humus illuviation in tropics) is present. v0.8: detects via 'sombric' designation OR a B horizon with V<=4 + V<=4 + chroma<=2 + OC>1 in 50-150 cm.sombric_subgroup_usda
Spatial prior over RSGs (or Orders) at a pedon's locationspatial_prior
Embrapa national soil-class spatial prior (Brazil only)spatial_prior_embrapa
SoilGrids spatial priorspatial_prior_soilgrids
Sphagnic Subgroup helper (Histels Fibristels)sphagnic_usda
Spodic horizon (WRB 2022)spodic
Spodic-Andisols Subgroup helper Pass when albic horizon overlies a cambic OR spodic horizon, OR when a spodic horizon is present in 50%+ of the pedon.spodic_andisol_usda
Spodosols Order qualifier (USDA, KST 13ed)spodic_horizon_usda
Spodic Subgroup helper for Psammorthels/Psammoturbelsspodic_subgroup_usda
Spodosols (USDA Cap 14): spodic horizon (illuvial Al/Fe/OC).spodosol_usda
USDA Soil Taxonomy diagnostic features canonical tablest_features_canonical
Stagnic properties (WRB 2022)stagnic_properties
Cryic soil temperature regime (USDA)str_cryic_usda
Gelic soil temperature regime (USDA)str_gelic_usda
Subgrupo "espessos" de Planossolos (B planico profundo, > 100 cm)subgrupo_planossolo_espessos
Subgrupo "mesicos" de Planossolos (B planico topo em [50, 100] cm)subgrupo_planossolo_mesicos
Subgrupo "endico" de Plintossolos Concrecionarios (topo de horizonte concrecionario >= 40 cm)subgrupo_plintossolo_endico_concrecionario
Subgrupo "endico" de Plintossolos Litoplinticos (topo de horizonte litoplintico >= 40 cm)subgrupo_plintossolo_endico_litoplintico
Subgrupo "espessos" de Plintossolos (horizonte plintico topo > 100 cm)subgrupo_plintossolo_espessos
Sulfic Subgroup helper (Haplowassists) Pass when sulfidic materials within 100 cm.sulfic_subgroup_usda
Sulfidic materials helper (USDA, KST 13ed Ch 3, p 49)sulfidic_materials_usda
Sulfuric horizon helper (USDA, KST 13ed Ch 3)sulfuric_horizon_usda
Takyric properties (WRB 2022 Ch 3.2.15) - per-pedon test wrapping 'test_takyric_surface'.takyric_properties
Technic features (WRB 2022)technic_features
Technic hard material (WRB 2022 Ch 3.3.18): consolidated human-made material (asphalt, concrete, worked stones).technic_hard_material
Tephric material (WRB 2022 Ch 3.3.19): \>= 30% volcanic glass in 0.02-2 mm fraction AND no andic / vitric properties.tephric_material
Terric horizon (WRB 2022): topsoil thickened by long-term application of mineral material (sediment / sand additions). v0.3.3: thickness >= 20 cm + designation Au / Apc.terric
Terric Subgroup helper (Histels)terric_usda
Test for an abrupt textural change between adjacent horizonstest_abrupt_textural_change
Test that aluminium saturation is at or above a thresholdtest_al_saturation_above
Test that aluminium saturation is below a thresholdtest_al_saturation_below
Test the andic Al/Fe oxalate criterion: (al_ox + 0.5*fe_ox) >= 2.0%test_andic_alfe
Test that artefacts_pct >= threshold within the upper max_top_cmtest_artefacts_concentration
Test that base saturation is at or above a thresholdtest_bs_above
Test that base saturation is below a thresholdtest_bs_below
Test that bulk density is at or below a thresholdtest_bulk_density_below
Test for CaCO3 concentration above threshold (per layer)test_caco3_concentration
Test for any layer with caco3_pct above a (low) thresholdtest_carbonates_present
Test for CaSO4 (gypsum) concentration above threshold (per layer)test_caso4_concentration
Test CEC (1M NH4OAc, pH 7) per kg clay <= thresholdtest_cec_per_clay
Test that CEC per kg clay is at or above a thresholdtest_cec_per_clay_above
Test for chroma <= 2 (moist) within the upper part of the profiletest_chernic_color
Test that clay_pct is at or above a thresholdtest_clay_above
Test the argic / argillic clay-increase criteriontest_clay_increase_argic
Test for coarse texture throughout the upper part of the profiletest_coarse_texture_throughout
Test that a horizon designation matches a regex patterntest_designation_pattern
Test that duripan_pct >= threshold (Si-cemented nodules)test_duripan_concentration
Test for electrical conductivity above threshold (per layer)test_ec_concentration
Test effective CEC (sum of bases + Al) per kg clay <= thresholdtest_ecec_per_clay
Test exchangeable sodium percentage above thresholdtest_esp_above
Test for high free-iron content ('fe_dcb_pct' >= threshold)test_fe_dcb_above
Ferralic texture: sandy loam or finer (same predicate as argic)test_ferralic_texture
Ferralic minimum thickness >= 30 cm (WRB 2022)test_ferralic_thickness
Test for fluvic stratification: irregular OC pattern + texture variability across consecutive horizonstest_fluvic_stratification
Test for gleyic redoximorphic features within top 50 cmtest_gleyic_features
Test minimum horizon thicknesstest_minimum_thickness
Mollic base-saturation test (NH4OAc, pH 7, default >= 50%)test_mollic_base_saturation
Mollic Munsell color test (WRB 2022)test_mollic_color
Mollic organic-carbon test (WRB 2022, default >= 0.6%)test_mollic_organic_carbon
Mollic structure test (WRB 2022)test_mollic_structure
Mollic thickness test (default >= 20 cm in v0.1)test_mollic_thickness
Test that organic carbon is at or above a thresholdtest_oc_above
Test that ph_h2o is at or below a thresholdtest_ph_below
Test for plinthite concentration above threshold (per layer)test_plinthite_concentration
Test the salic horizon EC * thickness product (WRB 2022)test_salic_product
Test for slickensides at or above a presence leveltest_slickensides_present
Test the spodic Al/Fe oxalate criterion: (al_ox + 0.5*fe_ox) >= thresholdtest_spodic_aluminum_iron
Test for stagnic redox features (perched water signature)test_stagnic_pattern
Test sandy-loam-or-finer texture (used by argic, ferralic)test_texture_argic
Test that a candidate layer starts at or above a top_cm thresholdtest_top_at_or_above
NRCS texture-class shorthand from clay / silt / sand percenttexture_class_from_pct
Thaptic Subgroup helper (Andisols) Pass when, between 25 and 100 cm, a 10+ cm layer with OC > 3.0% and mollic colors exists, underlying lighter horizons.thaptic_subgroup_usda
Thapto-Humic Subgroup helperthapto_humic_usda
Thionic horizon (WRB 2022): post-oxidation acid sulfate horizon. Requires sulfidic_s_pct >= 0.01 AND pH(H2O) <= 4.thionic
Train pre-trained PLSR models from an OSSL librarytrain_pls_from_ossl
Tsitelic horizon (WRB 2022 Ch 3.1)tsitelic
Turbic Subgroup helper (Gelods) Pass when gelic materials are present within 200 cm. Implementation: cryoturbation + permafrost within 200 cm.turbic_subgroup_usda
Ultic Subgroup helper: argillic or kandic (any BS).ultic_subgroup_usda
Ultisol Order qualifier (USDA, KST 13ed, Ch 2) Pass when argillic OR kandic horizon present + BS < 35% in some part of the upper 200 cm.ultisol_qualifying_usda
Ultisols (USDA Cap 15): argillic/kandic horizon + base saturation < 35%.ultisol_usda
Umbric epipedon (USDA Soil Taxonomy, 13th edition)umbric_epipedon_usda
Umbric horizon (WRB 2022)umbric_horizon
Umbric Subgroup helper (in Spodosols) Pass when umbric_epipedon_usda passes.umbric_subgroup_usda
USDA Soil Taxonomy <-> WRB Reference Soil Group correlation tableusda_to_wrb_rsg
Validate a PedonRecord against the JSON schemavalidate_pedon_json
Vermic Subgroup helper (Vermudolls / Vermustolls) Pass when worm_holes_pct >= 50% in some horizon (KST 13ed worm burrow criterion).vermic_subgroup_usda
Vertic Aridisols helper - delegates to vertic_subgroup_usdavertic_aridisol_usda
Vertic horizon (WRB 2022 Ch 3.1)vertic_horizon
Vertic properties (WRB 2022)vertic_properties
Vertic Subgroup helper (USDA, KST 13ed)vertic_subgroup_usda
Vertisol RSG gate (WRB 2022 Ch 4, p 101)vertisol
Vertisol Order qualifier (USDA, KST 13ed, Ch 2 / Ch 3 vertic horizon) Pass when a vertic horizon (clay >= 30, cracks, slickensides, LE) is present. Delegates to WRB 'vertic_horizon'.vertisol_qualifying_usda
Vertisols (USDA Cap 16): slickensides + cracks. Delegates to vertic_horizon.vertisol_usda
Vertissolos (SiBCS Cap 4, p 112; conceito Cap 3, p 105-106)vertissolo
Vertissolos Ebanicos (Cap 17): caracter ebanico em B (cores escuras dominantes).vertissolo_ebanico
Vertissolos Haplicos (catch-all).vertissolo_haplico
Vertissolos Hidromorficos (Cap 17): horizonte glei OR caracter redoxico.vertissolo_hidromorfico
Vitrands qualifier (Cap 6, pp 117-118) Pass when 1500 kPa water retention < 15% (air-dried) and < 30% (undried) throughout 60%+ of the thickness. v0.8 proxy: uses water_content_1500kpa < 15%.vitrand_qualifying_usda
Vitrandic Subgroup helper (USDA, KST 13ed)vitrandic_subgroup_usda
Vitric properties (WRB 2022 Ch 3.2.16)vitric_properties
Vitric Subgroup helper (Andisols) Pass when volcanic_glass_pct >= 30 in a 25+ cm layer within 100 cm.vitric_subgroup_usda
Pick the best available VLM providervlm_pick_provider
Construct a VLM provider chat objectvlm_provider
Wassent Suborder qualifier (subaqueous Entisol). Pass when site$water_table_cm_above_surface > 0 (water column permanently above the surface).wassent_qualifying_usda
Wassists Suborder qualifier (KST 13ed, Ch 10, p 203)wassist_qualifying_usda
WRB 2006 RSG code -> 2022 RSG namewrb06_code_to_rsg
WRB 2022 canonical reference (parsed IUSS Working Group WRB 2022)wrb2022_canonical
Xanthic Subgroup helper (Oxisols) Pass when 50%+ colors have hue >= 7.5YR AND value >= 6 in B horizons.xanthic_subgroup_usda
Yermic properties (WRB 2022 Ch 3.2.17) - per-pedon test wrapping 'test_yermic_surface'.yermic_properties