• fetchNASIS("components'): Fix and refactor ( breaking change from 2.7.1, which introduced a bug/inconsistency) of recent change; duplicates argument is now required to merge in data from mapunit/legend tables (where many:1 relationships between legend/mapunit and datamapunit are possible). In 2.7.1 possibly incomplete mapunit/legend tables could be joined to SoilProfileCollection result (if and only if the tables were populated in selected set/local DB). Does not change historic (<=2.7.0) default behavior. Thanks to @dylanbeaudette for suggesting use of get_component_correlation_data_from_NASIS_db() here.

  • Several fixes for Roxygen documentation (notably for ROSETTA() and various NASIS web report related functions) that were missing @export tags. Several previously-exported functions missed being explicitly exported in the new Roxygen-generate NAMESPACE. These unintentional omissions from 2.7.1 NAMESPACE have been resolved.

  • get_SDA_coecoclass() better handling of NULL ecoclassref; support for filtering on ecoclasstypename; not_assigned_value now applies to ecoclassname, ecoclasstypename and ecoclassref columns in addition to ecoclassid; Thanks to Andy Paolucci and Jason Nemecek. Also, added additional columns from legend/mapunit tables (areasymbol, lkey, muname).
  • fetchNASIS(from="components") now returns mapunit and legend information (if loaded in local NASIS database); results now contain mustatus and repdmu which can be used to remove components from additional mapunits and non-representative data mapunits; thanks to Nathan Roe
  • Convert UTF-8 strings in us_ss_timeline result to ASCII
  • SDA_query(): Fixed POST request that could produce unhandled errors on network failure (now returns try-error like other error-causing code)
  • SDA_query(): In the event of a syntax error, error contents are now returned as a message, not a warning.
  • uncode() and code() now work with data.table and tibble objects.
  • Various fixes to tests and error handling code to reduce likelihood of thrown errors from network problems or missing suggested packages.
  • Spatial
    • Dropped imports from sp and raster which means soilDB no longer requires the soon-to-retire rgdal package.
    • All spatial data processing has been moved to sf and terra, which have been added to Suggests.
      • (breaking change) Classes from these packages (e.g. sf, SpatRaster) will be returned by default rather than Spatial*DataFrame or RasterLayer from sp and raster.
      • (breaking change) Spatial functions that take spatial input will return the same class type as the input unless otherwise specified.
        • fetchSDA_spatial() and SDA_spatialQuery() gain as_Spatial argument; when TRUE equivalent (backward compatible) sp and raster data types are returned.
        • Alternately, you may set options(soilDB.return_Spatial=TRUE)
    • mukey.wcs() and ISSR800.wcs() bug fix for some instances where the target extent was miscalculated, resulting in slight differences from requested resolution (res argument) of result.
    • mukey.wcs() gains a new possible data source db="RSS" which accesses a Web Coverage Service containing grids from Raster Soil Surveys in the United States.
    • See: https://github.com/ncss-tech/soilDB/pull/229 for more details on what has changed.
  • NASIS
    • (breaking change) rmHzErrors argument now defaults to FALSE. Please let us know if allowing horizon errors results in unexpected behavior so we can repair various interfaces that rely on no errors being present. See aqp::checkHzDepthLogic() for more information on the types of things that used to result in profiles being removed from results and for guidelines on how to fix.
    • Added several new columns from the plotplantinventory table to get_vegplot_species_from_NASIS_db() result; thanks to Zachary Van Abbema for suggestion and feedback
    • Local NASIS metadata used for uncode() are now cached within an R session which results in faster query processing times for users with a local NASIS database connection set up.
      • The db argument to uncode() has been deprecated. Now, code() and uncode() can use ChoiceName and/or ChoiceLabel in coding and decoding ChoiceValue for all data sources.
    • Rock fragment and artifact sieving now uses <76mm as the upper boundary for gravel fraction, and a related QC message has been removed
  • SSURGO / Soil Data Access
    • Added get_SDA_cosurfmorph(): a new function in “SSURGO On Demand” style. Users can customize the WHERE clause, target tables and the grouping variable used to calculate proportions (default by="compname")
      • “cosurfmorphgc” summarizes “geomposmntn”, “geomposhill”, “geomposflats”, “geompostrce”
      • “cosurfmorphhpp” summarizes “hillslopeprof”
      • “cosurfmorphss” summarizes “shapeacross”, “shapedown”, and concatenated “surfaceshape”
    • Several fixes for logic of get_SDA_property() with method="weighted average" and include_minors=TRUE/miscellaneous_areas=TRUE, thanks to Andy Paolucci and Dylan Beaudette for testing and providing feedback on the queries.
    • All get_SDA_*() methods (except get_SDA_metrics()) now support input of custom WHERE clause in lieu of mukeys/areasymbols arguments and gain a dsn argument for specifying a local SQLite database or DBIConnection.
    • Added downloadSSURGO() for downloading/extraction of the SSURGO data by survey area from Web Soil Survey.
    • Added createSSURGO() for building of local databases as SQLite/Geopackage from one or more SSURGO exports.
  • fetchNASIS()
    • New mixColors argument used to toggle color mixing for pedon horizons with multiple colors per moisture state.
      • Default TRUE mixes colors based on reported color percentage via estimateColorMixture(). FALSE returns the dominant color in each moisture state, or first record for cases without colorpct populated.
    • Added taxreaction and taxfamhahatmatcl to extended taxonomic information
    • Added new option (soilDB.NASIS.skip_uncode) to bypass uncode() in NASIS functions (mostly used for debugging or special database instances that come pre-decoded)
    • An instance in fetchNASIS(from="components") where local database connection was left open was fixed
  • Added fetchLDM() function to access Kellogg Soil Survey Lab Data Mart via Soil Data Access or local SQLite snapshot (https://github.com/ncss-tech/soilDB/pull/243)
  • Added get_SDA_metrics() for accessing usage metrics for Soil Data Access, Web Soil Survey and the Lab Data Mart. Thanks to Jason Nemecek for submitting the base SQL query
  • get_SDA_interpretation(method = "dominant condition") now includes total_comppct_* columns reflecting the summed component percentage of the dominant condition
  • Updated metadata for SCAN sites that were missing pedlabsampnum (KSSL Pedon Sample ID)
  • waterYearDay() bug fix for more specific (sub-daily) date-time formats
  • fetchSCAN() better handling of empty results in multi-site queries
  • Updates to queries, metadata and sample datasets for NASIS 7.4.1 Database Model
    • fetchNASIS("pedons") no longer includes pmweathering
    • fetchNASIS("components") no longer includes ecositeorigin
    • New Component Ecological Site attributes added
  • stringsAsFactors argument to soilDB functions has been deprecated in favor of a package option
    • Default behavior for NASIS domains is to return character labels rather than coded factors
    • Use NASISDomainsAsFactor(TRUE) to toggle package option soilDB.NASIS.DomainsAsFactor
  • fetchSDA_spatial now supports by.col "areaname", "mlraoffice", and "mouagencyresp"; thanks to suggestion by Jay Skovlin
  • fetchNASIS fix for multiple site observation records with surface fragments; thanks to bug report from Brianna Wegner
  • waterYearDay() use format and timezone for start date conversion
  • fetchNASIS fix for from="components", SS=FALSE and queries where no NASIS local database is present (e.g. from SQLite source)
  • Update to NASIS_table_column_keys dataset of NASIS primary and foreign keys by table name to include many more tables
  • fetchVegdata() no longer errors for child table queries unless site/site observation/vegetation plot records are missing
  • fetchOSD(extended=TRUE) now returns an element "NCCPI" containing the National Commodity Crop Production Index summaries. The values returned are quantiles at the 1, 5, 25, 50, 75, 95, and 99% levels over all SSURGO components with compname matching series for irrigated and non-irrigated condition.
  • get_SDA_property() now works with mixed component and horizon-level properties; thanks to Matthieu Stigler for the bug report
  • Added get_SDV_legend_elements() for fetching and parsing XML for Soil Data Viewer / Web Soil Survey-style symbol themes for soil interpretations from Soil Data Access
  • fetchNASIS() pedon and component geomorphic summaries now include columns for landscape, microfeature, microrelief, 2D/3D morphometry, and slope shape
  • fetchNASIS('pedons') now uses simplifyFragmentData() for surface fragments
  • fetchSDA() handle NULL component-level results with an informative error
  • fetchSDA() now (again) returns mapunit/legend-level information via get_mapunit_from_NASIS()
  • createStaticNASIS() and queries to SQLite NASIS snapshots now preserve date/time using RSQLite 2.2.4+ via extended_types=TRUE argument to dbConnect()
  • get_soilseries_from_NASIS() now returns soiltaxclasslastupdated as a date/time and stores the year in calculated column soiltaxclassyearlastupdated
  • Added several tables to thematic groups in get_NASIS_table_name_by_purpose()
  • fetchOSD() gains surface shape proportions in extended shape_across and shape_down tables
  • SDA_spatialQuery() what='mukey' now works with db='STATSGO'
  • Added metadata to loafercreek, gopheridge and mineralKing
  • waterYearDay() pass through format argument for POSIX time conversion
  • waterDayYear() and .formatDates() allow optional format and tz argument; used for consistent POSIX time conversion in tests where date/time has granularity finer than one day
  • fetchSDA() extensions for better handling of components with no horizon data
  • SDA_spatialQuery() and processSDA_WKT() fully use {sf}, replacing {sp} in these contexts
  • SDA_spatialQuery() gains argument byFeature to use multiple single-feature queries and combine the results with a unique feature ID specified by idcol argument. This allows for specific feature intersection results without secondary spatial overlay of the polygons (https://github.com/ncss-tech/soilDB/issues/222)
  • dbConnectNASIS() no longer requires that the NASIS credentials option be set if the dsn argument is specified.
  • Rebuilt loafercreek, gopheridge and mineralKing from latest fetchNASIS() results.
  • fetchNASIS() upgrades: use data.table and base internally for data aggregation
  • fetchNASIS("components") now “sieves” rock fragments and human artifacts using same routines as for pedons; respects nullFragsAreZero argument
  • fetchKSSL(..., returnGeochemicalData = TRUE) safely returns 0-length data.frame when no data available
  • API calls that return geometry in projected coordinates (AEA/NAD83) now use ESPG:5070 instead of EPSG:6350
  • fetchNASIS(from="pedons") now supports fill=TRUE argument just like from="components" to include pedons that have no horizon records
  • createStaticNASIS(): column order should match NASIS, even if data types require reorder for ODBC driver
  • fetchSoilGrids() bug fixes, updates to metadata and references in documentation (https://github.com/ncss-tech/soilDB/issues/201)
    • Corrected the conversion factor used for predicted nitrogen values (conversion from cg/kg to g/kg)
    • Corrected the conversion factor used for uncertainty in bdod and nitrogen (SoilGrids uncertainty layer always uses factor of 10 to create integers)
    • Improved error handling
    • Added progress and verbose arguments for text progress bar and additional message output
    • Added support for {sf} and {sp} POINT geometry inputs
  • Add get_SDA_coecoclass() SOD-style method for mapunit/component level summaries of ecological site and other vegetation class information
  • SDA_query() and all functions that call SDA_query() get proper column class handling (related to #190), however:
    • be careful with the use of CAST(): unknown datatypes may not be correctly interpreted
    • previous column classes that were incorrectly guessed by type.convert() may have changed (e.g. component.wei)
  • SDA_spatialQuery() can now be used to return soil survey area symbols or geometry using what="areasymbol" or what="sapolygon", respectively
  • Added new columns to soil classification (“SC”) table result of get_soilseries_from_NASIS(); now including taxonomic mineralogy class which may contain multiple parts for series with strongly contrasting control sections
  • Updates to get_SDA_*() methods
    • Extends get_SDA_property(property = ...) and get_SDA_interpretation(rulename = ...) vectorization over property/rulename to work with any aggregation method.
      • Now supports: Dominant Condition, Min, Max, Dominant Component, Weighted Average
    • Add query_string argument (default: FALSE). Set as TRUE to skip submitting query to SDA, instead returning a string of the query that would have been sent instead of data.frame result
    • get_SDA_property: better handling of NULL, miscellaneous areas, and property-specific weighting
      • Remove ISNULL(x, 0) logic that affected weighted averages in presence of missing data
      • Conditional calculation of horizon weights considering NULL values for requested properties (unique weights for each property)
      • New default argument include_minors=FALSE includes only components where majcompflag = 'Yes' in result
      • New default argument miscellaneous_areas=FALSE removes miscellaneous land types compkind values from result
      • Organic and bedrock layers are no longer removed from “Weighted Average”, “MIN” or “MAX” aggregations
    • get_SDA_interpretation: added argument not_rated_value with default value of NA to set “not rated”" values across methods/queries. For backwards compatibility with original SQL use not_rated_value = 99.0
    • Standardizing MUKEY column name (and other keys) as lowercase in results
    • More informative error messages for bad input / arguments inconsistent with specified method
  • Thanks to @hammerly who pointed out weighted averaging of NASIS phlabresults wasn’t working as expected and for highlighting some more improvements (https://github.com/ncss-tech/soilDB/issues/192)
  • get_OSD() TXT and HTML formats now supported (in addition to JSON) through a common function interface
  • Added get_NASIS_table_key_by_name() get_NASIS_fkey_by_name(), get_NASIS_pkeyref_by_name(), get_NASIS_pkey_by_name(), get_NASIS_table_name_by_purpose() methods for helping get information on primary/foreign keys and thematic groups of NASIS tables (useful for creating SQLite/external snapshots of NASIS tables)
  • get_mapunit_from_NASIS(), get_legend_from_NASIS() and get_lmuaoverlap_from_NASIS() now works for “MLRA Survey Area” areatypename and no longer is limited by constraints on legendsuituse or mustatus
  • Added formativeElement argument to taxaExtent() (SoilWeb taxon extent function)
    • “Formative elements” are derived from the dictionary provided by the {SoilTaxonomy} package (https://cran.r-project.org/package=SoilTaxonomy)
    • For example: taxaExtent("abruptic", level = 'subgroup', formativeElement = TRUE) will get an 800m grid (for SSURGO data in CONUS) showing extent of taxa that have “abruptic” in subgroup-level taxon name
  • fetchNASIS(from="pedons") result now contains the "taxclname" (full family-level taxon name) field from the NASIS pedon table; this value is calculated based on contents of petaxhistory child table
  • get_SDA_interpretation and get_SDA_property now support aggregation method="NONE" allowing for returning properties, classes and ratings for individual components or horizons (https://github.com/ncss-tech/soilDB/pull/181)
  • ISSR800.wcs and mukey.wcs now return a result that inherits from try-error (and a message) if the Web Coverage Service query fails
  • Connections to local NASIS and various MS Access databases now use DBI and odbc, replacing RODBC
  • New methods dbConnectNASIS and dbQueryNASIS for NASIS access with read-only credentials, fetching query results, and closing the DBIConnection upon completion
  • NASIS methods use dsn argument to specify a local “static” SQLite file containing NASIS tables, or custom DBIConnection to a database with NASIS schema
    • Default dsn = NULL uses "nasis_local" ODBC connection to local NASIS SQL Server
  • Horizon depth logic checking is now done with aqp::checkHzDepthLogic(), powered by {data.table}
  • Added several new SDA query methods based on https://github.com/ncss-tech/ssurgoOnDemand by @jneme910 and @cferguso:
    • get_SDA_property, get_SDA_interpretation, get_SDA_muaggatt, get_SDA_hydric, get_SDA_pmgroupname
  • OSDquery gets a new argument (everything) for searching the entire document
  • fetchNASIS(..., rmHzErrors=TRUE) – spurious removals of data due to missing “extended” records. fetchNASIS now uses aqp::horizons<- after building a minimal SoilProfileCollection from NASIS site and horizon tables. This allows aqp integrity methods to trigger where needed–preventing unintentional re-ordering or removals of “valid” horizon data.
  • HenryTimeLine moved to {sharpshootR} package
  • new functions mukey.wcs() and ISSR800.wcs() for hitting web coverage service (WCS) for gSSURGO, gNATSGO, and ISSR-800 grids
  • new function ROSETTA() for accessing the new ROSETTA model API (c/o Todd Skaggs, USDA-ARS)
  • fetchOSD(..., extended=TRUE) gains geographically associated soils, parsed from OSD (thanks AGB)
  • fetchSDA_spatial now can return soil survey area polygons using geom.src = "sapolygon" with x as a vector of area symbols (areasymbol) or legend keys (lkey). For sapolygon results, the method and add.field arguments work the same as for mupolygon, only now both geometries can be returned with fields from the legend table.
  • fetchSDA_spatial now can return STATSGO gsmmupolygon geometry with db = "STATSGO"; these data are linked to mapunit and (national) legend just like mupolygon.
  • fetchNASIS / soilDB:::.rockFragmentSieve now uses fragment RV, soilDB:::.sieve uses < operator (https://github.com/ncss-tech/soilDB/issues/1)
  • fetchKSSL(..., returnMorphologicData=TRUE) now returns redoximorphic features by horizon
  • new function taxaExtent returns 800m gridded taxonomic grids for CONUS
  • seriesExtent can now return 800m gridded series extents for CONUS
  • SDA_spatialQuery can now retrieve SSURGO and STATSGO geometry c/o dschlaep (https://github.com/ncss-tech/soilDB/issues/141)
  • new import: data.table; beginning to implement data.table-aware methods in aqp and soilDB
  • add fetchGDB for querying tabular data from SSURGO/gNATSGO/STATSGO File Geodatabases
  • add get_NOAA_GHCND() and get_NOAA_stations_nearXY() for batch queries of NOAA Daily Climate Data (requires free API token)
  • bug fix for fetchSDA_spatial with chunk.size > 1 resulting in duplicate data in result
  • major improvements to fetchSDA_spatial to handle queries that exceed JSON Serialization Limit
  • add fetchSoilGrids for point data queries to SoilGrids v2 API with SoilProfileCollection output
  • fetchKSSL(..., returnGeochemicalData=TRUE) now returns geochemical, optical and XRD/thermal data
  • bug fixes in fetchKSSL related to vectorization, all arguments vectorized except for bbox
  • KSSL_VG_model output cleaned-up, now returns phi -> theta function
  • fetchKSSL is now fully vectorized and builds on new SoilWeb JSON API
  • bug fix for fetchNASIS(from='components', fill=TRUE, rmHzErrors=TRUE) in context of new ::hzDepthTests() and non-unique chiid due to NA values introduced by fill
  • CRAN release
  • simplifyColorData and mix_and_clean_colors always use CIELAB colorspace for weighted averages, and best-available metric for transformation to Munsell notation
  • fetchSDA_spatial - new fetch function that simplifies getting spatial data associated with a vector of mukey or nationalmusym. The function has options for customizing result attribute table and is designed to automatically use makeChunks() to prevent timeout on large queries.
  • aqp::test_hz_logic is now deprecated – refactored affected fetch functions
  • SDA_query() no longer writes temporary files, c/o suggestion from Kyle Bocinsky (#106 / #108)
  • fetchOSD() gets a sanity check to protect against going over GET request limits
  • makeChunks() added to util functions, useful for splitting data before sending API calls
  • sharpshootR added to SUGGESTS
  • fetchHenry() and fetchSCAN() now include water year/day (Oct 1 – Sep 30)
  • HenryTimeLine() convenience function added
  • bug fix in fetchOSD(..., extended=TRUE) when no climate data available
  • bug fix in SDA_query()
  • NAMESPACE and R CMD check fixes
  • documentation updates
  • soilDB now suggests stringr
  • new tests
  • release to CRAN
  • bug fix in fetchNASIS() related to conversion of NULL fragment volume to 0
  • fetchKSSL() can now automatically simplify colors with simplifyColors = TRUE
  • new function for exploring soil series co-occurrence data: siblings()
  • fetchOSD(..., extended=TRUE) gets competing soil series
  • new tests
  • removed old sample gSSURGO chunk and related documentation
  • release to CRAN
  • new function for spatial queries: SDA_spatialQuery(), still needs testing and documentation
  • fetchOSD() gets an overhaul, new API and features
  • experimental interface to SoillWeb OSD fulltext search: OSDquery()
  • get_mutext_from_NASIS_db() added for extraction of map unit text notes
  • bug fix for subtle change in how SCAN data are returned from webservice
  • bug fix for simplifyFragmentData(, nullFragsAreZero=FALSE), still more work to do
  • bug fix for simplifyFragmentData() when fragment volume > 100%
  • updated loafercreek and gopheridge sample datasets and manual page to reflect latest fetchNASIS
  • bug fixes, manual page updates, and stabilization of NASIS interaction
  • released to CRAN
  • bug fix in fetchHenry(), it is now possible to query only sensor metadata
  • re-write of mix_and_clean_colors() so that color mixing happens in CIE LAB space
  • re-write of SDA_query(), better error handling, support for multi-part result sets
  • fetchHenry() can now access water level data, see manual page
  • new function: get_comonth_from_NASIS_db() see manual page for details
  • converting all URLs to ‘HTTPS’, addressing bugs with fetchSCAN() and associated functions
  • sanity checks for fetchHenry()
  • SCAN_sensor_metadata() vectorized and documented
  • unique row names in SPDF returned by seriesExtent()
  • converted all links to SoilWeb servers to HTTPS
  • converted all NRCS web-service links to HTTPS
  • fetchOSD() now returns dry colors and the source “narrative” for each horizon; function gains an argument
  • fetchOSD() now returns texture class, coarse fragment modifier, pH, and pH class
  • fetchSCAN() re-written, see manual pages and http://ncss-tech.github.io/AQP/soilDB/fetchSCAN-demo.html
  • fetchKSSL() can now query basic morphologic data with the argument “returnMorphologicData”
  • two new functions for simplifying NASIS color and fragment data:
    • simplifyFragmentData()
    • simplifyColorData()
  • ^^^ these new functions are now used by fetchNASIS() to summarize color and fragment data (vs. SQL)
  • NOTE: soilDB now uses reshape2::dcast() instead of reshape::cast()
  • bug fix in colors returned by fetchNASIS(), reported by Andy Paolucci
  • bug fix in SDA_query(), due to changes in httr::content. Thanks Kyle Bocinsky for the fix!
  • SDA_query() now returns SQL errors generated by SDA
  • new columns from NASIS site table returned by fetchNASIS()
  • NASIS pedon ecosite data now returned by fetchNASIS() (c/o J. Skovlin)
  • clean-up in local NASIS queries, removed extra parentheses
  • NASIS component query function overhaul: previous code may be broken, details pending
  • added temperature class (temp_class) field from the pedon taxonomic history table (NASIS) [addition suggested by J. Baker]
  • experimental function for processing SDA queries that return geometry: processSDA_WKT()
  • bug fix for poorly specified geomorphic descriptions, caused fetchNASIS() to barf
  • fetchKSSL() gains new query filters, see man page
  • package re-org, getting ready for soilDB 2.0:
    • dropping use of RCurl functions in favor of httr alternatives (done)
    • switch from reshape to reshape2 (pending)
    • possibly move some packages from SUGGESTS to IMPORTS
  • new spatial query helper functions for SDA
  • re-named SSURGO_spatial_query() to SoilWeb_spatial_query(), this function may be phased-out due to spatial support now available in SDA
  • removed MUKEYS_by_ll_bbox() function, no longer needed and web-service may be disabled at any time
  • mapunit_geom_by_ll_bbox() will probably be removed in the near future with an SDA-based alternative
  • KSSL data updated (server-side) to June 2015 snapshot, “site_id” column removed from fetchKSSL() results
  • soilDB now imports from the reshape package, will transition to reshape2 with soilDB 2.0
  • fetchHenry() officially added, complete with documentation
  • SDA_query() undergoing some upgrades, no longer requires SSOAP / XMLSchema packages
  • SSOAP / XMLSchema packages no longer in ‘suggests’ list
  • fetchKSSL() gets an argument for downloading data by MLRA
  • updated the loafercreek and gopheridge sample datasets
  • nullFragsAreZero argument to fetchNASIS() reset to TRUE, new documentation pending
  • consolidate of messages printed when running fetchNASIS()
  • introduction of new option “soilDB.verbose” (default is FALSE) for increasing the level of QC information printed
  • new tutorial on fetchNASIS()
  • RODBC temporarily moved from “suggested” package to “imported” package… not a good idea, reverted to “suggested”
  • mix_and_clean_colors() now returns back-transformed, mixed, munsell colors
  • added psctopdepth and pscbotdepth back to extended NASIS query (particle size control section depths)
  • get_hz_data_from_NASIS_db() no longer assumes fragment volume of NULL = 0
  • get_extended_data_from_NASIS_db() no longer assumes fragment volume of NULL = 0
  • fetchNASIS() has a new argument, nullFragsAreZero=FALSE; set to TRUE for past NULL -> 0 conversion
  • new internally-used function .formatLandformString() for flattening NASIS/PedonPC “landform” records
  • new internally-used function .formatParentMaterialString() for flattening NASIS/PedonPC “parent material” records
  • fetchNASIS() incorporates the results of these two new functions
  • new function SSURGO_spatial_query() queries SSURGO data from SoilWeb (see manual page for details)
  • moving most of the hard-to-install packages into suggests, and checking for package availability at function runtime. this will make soilDB more portable, as not every user will want or need all functionality.
  • fetchNASIS() gains argument rmHzErrors to optionally retain pedons with horizonation errors. use with caution.
  • Changes made to fetch functions to accommodate changes implemented in the NASIS 6.3 data structure
  • get_site_data_from_NASIS_db(): in cases where multiple records in site-bedrock exist, retain only the most shallow
  • fetchRaCA() has a new argument for querying data by rcasiteid
  • SOC concentration and stock values are temporarily disabled in fetchRaCA()
    • waiting for new estimates from the Soil Survey Center…
  • added new function contributed by J.M. Skovlin: get_veg_from_NPS_PLOTS_db()
  • bug fixes in get_extended_data_from_NASIS_db(): results from geomorph tables are now returned
  • added new function fetchSCAN() for downloading soil/climate data from USDA-NRCS SCAN stations (still experimental!)
  • bug fixing in fetchRaCA():
    • “#” characters no longer cause errors
    • duplicate IDs in source data have been fixed
  • fetchRaCA() function now stable, ready for general usage
  • fixed bug in fetchRaCA() function where the presence of single-quote character in horizon designation would throw and error
  • new function get_copedon_from_NASIS_db(): returns basic information associated with pedons linked to component data in NASIS
  • new function fetchRaCA(): gets data from the Rapid Carbon Assessment project [work in progress]
  • get_site_data_from_NASIS_db() no longer has problems when more than 1 site bedrock kind is defined; only the shallowest row is returned
  • fetchNASIS() is now much more efficient: faster / less memory used
  • new function! fetchKSSL(): experimental interface to (most of) the KSSL data
    • queries can be performed by series name or GCS bounding box
    • data are delivered via CA Soil Resource Lab server
  • fetchOSD() now immune to queries for non-soils
  • improved efficiency in fetch* functions
  • NASIS-DMU fetching functions now return more information, still not as complete as pedon-queries
  • NASIS query functions now return only records from the selected set, please test older code!
  • new function get_text_notes_from_NASIS_db() – still needs proper documentation
  • bug fixes to PedonPC and NASIS queries, new data elements returned by extended query functions
  • SoilWeb queries via URL are now URL-encoded to allow for spaces in soil series names
  • new function: fetchOSD() returns basic OSD data as a SoilProfileCollection
  • speed-bump in color-fetching functions from NASIS/pedonPC
  • fetchNASIS() now attempts to correct for >1 pedon/site by appending peiid to pedon_id
  • new functions for getting / plotting the geographic extent of a soil series, using the SoilWeb query service: +seriesExtent() : fetches extent as a SpatialPolygonDataFrame +seriesExtentAsGmap() : fetches extent and plots on Google Maps (requires dismo package)
  • updated functionality in fetchNASIS_component_data() pulls mapunit-level data as well as component-level data
  • Munsell ‘value’ is now returned from PedonPC/NASIS fetching functions
  • added a surface fragment summary “surf_frag_summary” to the results of get_extended_data_from_NASIS()
    • note: this has not been ported to the related PedonPC queries
  • integrated surf_frag_summary data into data returned from fetchNASIS(), stored in @site
    • note: this has not been ported to the related PedonPC queries
  • minor bug-fix in horizon-level rock fragment summary SQL which previously mis-classified BD as ST in some, rare cases
    • note: this has not been ported to the related PedonPC queries
  • site-level data: {elev, slope, aspect} are now named {elev_field, slope_field, aspect_field}
    • this affects the data returned by fetchNASIS() and fetchPedonPC()
  • compatible with NASIS 6.2
  • bug fixes
  • taxhistory selection method is preserved in the results
  • ‘taxonname’ is used instead of ‘sampled_as’ / ’correlated_as, seems to work, but needs further testing
  • updating for PedonPC 5.0 and NASIS 6.2
    • site data contains the best-guessed corresponding row from the taxhistory table, based on:
      1. most recent record, or 2) record with the least amount of missing data
    • taxhistory data are now included in the output from get_extended_data_from_pedon_db()
  • package is now partially compatible with NASIS 6.2
  • tidying up documentation, package dependencies, and NAMESPACE
  • adding preliminary functions for querying component data from local NASIS
  • fixed minor bug in SDA_query() and added some links to related documentation
  • fetchNASIS() and fetchPedonPC() now integrate `extended’ data
  • warning and error messages cleaned-up
  • multiple textures no longer cause duplicate HZ rows (NASIS only)
  • extended queries now split frags/para-frags
  • silt fraction is estimated from 100-(sand+clay) when possible
  • added local NASIS ODBC connection vignette (thanks JMS)
  • removed dsn argument from NASIS functions as it should always be ‘nasis_local’
  • new wide-formatted, boolean representation of diagnostic horizon data
  • queries standardized between NASIS/PedonPC
  • new fetchNASIS() function for 1-line access to local NASIS data
  • new sample data set ‘loafercreek’
  • basic vignette added, switching to knitr-style vignettes
  • SDA_query() now functional on MacOS/UNIX-like OSes with (SSOAP 0.8-1, XMLSchema 0.6-0, and XML 3.7-1), thanks to D.T. Lang for the updates!
  • moving hard to find packages to ‘suggested’ status: SSOAP, RCurl, XML, rgdal
  • new wrapper function fetchPedonPC() for typical site/pedon/hz queries
  • new function getHzErrorsPedonPC() for ID-ing pedons with problem horizonation
  • NOTE: hz data queries will return 2 rows/hz (error) when multiple texture classes are assigned to a single horizon- this is a bug, not a feature!
  • NASIS/pedonPC queries synced
  • minor bug fixes and documentation updates
  • updated query structure, switching over to native NASIS/PedonPC IDs
  • extended summaries added: NASIS only
  • moved functions out of aqp package
  • basic query functionality from local NASIS DB (Jay)
  • initial version on r-forge
  • functions still exist in aqp package… need to move over completely