Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ncss-tech/soildb

soilDB: Simplified Access to National Cooperative Soil Survey Databases
https://github.com/ncss-tech/soildb

cran kssl nasis nrcs r soil soil-data-access soil-survey soilweb sql usda

Last synced: 10 days ago
JSON representation

soilDB: Simplified Access to National Cooperative Soil Survey Databases

Host: GitHub
URL: https://github.com/ncss-tech/soildb
Owner: ncss-tech
Created: 2016-03-23T21:51:10.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-04-11T14:49:24.000Z (7 months ago)
Last Synced: 2024-04-14T00:29:20.448Z (7 months ago)
Topics: cran, kssl, nasis, nrcs, r, soil, soil-data-access, soil-survey, soilweb, sql, usda
Language: R
Homepage: http://ncss-tech.github.io/soilDB/
Size: 151 MB
Stars: 76
Watchers: 8
Forks: 19
Open Issues: 22
Metadata Files:
- Readme: README.Rmd
- Citation: CITATION.cff

Awesome Lists containing this project

README

        ---

output: md_document 

---

[![CRAN version](https://www.r-pkg.org/badges/version/soilDB)](https://CRAN.R-project.org/package=soilDB)

[![CRAN status](https://badges.cranchecks.info/worst/soilDB.svg)](https://cran.r-project.org/web/checks/check_results_soilDB.html)

[![Development Version](https://ncss-tech.r-universe.dev/badges/soilDB)](https://ncss-tech.r-universe.dev/)

[![R-CMD-check Build Status](https://github.com/ncss-tech/soilDB/actions/workflows/R-CMD-check.yml/badge.svg)](https://github.com/ncss-tech/soilDB/actions)

[![Monthly CRAN Downloads](https://cranlogs.r-pkg.org/badges/soilDB)](https://cran.r-project.org/package=soilDB)

![CRAN/METACRAN](https://img.shields.io/cran/l/soilDB)

[![soilDB Manual](https://img.shields.io/badge/docs-HTML-informational)](https://ncss-tech.github.io/soilDB/)

```{r, echo=FALSE, message=FALSE, warning=FALSE}

library(rvest)

# get latest release semantic version number for citation

.getLatestCRANRelease <- function() { 

  gsub(".*/([0-9\\.]+)$", "\\1", html_text(html_element(html_element(read_html("https://github.com/ncss-tech/soilDB/releases.atom"), "entry"), "id")))

}

.update_CITATION <- function(version) {

  x <- sprintf('citHeader("To cite soilDB in publications use:")

bibentry(

  bibtype = "Manual",

  title = "soilDB: Soil Database Interface",

  author = "Dylan Beaudette, Jay Skovlin, Stephen Roecker and Andrew Brown",

  note = "R package version %s",

  url = "https://CRAN.R-project.org/package=soilDB",

  year = "%s",

  textVersion = "Beaudette, D., Skovlin, J., Roecker, S., Brown, A. (%s). soilDB: Soil Database Interface. R package version %s. "

)

', version, format(Sys.time(), "%Y"), format(Sys.time(), "%Y"), version)

  suppressWarnings(writeLines(strsplit(x, "\n")[[1]], "inst/CITATION"))

}

# get latest tagged release from github

soilDB_CRAN_VERSION <- .getLatestCRANRelease()

# get installed version

soilDB_INSTALLED_VERSION <- packageVersion("soilDB")

# rebuilding readme locally, use installed version

if (soilDB::local_NASIS_defined() && (soilDB_INSTALLED_VERSION > soilDB_CRAN_VERSION)) {

  .update_CITATION(soilDB_INSTALLED_VERSION)

} else {

  .update_CITATION(soilDB_CRAN_VERSION)

}

# update inst/CITATION

```

## Installation

Get the stable version from CRAN:

```r

install.packages('soilDB', dependencies = TRUE)

```

Get the development version from GitHub:

```r

remotes::install_github("ncss-tech/soilDB", dependencies = FALSE)

```

## Website

 - CRAN Package: https://cran.r-project.org/package=soilDB

 - Package Manual: http://ncss-tech.github.io/soilDB/

 - Algorithms for Quantitative Pedology (AQP) Project: http://ncss-tech.github.io/AQP/

## Citation

```{r, echo=FALSE}

citation("soilDB")

```

## soilDB `r packageVersion("soilDB")`

## Functions by Data Source 

    

  * Soil Data Access (SDA)

    + [`fetchSDA`](http://ncss-tech.github.io/soilDB/reference/fetchSDA.html)

    + [`fetchSDA_spatial`](http://ncss-tech.github.io/soilDB/reference/fetchSDA_spatial.html)

    + [`SDA_query`](http://ncss-tech.github.io/soilDB/reference/SDA_query.html)

    + [`SDA_spatialQuery`](http://ncss-tech.github.io/soilDB/reference/SDA_spatialQuery.html)

    + "SSURGO On Demand" Queries

      - [`get_SDA_hydric`](http://ncss-tech.github.io/soilDB/reference/get_SDA_hydric.html)

      - [`get_SDA_interpretation`](http://ncss-tech.github.io/soilDB/reference/get_SDA_interpretation.html)

      - [`get_SDA_muaggatt`](http://ncss-tech.github.io/soilDB/reference/get_SDA_muaggatt.html)

      - [`get_SDA_pmgroupname`](http://ncss-tech.github.io/soilDB/reference/get_SDA_pmgroupname.html)

      - [`get_SDA_property`](http://ncss-tech.github.io/soilDB/reference/get_SDA_property.html)

      - [`get_SDA_coecoclass`](http://ncss-tech.github.io/soilDB/reference/get_SDA_coecoclass.html)

      - [`get_SDA_metrics`](http://ncss-tech.github.io/soilDB/reference/get_SDA_metrics.html)

      - [`get_SDA_cosurfmorph`](http://ncss-tech.github.io/soilDB/reference/get_SDA_cosurfmorph.html)

      

  * SSURGO Web Soil Survey 

    + [`downloadSSURGO`](http://ncss-tech.github.io/soilDB/reference/downloadSSURGO.html)

    + [`createSSURGO`](http://ncss-tech.github.io/soilDB/reference/createSSURGO.html)

 

  * SSURGO Local Geodatabases

    + [`fetchGDB`](http://ncss-tech.github.io/soilDB/reference/fetchGDB.html)

  * ROSETTA

    + [`ROSETTA`](http://ncss-tech.github.io/soilDB/reference/ROSETTA.html)

  

  * SSURGO/KSSL via SoilWeb

    + [`fetchKSSL`](http://ncss-tech.github.io/soilDB/reference/fetchKSSL.html)

    + [`fetchOSD`](http://ncss-tech.github.io/soilDB/reference/fetchOSD.html)

    + [`siblings`](http://ncss-tech.github.io/soilDB/reference/siblings.html)

    + [`OSDquery`](http://ncss-tech.github.io/soilDB/reference/OSDquery.html) 

    + [`seriesExtent`](http://ncss-tech.github.io/soilDB/reference/seriesExtent.html)

    + [`taxaExtent`](http://ncss-tech.github.io/soilDB/reference/taxaExtent.html)

    + [`mukey.wcs`](http://ncss-tech.github.io/soilDB/reference/mukey.wcs.html)

    + [`ISSR800.wcs`](http://ncss-tech.github.io/soilDB/reference/ISSR800.wcs.html)

  

  * NASIS WWW interface

    + [`parseWebReport`](http://ncss-tech.github.io/soilDB/reference/parseWebReport.html)

    + [`fetchNASISWebReport`](http://ncss-tech.github.io/soilDB/reference/fetchNASISWebReport.html)

  

  * SCAN/SNOTEL

    + [`fetchSCAN`](http://ncss-tech.github.io/soilDB/reference/fetchSCAN.html)

    + [`SCAN_SNOTEL_metadata`](http://ncss-tech.github.io/soilDB/reference/SCAN_SNOTEL_metadata.html)

    

  * Henry Mount Soil and Water Database

    + [`fetchHenry`](http://ncss-tech.github.io/soilDB/reference/fetchHenry.html)

    

  * NASIS local database

    + [`fetchNASIS`](http://ncss-tech.github.io/soilDB/reference/fetchNASIS.html)

    + [`dbConnectNASIS`](http://ncss-tech.github.io/soilDB/reference/dbConnectNASIS.html) (alias `NASIS()`)

    + [`dbQueryNASIS`](http://ncss-tech.github.io/soilDB/reference/dbQueryNASIS.html)

    + [`createStaticNASIS`](http://ncss-tech.github.io/soilDB/reference/createStaticNASIS.html)

    

  * SoilGrids

    + [`fetchSoilGrids`](http://ncss-tech.github.io/soilDB/reference/fetchSoilGrids.html)

## Miscellaneous Functions

  * [`estimateSTR`](http://ncss-tech.github.io/soilDB/reference/estimateSTR.html)

  * [`STRplot`](http://ncss-tech.github.io/soilDB/reference/STRplot.html)

  * [`KSSL_VG_model`](http://ncss-tech.github.io/soilDB/reference/KSSL_VG_model.html)

  * [`simplifyFragmentData`](http://ncss-tech.github.io/soilDB/reference/simplifyFragmentData.html)

  * [`simplifyColorData`](http://ncss-tech.github.io/soilDB/reference/simplifyColorData.html)

  * [`uncode`](http://ncss-tech.github.io/soilDB/reference/uncode.html)

  * [`code`](http://ncss-tech.github.io/soilDB/reference/code.html)

  * [`get_NOAA_GHCND`](http://ncss-tech.github.io/soilDB/reference/get_NOAA_GHCND.html)

## Tutorials and Demonstrations

 * [fetchKSSL](http://ncss-tech.github.io/AQP/soilDB/KSSL-demo.html)

 * [SDA_query](http://ncss-tech.github.io/AQP/soilDB/SDA-tutorial.html)

 * [fetchOSD](http://ncss-tech.github.io/AQP/sharpshootR/OSD-dendrogram.html)

 * [SCAN/SNOTEL Data](http://ncss-tech.github.io/AQP/soilDB/fetchSCAN-demo.html)

## Related Packages

 * [aqp](https://github.com/ncss-tech/aqp)

 * [sharpshootR](https://github.com/ncss-tech/sharpshootR)

 * [SoilTaxonomy](https://github.com/ncss-tech/SoilTaxonomy)