SoilTaxonomy
A System of Soil Classification for Making and Interpreting Soil Surveys
Install / Use
/learn @ncss-tech/SoilTaxonomyREADME
{SoilTaxonomy}
Taxonomic dictionaries, formative element lists, and functions related to the maintenance, development and application of U.S. Soil Taxonomy.
-
Data and functionality are based on official U.S. Department of Agriculture sources including the latest edition of the Keys to Soil Taxonomy. Descriptions and metadata are obtained from the National Soil Information System or Soil Survey Geographic databases. Other sources are referenced in the data documentation.
-
Provides tools for understanding and interacting with concepts in the U.S. Soil Taxonomic System. Most of the current utilities are for working with taxonomic concepts at the “higher” taxonomic levels: Order, Suborder, Great Group, and Subgroup.
Installation
Get the stable version from CRAN.
install.packages("SoilTaxonomy")
Get the development version from GitHub.
remotes::install_github("ncss-tech/SoilTaxonomy")
library(SoilTaxonomy)
Soil Taxonomy Dictionaries
# hierarchy: order to subgroup
data('ST', package = 'SoilTaxonomy')
# unique taxa: just the taxon names (in order that they "key out" in the keys)
data('ST_unique_list', package = 'SoilTaxonomy')
# formative element dictionary
data('ST_formative_elements', package = 'SoilTaxonomy')
# codes denoting higher taxonomic parent-child relationships (12th Edition Keys to Soil Taxonomy)
data('ST_higher_taxa_codes_12th', package = 'SoilTaxonomy')
# definitions of diagnostic features and characteristics (12th Edition Keys to Soil Taxonomy)
data('ST_features', package = 'SoilTaxonomy')
# definitions of family-level classes and differentiae (12th Edition Keys to Soil Taxonomy)
data('ST_family_classes', package = 'SoilTaxonomy')
Vignettes
Several vignettes are included with the package to demonstrate basic functionality:
Featured Functions
Two helpful functions that make use of the internal lookup tables are
getTaxonAtLevel(), taxonTree(), and explainST()
getTaxonAtLevel(): Get taxonomic levels within higher taxonomic groups
HHCH = Acrudoxic Plinthic Kandiudults
getTaxonAtLevel('acrudoxic plinthic kandiudults') # level = "order" # default
#> acrudoxic plinthic kandiudults
#> "ultisols"
getTaxonAtLevel('acrudoxic plinthic kandiudults', level = "suborder")
#> acrudoxic plinthic kandiudults
#> "udults"
getTaxonAtLevel('acrudoxic plinthic kandiudults', level = "greatgroup")
#> acrudoxic plinthic kandiudults
#> "kandiudults"
getTaxonAtLevel('acrudoxic plinthic kandiudults', level = "subgroup")
#> acrudoxic plinthic kandiudults
#> "acrudoxic plinthic kandiudults"
BA = Folists
getTaxonAtLevel('folists')
#> folists
#> "histosols"
getTaxonAtLevel('folists', level = "suborder")
#> folists
#> "folists"
getTaxonAtLevel('folists', level = "greatgroup")
#> folists
#> NA
getTaxonAtLevel('folists', level = "subgroup")
#> folists
#> NA
taxonTree(): Create data.tree representation of Soil Taxonomy Hierarchy
# all hapludults and hapludalfs (to subgroup level)
taxonTree(c("hapludults", "hapludalfs"))
#> Loading required namespace: data.tree
#> Soil Taxonomy
#> |-ultisols
#> | |-udults
#> | |-hapludults
#> | |-lithic-ruptic-entic hapludults
#> | |-lithic hapludults
#> | |-vertic hapludults
#> | |-fragiaquic hapludults
#> | |-aquic arenic hapludults
#> | |-aquic hapludults
#> | |-fragic hapludults
#> | |-oxyaquic hapludults
#> | |-lamellic hapludults
#> | |-psammentic hapludults
#> | |-arenic hapludults
#> | |-grossarenic hapludults
#> | |-inceptic hapludults
#> | |-humic hapludults
#> | |-typic hapludults
#> |-alfisols
#> |-udalfs
#> |-hapludalfs
#> |-lithic hapludalfs
#> |-aquertic chromic hapludalfs
#> |-aquertic hapludalfs
#> |-oxyaquic vertic hapludalfs
#> |-chromic vertic hapludalfs
#> |-vertic hapludalfs
#> |-andic hapludalfs
#> |-vitrandic hapludalfs
#> |-fragiaquic hapludalfs
#> |-fragic oxyaquic hapludalfs
#> |-aquic arenic hapludalfs
#> |-arenic oxyaquic hapludalfs
#> |-anthraquic hapludalfs
#> |-albaquultic hapludalfs
#> |-albaquic hapludalfs
#> |-glossaquic hapludalfs
#> |-aquultic hapludalfs
#> |-aquollic hapludalfs
#> |-aquic hapludalfs
#> |-mollic oxyaquic hapludalfs
#> |-oxyaquic hapludalfs
#> |-fragic hapludalfs
#> |-lamellic hapludalfs
#> |-psammentic hapludalfs
#> |-arenic hapludalfs
#> |-glossic hapludalfs
#> |-inceptic hapludalfs
#> |-ultic hapludalfs
#> |-mollic hapludalfs
#> |-typic hapludalfs
# suborders and great groups of alfisols
taxonTree("alfisols", root = "Alfisols", level = c("suborder", "greatgroup"))
#> Alfisols
#> |-aqualfs
#> | |-cryaqualfs
#> | |-plinthaqualfs
#> | |-duraqualfs
#> | |-natraqualfs
#> | |-fragiaqualfs
#> | |-kandiaqualfs
#> | |-vermaqualfs
#> | |-albaqualfs
#> | |-glossaqualfs
#> | |-epiaqualfs
#> | |-endoaqualfs
#> |-cryalfs
#> | |-palecryalfs
#> | |-glossocryalfs
#> | |-haplocryalfs
#> |-ustalfs
#> | |-durustalfs
#> | |-plinthustalfs
#> | |-natrustalfs
#> | |-kandiustalfs
#> | |-kanhaplustalfs
#> | |-paleustalfs
#> | |-rhodustalfs
#> | |-haplustalfs
#> |-xeralfs
#> | |-durixeralfs
#> | |-natrixeralfs
#> | |-fragixeralfs
#> | |-plinthoxeralfs
#> | |-rhodoxeralfs
#> | |-palexeralfs
#> | |-haploxeralfs
#> |-udalfs
#> |-natrudalfs
#> |-ferrudalfs
#> |-fraglossudalfs
#> |-fragiudalfs
#> |-kandiudalfs
#> |-kanhapludalfs
#> |-paleudalfs
#> |-rhodudalfs
#> |-glossudalfs
#> |-hapludalfs
explainST(): Label formative elements with brief explanations
explainST() provides simple narrative explanations of the formative
elements of taxa at the Order, Suborder, Great Group or Subgroup levels.
cat(explainST('folistels'))
#> folistels
#> | | |
#> mass of leaves
#> | |
#> presence of organic soil materials
#> |
#> soils with permafrost or gelic material within 100cm
cat(explainST('typic endoaqualfs'))
#> typic endoaqualfs
#> | | | |
#> central theme of subgroup concept
#> | | |
#> ground water table
#> | |
#> characteristics associated with wetness
#> |
#> soils with an argillic, kandic, or natric horizon
cat(explainST('abruptic haplic durixeralfs'))
#> abruptic haplic
Related Skills
node-connect
335.2kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
82.5kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
335.2kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
82.5kCommit, push, and open a PR
