- Added
WRB_4th_2022
data set containing World Reference Base for Soil Resources (4th Edition, 2022) reference soil groups with primary and supplementary qualifiers.
- Data set
ST_unique_list$subgroup
: fix for 12th edition "Hydric Frasiwassents" v.s. 13th edition "Humic Fluic Frasiwassents" explainST()
expanded acronyms in explanations
taxonTree()
default markup viaspecial.chars
argument emulatesfs::dir_tree()
outputparse_family()
now returns more complete information for taxa above familytaxminalogy
column for taxa with strongly contrasting control sections now use" over "
as the separator between class names.
- Fix unintended case-sensitivity of
FormativeElements()
; thanks to Shawn Salley (@swsalley) - Fix for
extractSMR()
via fix forFormativeElements()
applied at multiple levels (affects taxa above subgroup level) - Add
level_hierarchy()
a helper function for creating ordered factors related to the levels: "order", "suborder", "greatgroup", "subgroup", "family". - Taxon code lookup tables are now cached in the package environment (
SoilTaxonomy.env
) after the first time they are used for a moderate boost in performance in scenarios callingtaxon_code_to_taxon()
ortaxon_to_taxon_code()
many times getTaxonAtLevel()
now supports multiplelevel
values. In this case, a data.frame with column for eachlevel
is returned. Thanks to Meyer Bohn (@MollicMeyer) in #42 for suggestion.- Added
taxonTree()
a method for creatingdata.tree
objects (added to Suggests). This function returns a custom SoilTaxonomy-specific subclass of data.tree
Node
calledSoilTaxonNode
.- This new class has a custom print method, and in the future there may be more dedicated functions for viewing and traversing the taxonomic hierarchy.
- Added
ST_higher_taxa_codes_13th
the 13th edition analog ofST_higher_taxa_codes_12th
, which is the Keys to Soil Taxonomy taxon list and corresponding letter codes. This lookup table is used internally for many things related to the hierarchy of taxonomy. It has not been integrated into other datasets (pending next NASIS data model update in several months). Incorporating the edition of taxonomy will be a significant change when implemented (and may contain breaking changes to code-lookup tools).
- The order of dataset
ST
is now based on the full subgroup level code (#35). Partial codes corresponding to each level of the hierarchy are also included in columns:order_code
,suborder_code
,greatgroup_code
andsubgroup_code
. - New function
SoilTaxonomyLevels()
: used for creating ordinal and nominal factors corresponding to taxonomic levels"order"
,"suborder"
,"greatgroup"
, and"subgroup"
(#39). - New function
SoilMoistureRegimeLevels()
andSoilTemperatureRegimeLevels()
: used for creating ordinal and nominal factors corresponding to Soil Moisture and Temperature Regimes (#34). FormativeElements()
can now take multiplelevel
values, returning the formative elements found at each level combined in a single data.frame.- New function
get_ST_formative_elements()
a helper function for getting a data.frame containing descriptors of formative elements used at the specifiedlevel
(s) - New function
extractSMR()
: utilizes order to subgroup formative elements to identify Soil Moisture Regimes from taxon names
- New function
newick_string()
: used for creating parenthetical "Newick" (or "New Hampshire") format tree string inputs to functions such asape::read.tree()
- New vignette related to soil diagnostic features and characteristics
get_ST_features()
- New function
get_ST_family_classes()
(theST_family_classes
analogue ofST_features
/get_ST_features()
) ST_family_classes
gains information on the"aniso"
particle-size class modifierparse_family()
now returns additional columns reflecting NASIS physical column names corresponding to components of the family-level taxonomy- This routine uses the NASIS metadata that ares cached in the {soilDB} package, which has been added to Suggests
parse_family()
gainsflat
argument (defaultTRUE
) to toggle returning list columns for "child" table taxonomic family data such as mineralogy class and "other" taxonomic family class.
taxon_code_to_taxon
andtaxon_to_level
now support family-level taxa with only one class e.g. "Thermic Typic Quartzipsamments"- included data
ST_unique_list
is now sorted according to the order of appearance in the Keys to Soil Taxonomy (12th edition)
- Update
ST_formative_elements
/explainST()
with subgroup-level descriptions for missing taxa
- Add
code_to_level
to abstract core fromtaxon_to_level
for higher taxa with letter codes - Add
getChildTaxa
counterpart togetParentTaxa
;getParentTaxa
can now be filtered withlevel
argument - Fixes for
stringsAsFactors
defaulting toTRUE
on R <4.0
- Extend
explainST
to work on Order, Suborder and Great Group taxonomic names - Add methods
level_to_taxon
andtaxon_to_level
to determine where taxa occur in the hierarchy - New data sets:
ST_features
,ST_family_classes
for diagnostic horizons/features/properties and family-level class names and related content- Derived from 12th Edition Keys to Soil Taxonomy definitions and criteria until official release of 13th Edition
- Data sourced from https://github.com/ncss-tech/SoilKnowledgeBase/
create_KST
module JSON output
- Add
parse_family
method for separating family-level classes from higher taxonomic names - Add
get_ST_features
wrapper method for filteringST_features
data set - Add
getLastChildTaxon
method to determine last in Keys at specifiedlevel
(Order, Suborder, or Great Group)
- Re-factored
taxon_code_to_taxon
&taxon_to_taxon_code
to use LEFT JOIN - Added a
NEWS.md
file to track changes to the package
- Initial CRAN release