From cf41677ab8be8bbbb1dc98320f3cdf2292af5728 Mon Sep 17 00:00:00 2001
From: Laura DeCicco <ldecicco@usgs.gov>
Date: Thu, 13 Dec 2012 09:30:09 -0600
Subject: [PATCH] Latest build with unit value code addition.

---
 DESCRIPTION                 |  1 +
 NAMESPACE                   |  1 +
 R/getStoretData.r           |  6 ++---
 R/getWQPData.r              |  6 ++---
 R/retrieveUnitNWISData.r    |  2 +-
 man/getParameterInfo.Rd     |  6 ++---
 man/getStoretData.Rd        |  6 ++---
 man/getWQPData.Rd           |  8 +++---
 man/retrieveUnitNWISData.Rd | 53 +++++++++++++++++++++++++++++++++++++
 9 files changed, 72 insertions(+), 17 deletions(-)
 create mode 100644 man/retrieveUnitNWISData.Rd

diff --git a/DESCRIPTION b/DESCRIPTION
index ab9bee77..061daff2 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -47,6 +47,7 @@ Collate:
     'dataOverview.r'
     'getStoretData.r'
     'getWQPData.r'
+    'retrieveUnitNWISData.r'
 Depends:
     R (>= 2.15.0),
     zoo,
diff --git a/NAMESPACE b/NAMESPACE
index a60bec6b..97289b5c 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -29,5 +29,6 @@ export(populateSampleColumns)
 export(populateSiteINFO)
 export(removeDuplicates)
 export(retrieveNWISData)
+export(retrieveUnitNWISData)
 exportClasses(fluxUnit)
 import(zoo)
diff --git a/R/getStoretData.r b/R/getStoretData.r
index af1b5ec0..263a4278 100644
--- a/R/getStoretData.r
+++ b/R/getStoretData.r
@@ -15,9 +15,9 @@
 #' @export
 #' @examples
 #' # These examples require an internet connection to run
