soilDB (version 2.5)

siblings: Lookup siblings and cousins for a given soil series.

Description

Lookup siblings and cousins for a given soil series, from the current fiscal year SSURGO snapshot via SoilWeb.

Usage

siblings(s, only.major=FALSE, component.data = FALSE, cousins = FALSE)

Arguments

s

character vector, the name of a single soil series, case-insensitive.

only.major

logical, should only return siblings that are major components

component.data

logical, should component data for siblings (and optionally cousins) be returned?

cousins

logical, should siblings-of-siblings (cousins) be returned?

Value

sib

data.frame containing siblings, major component flag, and number of co-occurrences

sib.data

data.frame containing sibling component data

cousins

data.frame containing cousins, major component flag, and number of co-occurrences

cousin.data

data.frame containing cousin component data

Details

The siblings of any given soil series are defined as those soil series (major and minor component) that share a parent map unit with the named series (as a major component). Cousins are siblings of siblings. Data are sourced from SoilWeb which maintains a copy of the current SSURGO snapshot.

References

soilDB Soil Series Query Functionality

Related tutorial.

See Also

OSDquery, siblings, fetchOSD

Examples

# NOT RUN {
if(requireNamespace("curl") &
    curl::has_internet()) {
    
    # basic usage
    x <- siblings('zook')
    x$sib
    
    # restrict to siblings that are major components
    # e.g. the most likely siblings
    x <- siblings('zook', only.major = TRUE)
    x$sib
}
# }