Skip to contents

Imports data from the Water Quality Portal, so it could be STORET, USGS, or USDA data. This function gets the data from: https://www.waterqualitydata.us For raw data, use readWQPdata. This function will retrieve the raw data, compress it (summing constituents), then converts it to the Sample dataframe structure. See chapter 7 of the EGRET user guide for more details.

Usage

readWQPSample(siteNumber, characteristicName, startDate = "", endDate = "",
  verbose = TRUE, legacy = TRUE)

Arguments

siteNumber

character site number. If USGS, it should be in the form :'USGS-XXXXXXXXX...'

characteristicName

character. Either a valid characteristic name, or a 5 digit USGS parameter code.

startDate

character starting date for data retrieval in the form YYYY-MM-DD. Default is empty quotes "" which will retrieve the full period of record.

endDate

character ending date for data retrieval in the form YYYY-MM-DD. Default is empty quotes "" which will retrieve the full period of record.

verbose

logical specifying whether or not to display progress message

legacy

logical specifying whether to use the "legacy" WQP services, or the new ones. Legacy works well for non-USGS sites. For USGS sites it is recommended to use the readNWISSample function. Default is TRUE.

Value

A data frame 'Sample' with the following columns:

NameTypeDescription
DateDateDate
ConcLownumericLower limit of concentration
ConcHighnumericUpper limit of concentration
UncenintegerUncensored data (1=TRUE, 0=FALSE)
ConcAvenumericAverage concentration
JulianintegerNumber of days since Jan. 1, 1850
MonthintegerMonth of the year [1-12]
DayintegerDay of the year [1-366]
DecYearnumericDecimal year
MonthSeqintegerNumber of months since January 1, 1850
SinDYnumericSine of the DecYear
CosDYnumericCosine of the DecYear

Examples

if (FALSE) { # interactive()
# These examples require an internet connection to run
# \donttest{
Sample_All <- readWQPSample('WIDNR_WQX-10032762','Specific conductance', '', '')
# }
}