-#' getStoretData('01594440','01075', '1985-01-01', '1985-03-31')
-#' getStoretData('05114000','', '1985-01-01', '1985-03-31')
-#' getStoretData('05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)
+#' \dontrun{getStoretData('01594440','01075', '1985-01-01', '1985-03-31')}
+#' \dontrun{getStoretData('05114000','', '1985-01-01', '1985-03-31')}
+#' \dontrun{getStoretData('05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)}
 getStoretData <- function(siteNumber,characteristicName,StartDate,EndDate,interactive=TRUE){
   siteNumber <- formatCheckSiteNumber(siteNumber, interactive=interactive)
   StartDate <- formatCheckDate(StartDate, "StartDate", interactive=interactive)
diff --git a/R/getWQPData.r b/R/getWQPData.r
index 2e0536bf..c9f214fe 100644
--- a/R/getWQPData.r
+++ b/R/getWQPData.r
@@ -15,9 +15,9 @@
 #' @export
 #' @examples
 #' # These examples require an internet connection to run
-#' getWQPData('USGS-01594440','Chloride', '', '')
-#' getWQPData('USGS-05114000','Suspended Sediment Discharge;Suspended sediment concentration (SSC);Suspended sediment discharge', '1975-01-01', '1995-03-31')
-#' getWQPData('USGS-05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)
+#' \dontrun{getWQPData('USGS-01594440','Chloride', '', '')}
+#' \dontrun{getWQPData('USGS-05114000','Suspended Sediment Discharge;Suspended sediment concentration (SSC);Suspended sediment discharge', '1975-01-01', '1995-03-31')}
+#' \dontrun{getWQPData('USGS-05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)}
 getWQPData <- function(siteNumber,characteristicName,StartDate,EndDate,interactive=TRUE){
 
   StartDate <- formatCheckDate(StartDate, "StartDate", interactive=interactive)
diff --git a/R/retrieveUnitNWISData.r b/R/retrieveUnitNWISData.r
index 08267c39..9fb05062 100644
--- a/R/retrieveUnitNWISData.r
+++ b/R/retrieveUnitNWISData.r
@@ -17,7 +17,7 @@
 #' siteNumber <- '05114000'
 #' ParameterCd <- '00060'
 #' StartDate <- '2012-05-01'
-#' EndDate <- '2012-05-31'
+#' EndDate <- '2012-05-02'
 #' # These examples require an internet connection to run
 #' retrieveUnitNWISData(siteNumber,ParameterCd,StartDate,EndDate,interactive=FALSE)
 retrieveUnitNWISData <- function (siteNumber,ParameterCd,StartDate,EndDate,interactive=TRUE){  
diff --git a/man/getParameterInfo.Rd b/man/getParameterInfo.Rd
index e12aa52d..d3dccffd 100644
--- a/man/getParameterInfo.Rd
+++ b/man/getParameterInfo.Rd
@@ -18,9 +18,9 @@
   short name, units, and CAS registry numbers)
 }
 \description{
-  Imports data from NWIS web service concerning meaured
-  parameter based on user-supplied parameter code. This
-  function gets the data from here:
+  Imports data from NWIS about meaured parameter based on
+  user-supplied parameter code. This function gets the data
+  from here:
   \url{http://nwis.waterdata.usgs.gov/nwis/pmcodes}
 }
 \examples{
diff --git a/man/getStoretData.Rd b/man/getStoretData.Rd
index b8a5eaa7..f261d80e 100644
--- a/man/getStoretData.Rd
+++ b/man/getStoretData.Rd
@@ -41,9 +41,9 @@
 }
 \examples{
 # These examples require an internet connection to run
-getStoretData('01594440','01075', '1985-01-01', '1985-03-31')
-getStoretData('05114000','', '1985-01-01', '1985-03-31')
-getStoretData('05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)
+\dontrun{getStoretData('01594440','01075', '1985-01-01', '1985-03-31')}
+\dontrun{getStoretData('05114000','', '1985-01-01', '1985-03-31')}
+\dontrun{getStoretData('05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)}
 }
 \keyword{USGS}
 \keyword{data}
diff --git a/man/getWQPData.Rd b/man/getWQPData.Rd
index f946157b..d18d3b6a 100644
--- a/man/getWQPData.Rd
+++ b/man/getWQPData.Rd
@@ -1,6 +1,6 @@
 \name{getWQPData}
 \alias{getWQPData}
-\title{Data Import for Water Quality Portal}
+\title{Data Import from Water Quality Portal}
 \usage{
   getWQPData(siteNumber, characteristicName, StartDate,
     EndDate, interactive = TRUE)
@@ -43,9 +43,9 @@
 }
 \examples{
 # These examples require an internet connection to run
-getWQPData('USGS-01594440','Chloride', '', '')
-getWQPData('USGS-05114000','Suspended Sediment Discharge;Suspended sediment concentration (SSC);Suspended sediment discharge', '1975-01-01', '1995-03-31')
-getWQPData('USGS-05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)
+\dontrun{getWQPData('USGS-01594440','Chloride', '', '')}
+\dontrun{getWQPData('USGS-05114000','Suspended Sediment Discharge;Suspended sediment concentration (SSC);Suspended sediment discharge', '1975-01-01', '1995-03-31')}
+\dontrun{getWQPData('USGS-05114000','00915;00931', '1985-01-01', '1985-04-30', interactive=FALSE)}
 }
 \keyword{WQP}
 \keyword{data}
diff --git a/man/retrieveUnitNWISData.Rd b/man/retrieveUnitNWISData.Rd
new file mode 100644
index 00000000..a555593f
--- /dev/null
+++ b/man/retrieveUnitNWISData.Rd
@@ -0,0 +1,53 @@
+\name{retrieveUnitNWISData}
+\alias{retrieveUnitNWISData}
+\title{Data Import for Instantaneous USGS NWIS Data}
+\usage{
+  retrieveUnitNWISData(siteNumber, ParameterCd, StartDate,
+    EndDate, interactive = TRUE)
+}
+\arguments{
+  \item{siteNumber}{string USGS site number.  This is
+  usually an 8 digit number}
+
+  \item{ParameterCd}{string USGS parameter code.  This is
+  usually an 5 digit number.}
+
+  \item{StartDate}{string starting date for data retrieval
+  in the form YYYY-MM-DD.}
+
+  \item{EndDate}{string ending date for data retrieval in
+  the form YYYY-MM-DD.}
+
+  \item{StatCd}{string USGS statistic code. This is usually
+  5 digits.  Daily mean (00003) is the default.}
+
+  \item{interactive}{logical Option for interactive mode.
+  If true, there is user interaction for error handling and
+  data checks.}
+}
+\value{
+  retval dataframe with agency, site, dateTime, value, and
+  code columns
+}
+\description{
+  Imports data from NWIS web service. This function gets
+  the data from here: \url{http://waterservices.usgs.gov/}
+  A list of parameter codes can be found here:
+  \url{http://nwis.waterdata.usgs.gov/nwis/pmcodes/} A list
+  of statistic codes can be found here:
+  \url{http://nwis.waterdata.usgs.gov/nwis/help/?read_file=stat&format=table}
+}
+\examples{
+siteNumber <- '05114000'
+ParameterCd <- '00060'
+StartDate <- '2012-05-01'
+EndDate <- '2012-05-02'
+# These examples require an internet connection to run
+retrieveUnitNWISData(siteNumber,ParameterCd,StartDate,EndDate,interactive=FALSE)
+}
+\keyword{USGS}
+\keyword{data}
+\keyword{import}
+\keyword{service}
+\keyword{web}
+
-- 
GitLab