Function to return StreamCat catchment and watershed metrics using the StreamCat API. The function allows a user to get specific metric data aggregated by area of interest, returned by comid(s), hydroregion(s), state(s), or county(ies).
Usage
sc_get_data(
comid = NULL,
metric = NULL,
aoi = NULL,
showAreaSqKm = NULL,
showPctFull = NULL,
state = NULL,
county = NULL,
region = NULL,
conus = NULL,
countOnly = NULL
)
Arguments
- comid
Return metric information for specific COMIDs. Can be a comma-delimited list, a character vector, or any object that can be coerced to a comma-delimited list with
paste
. One ofcomid
,county
,state
, orregion
is required unlessconus='true'
. Syntax: comid=<comid1>,<comid2>- metric
Name(s) of metrics to query. Must be character string with comma-delimited list of metrics, or, if
metric='all'
then all metrics will be queried. Not case-sensitive. Syntax: name=<name1>,<name2>- aoi
Name(s) of areas of interest to query. If a metric does not have data for a given AOI, no data is returned for that AOI. Certain metrics that have no AOI specified for StreamCat need the AOI to be specified as
'other'
. These metrics include: BankfullDepth, BankfullWidth, ThalwagDepth (sic), CHEM_V2_1, CONN, HABT, HYD, ICI, IWI, TEMP, WettedWidth, prg_bmmi, and all the mast, msst, mwst metrics. Case-sensitive.Syntax: areaOfInterest=<value1>,<value2> Values: cat|ws|catrp100|wsrp100|other
- showAreaSqKm
Return the area in square kilometers of a given area of interest. The default value is false. Values: true|false
- showPctFull
Return the pctfull for each dataset. The default value is false. Values: true|false
- state
Return metric information for COMIDs within a specific state. Use a state's abbreviation to query for a given state. One of
comid
,county
,state
, orregion
is required unlessconus='true'
. If specified and valid,comid
andcounty
are ignored. Case-sensitive. Syntax: state=<state1>,<state2>- county
Return metric information for COMIDs within a specific county. Users must use the FIPS code, not county name, as a way to disambiguate counties. One of
comid
,county
,state
, orregion
is required unlessconus='true'
. If specified and valid,comid
is ignored. Syntax: county=<county1>,<county1>- region
Return metric information for COMIDs within a specified hydroregion. Hydroregions are specified using full name i.e.
'Region01'
,'Region03N'
,'Region10L'
One ofcomid
,county
,state
, orregion
is required unlessconus='true'
. If specified and valid,comid
,county
, andstate
are ignored. Case-sensitive. Syntax: region=<regionid1>,<regionid2>- conus
Return all COMIDs in the conterminous United States. Character string (Not case-sensitive) or logical. The default value is false. If true,
comid
,county
,state
, andregion
are ignored. Values: true|false- countOnly
Return a CSV containing only the row count (ROWCOUNT) and the column count (COLUMNCOUNT) that the server expects to return in a request. The default value is false. Values: true|false
Value
A data frame of StreamCat metrics. If data are missing for all rows of a given metric, then the column for that metric will not exist. If data are missing for only some rows, then they will be specified with NA.
Examples
# \donttest{
df <- sc_get_data(comid='179', aoi='cat', metric='fert')
df <- sc_get_data(metric='pctgrs2006', aoi='ws', region='Region01')
df <- sc_get_data(metric='pctwdwet2006', aoi='ws', county='41003')
df <- sc_get_data(metric='pcturbmd2006', aoi='wsrp100',
comid='1337420')
df <- sc_get_data(metric='pcturbmd2006,damdens',
aoi='cat,ws', comid='179,1337,1337420')
df <- sc_get_data(metric='pcturbmd2006,damdens',
aoi='cat,ws', comid='179,1337,1337420',
showAreaSqKm='true', showPctFull='true')
df <- sc_get_data(metric='pcturbmd2006,damdens',
aoi='cat,ws', comid='179,1337,1337420', countOnly='true')
df <- sc_get_data(metric='thalwagdepth', comid='179,1337,1337420', aoi='other')
df <- sc_get_data(metric='thalwagdepth', comid=c('179','1337','1337420'), aoi='other')
df <- sc_get_data(comid='179', aoi='ws', metric='all')
#> Using metric='all' with a large aoi may take a considerable amount of time to return results - request may timeout if multiple AOIs are requested
# }