readNWISrating | R Documentation |
Reads current rating table for an active USGS streamgage from NWISweb. Data is retrieved from https://waterdata.usgs.gov/nwis.
readNWISrating(siteNumber, type = "base", convertType = TRUE)
siteNumber |
character USGS site number. This is usually an 8 digit number |
type |
character can be "base", "corr", or "exsa" |
convertType |
logical, defaults to |
A data frame. If type
is "base, " then the columns are
INDEP, typically the gage height, in feet; DEP, typically the streamflow,
in cubic feet per second; and STOR, where "*" indicates that the pair are
a fixed point of the rating curve. If type
is "exsa, " then an
additional column, SHIFT, is included that indicates the current shift in
the rating for that value of INDEP. If type
is "corr, " then the
columns are INDEP, typically the gage height, in feet; CORR, the correction
for that value; and CORRINDEP, the corrected value for CORR.
If type
is "base, " then the data frame has an attribute called "RATING"
that describes the rating curve is included.
There are also several useful attributes attached to the data frame:
Name | Type | Description |
url | character | The url used to generate the data |
queryTime | POSIXct | The time the data was returned |
comment | character | Header comments from the RDB file |
siteInfo | data.frame | A data frame containing information on the requested sites |
RATING | character | Rating information |
Not all active USGS streamgages have traditional rating curves that relate flow to stage.
constructNWISURL
, importRDB1
site_id <- "01594440"
data <- readNWISrating(site_id, "base")
attr(data, "RATING")
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.