sharpshootR 1.12

This release marks a number of important additions, bug fixes, and internal changes to the sharpshootR package. Notably, sharpshootR functions have and will continue to migrate away from sp/raster and to sf/terra packages.

A new strategy for alignment of profile sketches and expected hydrologic gradients is implemented as "Iterative hydrologic ordering". This strategy is demonstrated in the draft vignette Hydrologic Ordering of Geomorphic Proportions.

New Functions

• new function plotGeomorphCrossSection() presents a SoilProfileCollection aligned to a geomorphic summary as cross-section (@dylanbeaudette)
• new function reconcileOSDGeomorp() convenience function for reconciling SPC and geomorphic summary tables as returned by soilDB::fetchOSD() (@dylanbeaudette)

New Features

• hydrologic ordering functions now exported: hydOrder() and iterateHydOrder() (@dylanbeaudette)
• SoilTaxonomyDendrogram() gains argument KST.order to adjust encoding / ordering criteria and level argument to specify the taxonomic levels to use (@dylanbeaudette, @brownag)
• SoilTaxonomyDendrogram() gains argument cluster.method to select "divisive" (default) or "agglomerative" clustering methods. Additional arguments to cluster::diana() and cluster::agnes() may be specified with a list supplied as cluster.args argument (@brownag)
• aspect.plot() now returns the Rayleigh Uniformity statistic and corresponding p-value as an attribute named "uniformity" (@brownag)
• plotWB() aesthetic fixes and additional arguments, including manual specification of y-axis limits (@dylanbeaudette)
• aggregateColorPlot() gets a new argument for setting label orientation (@dylanbeaudette)
• geomorphic viz* functions now use an iterative approach to re-arrange dendrogram according to "hydologic ordering" (@dylanbeaudette)
• plotProfileDendrogram() gains argument for re-ordering dendrogram as close to original profile IDs as possible (@dylanbeaudette)
• plotWB_lines() gets legend.cex and aesthetic adjustments to legend position (@dylanbeaudette)

Bug Fixes

• bug fix in monthlyWB_summary() to address warning / Inf when 0 dry days
• bugfix in plotWB() related to figure y-scale range

Package Internals

• adding SoilTaxonomy package to suggests, to allow for better encoding of taxa levels by SoilTaxonomyDendrogram() (@brownag)
• Spatial/raster sampling functions sampleRasterStackByMU(), samplingStability(), sample.by.poly() and MoranI_By_Raster() now use terra internally (@brownag)
• dueling.dendrograms() has been deprecated, please use dendextend::tanglegram() for similar tasks