{"id":20074872,"url":"https://github.com/ncss-tech/soiltaxonomy","last_synced_at":"2026-03-04T18:32:05.272Z","repository":{"id":44157476,"uuid":"51407614","full_name":"ncss-tech/SoilTaxonomy","owner":"ncss-tech","description":"A System of Soil Classification for Making and Interpreting Soil Surveys","archived":false,"fork":false,"pushed_at":"2024-10-01T22:27:33.000Z","size":53118,"stargazers_count":15,"open_issues_count":9,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-28T16:18:37.917Z","etag":null,"topics":["great-group","ncss-tech","soil","soil-survey","soil-taxonomy","subgroup","suborder","usda"],"latest_commit_sha":null,"homepage":"https://ncss-tech.github.io/SoilTaxonomy/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ncss-tech.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-02-09T23:10:37.000Z","updated_at":"2025-02-10T17:31:09.000Z","dependencies_parsed_at":"2023-09-24T05:24:23.657Z","dependency_job_id":"745aaf8f-1645-437d-bb2f-bf0039867cfe","html_url":"https://github.com/ncss-tech/SoilTaxonomy","commit_stats":{"total_commits":334,"total_committers":3,"mean_commits":"111.33333333333333","dds":"0.40718562874251496","last_synced_commit":"6c095c4016db4eb03728ee70a76ab41efa839381"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ncss-tech%2FSoilTaxonomy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ncss-tech%2FSoilTaxonomy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ncss-tech%2FSoilTaxonomy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ncss-tech%2FSoilTaxonomy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ncss-tech","download_url":"https://codeload.github.com/ncss-tech/SoilTaxonomy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241506701,"owners_count":19973665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["great-group","ncss-tech","soil","soil-survey","soil-taxonomy","subgroup","suborder","usda"],"created_at":"2024-11-13T14:55:22.813Z","updated_at":"2026-03-04T18:32:05.224Z","avatar_url":"https://github.com/ncss-tech.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/ncss-tech/SoilTaxonomy/workflows/R-CMD-check/badge.svg)](https://github.com/ncss-tech/SoilTaxonomy/actions/workflows/R-CMD-check.yml)\n[![Codecov test coverage](https://codecov.io/gh/ncss-tech/SoilTaxonomy/branch/master/graph/badge.svg)](https://app.codecov.io/gh/ncss-tech/SoilTaxonomy?branch=master)\n[![CRAN Status](https://www.r-pkg.org/badges/version-last-release/SoilTaxonomy)](https://cran.r-project.org/package=SoilTaxonomy)\n[![runiverse-SoilTaxonomy](https://ncss-tech.r-universe.dev/badges/SoilTaxonomy)](https://github.com/ncss-tech/SoilTaxonomy)\n[![SoilTaxonomy Manual](https://img.shields.io/badge/docs-HTML-informational)](https://ncss-tech.github.io/SoilTaxonomy/)\n\u003c!-- badges: end --\u003e\n\n# {SoilTaxonomy}\n\nTaxonomic dictionaries, formative element lists, and functions related to the maintenance, development and application of U.S. Soil Taxonomy. \n\n  - 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. \n   \n  - 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**. \n\n## Installation\n\nGet the stable version from CRAN. \n\n```r\ninstall.packages(\"SoilTaxonomy\")\n```\n\nGet the development version from GitHub. \n\n```r\nremotes::install_github(\"ncss-tech/SoilTaxonomy\")\n```\n\n```{r}\nlibrary(SoilTaxonomy)\n```\n\n### Soil Taxonomy Dictionaries\n\n```{r}\n# hierarchy: order to subgroup\ndata('ST', package = 'SoilTaxonomy')\n\n# unique taxa: just the taxon names (in order that they \"key out\" in the keys)\ndata('ST_unique_list', package = 'SoilTaxonomy')\n\n# formative element dictionary\ndata('ST_formative_elements', package = 'SoilTaxonomy')\n\n# codes denoting higher taxonomic parent-child relationships (12th Edition Keys to Soil Taxonomy)\ndata('ST_higher_taxa_codes_12th', package = 'SoilTaxonomy')\n\n# definitions of diagnostic features and characteristics (12th Edition Keys to Soil Taxonomy)\ndata('ST_features', package = 'SoilTaxonomy')\n\n# definitions of family-level classes and differentiae (12th Edition Keys to Soil Taxonomy)\ndata('ST_family_classes', package = 'SoilTaxonomy')\n```\n\n### Vignettes\n\nSeveral vignettes are included with the package to demonstrate basic functionality:\n\n - [Taxon Letter Codes in Soil Taxonomy](https://ncss-tech.github.io/SoilTaxonomy/articles/taxon-letter-codes.html)\n\n \n - [Diagnostic Features \u0026 Characteristics](https://ncss-tech.github.io/SoilTaxonomy/articles/diagnostics.html)\n \n - [Family-level Taxonomic Classes](https://ncss-tech.github.io/SoilTaxonomy/articles/family-level_taxonomy.html)\n \n \n### Featured Functions\n\nTwo helpful functions that make use of the internal lookup tables are `getTaxonAtLevel()`, `taxonTree()`, and `explainST()`\n\n#### `getTaxonAtLevel()`: Get taxonomic levels within higher taxonomic groups\n\n##### HHCH = _Acrudoxic Plinthic Kandiudults_\n\n```{r}\ngetTaxonAtLevel('acrudoxic plinthic kandiudults') # level = \"order\" # default\n\ngetTaxonAtLevel('acrudoxic plinthic kandiudults', level = \"suborder\")\n\ngetTaxonAtLevel('acrudoxic plinthic kandiudults', level = \"greatgroup\")\n\ngetTaxonAtLevel('acrudoxic plinthic kandiudults', level = \"subgroup\")\n```\n\n##### BA = _Folists_\n\n```{r}\ngetTaxonAtLevel('folists')\n\ngetTaxonAtLevel('folists', level = \"suborder\")\n\ngetTaxonAtLevel('folists', level = \"greatgroup\")\n\ngetTaxonAtLevel('folists', level = \"subgroup\")\n```\n\n#### `taxonTree()`: Create `data.tree` representation of Soil Taxonomy Hierarchy\n\n```{r}\n# all hapludults and hapludalfs (to subgroup level)\ntaxonTree(c(\"hapludults\", \"hapludalfs\"))\n```\n\n```{r}\n# suborders and great groups of alfisols \ntaxonTree(\"alfisols\", root = \"Alfisols\", level = c(\"suborder\", \"greatgroup\"))\n```\n\n#### `explainST()`: Label formative elements with brief explanations\n\n`explainST()` provides simple narrative explanations of the formative elements of taxa at the Order, Suborder, Great Group or Subgroup levels.\n\n```{r}\ncat(explainST('folistels'))\n\ncat(explainST('typic endoaqualfs'))\n\ncat(explainST('abruptic haplic durixeralfs'))\n\n# convert \"taxon code\" to taxon name (subgroup)\ncat(explainST(taxon_code_to_taxon(\"ABCD\"))) # ABCD = gypsic anhyturbels\n\n# all soil orders (LETTERS[1:12]; taxon codes A through L)\nres \u003c- lapply(LETTERS[1:12], function(l) cat(explainST(taxon_code_to_taxon(l)), \"\\n\\n\"))\n```\n\n## Static Databases\n\nThe `./inst/extdata` folder (formerly `./databases`) of the GitHub repository formerly contained data tables related to taxonomic and map unit concepts within the U.S. Soil Survey Geographic Database (SSURGO).\n\nThese databases included: \n\n - Statistics on taxonomic subgroups, family-level components, and soil series. \n \n - MLRA Overlap tables for series, national map unit symbols and map unit keys. \n \n - Summaries of KSSL records per series as well as geomorphic position, parent material origin and kind.\n \nThese tables have been moved to a dedicated repository called [SoilWeb-data](https://github.com/ncss-tech/SoilWeb-data).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fncss-tech%2Fsoiltaxonomy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fncss-tech%2Fsoiltaxonomy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fncss-tech%2Fsoiltaxonomy/lists"}