get_SDA_interpretation {soilDB}R Documentation

Get map unit interpretations from Soil Data Access by rule name

Description

Get map unit interpretations from Soil Data Access by rule name

Usage

get_SDA_interpretation(
  rulename,
  method = c("Dominant Component", "Dominant Condition", "Weighted Average", "None"),
  areasymbols = NULL,
  mukeys = NULL,
  WHERE = NULL,
  query_string = FALSE,
  not_rated_value = NA_real_,
  wide_reason = FALSE,
  dsn = NULL
)

Arguments

rulename

character vector of interpretation rule names (matching mrulename in cointerp table)

method

aggregation method. One of: "Dominant Component", "Dominant Condition", "Weighted Average", "None". If "None" is selected one row will be returned per component, otherwise one row will be returned per map unit.

areasymbols

vector of soil survey area symbols

mukeys

vector of map unit keys

WHERE

character containing SQL WHERE clause specified in terms of fields in legend, mapunit, or component tables, used in lieu of mukeys or areasymbols

query_string

Default: FALSE; if TRUE return a character string containing query that would be sent to SDA via SDA_query

not_rated_value

used where rating class is "Not Rated". Default: NA_real_

wide_reason

Default: FALSE; if TRUE apply post-processing to all columns with prefix "reason_" to create additional columns for sub-rule ratings.

dsn

Path to local SQLite database or a DBIConnection object. If NULL (default) use Soil Data Access API via SDA_query().

Details

Rule Names in cointerp table

Value

a data.frame

Author(s)

Jason Nemecek, Chad Ferguson, Andrew Brown

Examples




  # get two forestry interpretations for CA630
  get_SDA_interpretation(c("FOR - Potential Seedling Mortality",
                           "FOR - Road Suitability (Natural Surface)"),
                         method = "Dominant Condition",
                         areasymbols = "CA630")
[Package soilDB version 2.8.2 Index]