Skip to content
This repository has been archived by the owner on Jan 30, 2024. It is now read-only.

Commit

Permalink
prep for archival
Browse files Browse the repository at this point in the history
  • Loading branch information
jsta committed Jan 30, 2024
1 parent 64d313a commit 30608b5
Show file tree
Hide file tree
Showing 2 changed files with 123 additions and 117 deletions.
119 changes: 119 additions & 0 deletions README-OLD.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,119 @@

<!-- README.md is generated from README.Rmd. Please edit that file -->

![](https://github.com/ropensci/dbhydroR/raw/master/inst/images/profile.png)

# Programmatic access to the South Florida Water Management District’s [DBHYDRO database](https://www.sfwmd.gov/science-data/dbhydro)

[![Project Status: Active - The project has reached a stable, usable
state and is being actively
developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![R-CMD-check](https://github.com/ropensci/dbhydroR/workflows/R-CMD-check/badge.svg)](https://github.com/ropensci/dbhydroR/actions)
[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/dbhydroR)](https://cran.r-project.org/package=dbhydroR)
[![](https://badges.ropensci.org/61_status.svg)](https://github.com/ropensci/software-review/issues/61)
[![DOI](https://zenodo.org/badge/64503356.svg)](https://zenodo.org/badge/latestdoi/64503356)

`dbhydroR` provides scripted access to the South Florida Water
Management District’s DBHYDRO database which holds over 35 million
hydrologic and water quality records from the Florida Everglades and
surrounding areas.

## Installation

### Stable version from CRAN

`install.packages("dbhydroR")`

### or development version from Github

`install.packages("devtools") # Requires RTools if using Windows`

`devtools::install_github("ropensci/dbhydroR")`

## Usage

### Load dbhydroR

`library("dbhydroR")`

### Water Quality Data

Station IDs and date ranges can be viewed in the [Environmental
Monitoring Location
Maps](https://www.sfwmd.gov/documents-by-tag/emmaps). Test names can be
viewed in the Data Types Metadata Table on the DBHYDRO website.

#### One variable at one station

get_wq(station_id = "FLAB08", date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### One variable at multiple stations

get_wq(station_id = c("FLAB08","FLAB09"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### One variable at a wildcard station

get_wq(station_id = c("FLAB0%"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### Multiple variables at multiple stations

get_wq(station_id = c("FLAB08","FLAB09"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = c("CHLOROPHYLL-A, SALINE",
"SALINITY"))

#### Operate on raw data

raw_data <- get_wq(station_id = "FLAB08", date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE", raw = TRUE)

clean_wq(raw_data)

### Hydrologic data

Station IDs and date ranges can be viewed in the [Environmental
Monitoring Location
Maps](https://www.sfwmd.gov/documents-by-tag/emmaps).

#### Identify unique time series (dbkeys) before-hand

get_dbkey(stationid = "C111%", stat = 'MEAN', category = "WQ", detail.level = "full")
get_hydro(dbkey = 38104, date_min = "2009-01-01", date_max = "2009-01-12")

#### Pass station info on-the-fly

get_hydro(date_min = "2013-01-01", date_max = "2013-02-02",
stationid = "JBTS", category = "WEATHER", param = "WNDS",
freq = "DA", stat = "MEAN", recorder = "CR10", agency = "WMD")

#### Operate on raw data

raw_data <- get_hydro(date_min = "2013-01-01", date_max = "2013-02-02",
stationid = "JBTS", category = "WEATHER", param = "WNDS",
freq = "DA", stat = "MEAN", recorder = "CR10", agency = "WMD", raw = TRUE)
clean_hydro(raw_data)

## References

`vignette("dbhydroR", package = "dbhydroR")`

[DBHYDRO User’s
Guide](https://www.sfwmd.gov/sites/default/files/documents/dbhydrobrowseruserdocumentation.pdf)

## Meta

- Please [report any issues or
bugs](https://github.com/ropensci/dbhydroR/issues).

- Get citation information for `dbhydroR` in R by running
`citation(package = 'dbhydroR')`

- Please note that this project is released with a [Contributor Code
of
Conduct](https://github.com/ropensci/dbhydroR/blob/master/CONDUCT.md).
By participating in this project you agree to abide by its terms

[![ropensci\_footer](https://ropensci.org/public_images/github_footer.png)](https://ropensci.org)
121 changes: 4 additions & 117 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,119 +1,6 @@
# dbhydroR

<!-- README.md is generated from README.Rmd. Please edit that file -->
[![Project Status: Unsupported](https://www.repostatus.org/badges/latest/unsupported.svg)](https://www.repostatus.org/#unsupported)
[![Peer-review badge](https://badges.ropensci.org/61_status.svg)](https://github.com/ropensci/software-review/issues/61)

![](https://github.com/ropensci/dbhydroR/raw/master/inst/images/profile.png)

# Programmatic access to the South Florida Water Management District’s [DBHYDRO database](https://www.sfwmd.gov/science-data/dbhydro)

[![Project Status: Active - The project has reached a stable, usable
state and is being actively
developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)
[![R-CMD-check](https://github.com/ropensci/dbhydroR/workflows/R-CMD-check/badge.svg)](https://github.com/ropensci/dbhydroR/actions)
[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/dbhydroR)](https://cran.r-project.org/package=dbhydroR)
[![](https://badges.ropensci.org/61_status.svg)](https://github.com/ropensci/software-review/issues/61)
[![DOI](https://zenodo.org/badge/64503356.svg)](https://zenodo.org/badge/latestdoi/64503356)

`dbhydroR` provides scripted access to the South Florida Water
Management District’s DBHYDRO database which holds over 35 million
hydrologic and water quality records from the Florida Everglades and
surrounding areas.

## Installation

### Stable version from CRAN

`install.packages("dbhydroR")`

### or development version from Github

`install.packages("devtools") # Requires RTools if using Windows`

`devtools::install_github("ropensci/dbhydroR")`

## Usage

### Load dbhydroR

`library("dbhydroR")`

### Water Quality Data

Station IDs and date ranges can be viewed in the [Environmental
Monitoring Location
Maps](https://www.sfwmd.gov/documents-by-tag/emmaps). Test names can be
viewed in the Data Types Metadata Table on the DBHYDRO website.

#### One variable at one station

get_wq(station_id = "FLAB08", date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### One variable at multiple stations

get_wq(station_id = c("FLAB08","FLAB09"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### One variable at a wildcard station

get_wq(station_id = c("FLAB0%"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE")

#### Multiple variables at multiple stations

get_wq(station_id = c("FLAB08","FLAB09"), date_min = "2011-03-01",
date_max = "2012-05-01", test_name = c("CHLOROPHYLL-A, SALINE",
"SALINITY"))

#### Operate on raw data

raw_data <- get_wq(station_id = "FLAB08", date_min = "2011-03-01",
date_max = "2012-05-01", test_name = "CHLOROPHYLL-A, SALINE", raw = TRUE)

clean_wq(raw_data)

### Hydrologic data

Station IDs and date ranges can be viewed in the [Environmental
Monitoring Location
Maps](https://www.sfwmd.gov/documents-by-tag/emmaps).

#### Identify unique time series (dbkeys) before-hand

get_dbkey(stationid = "C111%", stat = 'MEAN', category = "WQ", detail.level = "full")
get_hydro(dbkey = 38104, date_min = "2009-01-01", date_max = "2009-01-12")

#### Pass station info on-the-fly

get_hydro(date_min = "2013-01-01", date_max = "2013-02-02",
stationid = "JBTS", category = "WEATHER", param = "WNDS",
freq = "DA", stat = "MEAN", recorder = "CR10", agency = "WMD")

#### Operate on raw data

raw_data <- get_hydro(date_min = "2013-01-01", date_max = "2013-02-02",
stationid = "JBTS", category = "WEATHER", param = "WNDS",
freq = "DA", stat = "MEAN", recorder = "CR10", agency = "WMD", raw = TRUE)
clean_hydro(raw_data)

## References

`vignette("dbhydroR", package = "dbhydroR")`

[DBHYDRO User’s
Guide](https://www.sfwmd.gov/sites/default/files/documents/dbhydrobrowseruserdocumentation.pdf)

## Meta

- Please [report any issues or
bugs](https://github.com/ropensci/dbhydroR/issues).

- Get citation information for `dbhydroR` in R by running
`citation(package = 'dbhydroR')`

- Please note that this project is released with a [Contributor Code
of
Conduct](https://github.com/ropensci/dbhydroR/blob/master/CONDUCT.md).
By participating in this project you agree to abide by its terms

[![ropensci\_footer](https://ropensci.org/public_images/github_footer.png)](https://ropensci.org)
This package has been archived. The former README is now in [README-old](README-OLD.md).

0 comments on commit 30608b5

Please sign in to comment.