HASP

Hydrologic AnalySis Package.
https://github.com/DOI-USGS/HASP

Category: Natural Resources
Sub Category: Water Supply and Quality

Keywords

groundwater groundwater-level r r-package rstats

Keywords from Contributors

aims marine sst weather

Last synced: about 12 hours ago
JSON representation

Repository metadata

Hydrologic AnalySis Package. See official source code: https://doi-usgs.github.io/HASP/

• Host: GitHub
• URL: https://github.com/DOI-USGS/HASP
• Owner: DOI-USGS
• License: other
• Created: 2020-04-15T12:58:27.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-07-25T20:14:37.000Z (9 months ago)
• Last Synced: 2025-04-19T18:17:53.231Z (7 days ago)
• Topics: groundwater, groundwater-level, r, r-package, rstats
• Language: R
• Homepage: https://doi-usgs.github.io/HASP/
• Size: 77.3 MB
• Stars: 17
• Watchers: 6
• Forks: 2
• Open Issues: 1
• Releases: 0
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS
  • License: LICENSE.md

README.Rmd

          ---
title: "README"
output:
  md_document:
    variant: gfm
editor_options: 
  chunk_output_type: console
---

```{r, echo = FALSE}
knitr::opts_chunk$set(echo = TRUE,
                      warning = FALSE,
                      message = FALSE,
                      fig.width = 7,
                      fig.height = 5,
                      collapse = TRUE,
                      comment = "#>",
                      fig.path = "man/figures/README-"
)
```

# HASP: Hydrologic AnalySis Package 

[![R build status](https://code.usgs.gov/water/stats/hasp/badges/main/pipeline.svg)](https://code.usgs.gov/water/stats/hasp/pipelines)
[![status](https://img.shields.io/badge/USGS-Documentation-blue.svg)](https://rconnect.usgs.gov/HASP_docs/)
[![status](https://img.shields.io/badge/USGS-Source-orange.svg)](https://code.usgs.gov/water/stats/hasp)
[![status](https://img.shields.io/badge/Release-Full-blue.svg)](https://code.usgs.gov/water/stats/hasp/-/tree/1.0.0)

*H*ydrologic *A*naly*S*is *P*ackage

The [Hydrologic Analysis Package (HASP)](https://code.usgs.gov/water/stats/hasp) can retrieve groundwater level and groundwater quality data, aggregate these data, plot them, and generate basic statistics. One of the benefits of HASP is its ability to aggregate two time-series of data into one record and generate statistics and graphics on that record. By merging two data sets together, users can view and manipulate a much longer record of data. Users can download the aggregated record and see basic statistics that have been calculated with these data. HASP also allows users to plot groundwater level trends in major aquifers as well. The explore_aquifers function allows users to pull data from wells classified in Principal Aquifers and synthesize water-level data to better understand trends.

Inspiration:
https://fl.water.usgs.gov/mapper/

See [https://rconnect.usgs.gov/HASP_docs/](https://rconnect.usgs.gov/HASP_docs/) for more information! 

## Installation of HASP

You can install the `HASP` package using the `remotes` package.

To install the remotes package, copy the following line into R or the "Console" window in RStudio:

```{r installRemotes, eval = FALSE}
install.packages("remotes")
```

To install the `HASP` package:

```{r install, eval=FALSE}
remotes::install_gitlab("water/stats/hasp",
                        host = "code.usgs.gov",
                        build_opts = c("--no-resave-data",
                                       "--no-manual"),
                        build_vignettes = TRUE, 
                        dependencies = TRUE)
```

During this installation, you may be prompted to update or install some packages. Press 3 to skip the updates, but don't forget to update all of your packages later.

## Sample workflow

### Get groundwater data:
```{r singleSiteShow, echo=TRUE, eval=TRUE}
library(HASP)
library(dataRetrieval)
site <- "263819081585801"

#Field GWL data:
gwl_data <- dataRetrieval::readNWISgwl(site)

# Daily data:
parameterCd <- "62610"
statCd <- "00001"
dv <- dataRetrieval::readNWISdv(site,
                                parameterCd,
                                statCd = statCd)




```

### Plot data:

```{r graphs, echo=TRUE, eval=TRUE}

y_axis_label <- readNWISpCode(parameterCd)$parameter_nm
title <- readNWISsite(site)$station_nm

monthly_frequency_plot(dv,
                       gwl_data,
                       parameter_cd = parameterCd,
                       plot_title = title,
                       y_axis_label = y_axis_label)

weekly_frequency_plot(dv, 
                      gwl_data,
                      parameter_cd = parameterCd, 
                      stat_cd = statCd,
                      plot_title = title,
                      y_axis_label = y_axis_label)

daily_gwl_plot(dv, 
               gwl_data,
               parameter_cd = parameterCd,
               plot_title = title,
               stat_cd = statCd,
               y_axis_label = y_axis_label)

gwl_plot_all(gw_level_dv = dv, 
             gwl_data = gwl_data, 
             parameter_cd = parameterCd,
             plot_title = title, 
             add_trend = TRUE)


```

## Create Groundwater Report:

```{r eval=FALSE}
create_groundwater_report(siteID = site,
                          report_name = "L_2701",
                          report_folder = "reports",
                          output_type = "html")
```

Running this function will create an Rmarkdown file (Rmd). In RStudio, clicking the button "Knit" at the top of the file will render the Rmd file as either an HTML or Word document.

## Water-quality plots

HASP also includes a few water-quality plot options.

```{r}
# Water Quality data:

qw_data <- readWQPqw(paste0("USGS-", site),
                     c("Chloride",
                       "Specific conductance"))

qw_plot(qw_data, CharacteristicName = "Chloride",
        plot_title = title)

Sc_Cl_plot(qw_data, plot_title = title)


```


### Composite workflows:

More information on the composite aquifer workflow can be found `vignette("Priniciple_Aquifers", package = "HASP")`.

```{r example}

#included sample data:

aquifer_data <- aquifer_data
num_years <- 30

plot_composite_data(aquifer_data, num_years)

plot_normalized_data(aquifer_data, num_years)
```

## Citing HASP


```{r cite}
citation(package = "HASP")
```

## Running the apps

`HASP` includes two interactive applications as a way to explore the functionality of this package. One has functions for exploring data from a single site, and the other has functions for exploring data from an aquifer. 

For more information see `vignette("shinyApp", package = "HASP")`.
  
To run the single site application, use the following code:  

```{r runSingleSiteApp, eval = FALSE}
HASP::explore_site()
```

To run the aquifer application use the following code:

```{r runAquiferApp, eval = FALSE}
HASP::explore_aquifers()
```

## Disclaimer

This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software.

Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.


        

---

Owner metadata

• Name: U.S. Geological Survey
• Login: DOI-USGS
• Email: [email protected]
• Kind: organization
• Description: By integrating our diverse scientific expertise, we understand complex natural science phenomena and provide scientific products that lead to solutions.
• Website: https://www.usgs.gov/
• Location: United States of America
• Twitter: USGS
• Company:
• Icon url: https://avatars.githubusercontent.com/u/65027635?v=4
• Repositories: 59
• Last ynced at: 2023-06-11T08:40:17.441Z
• Profile URL: https://github.com/DOI-USGS

---

GitHub Events

Total

• Watch event: 1

Last Year

• Watch event: 1

---

Committers metadata

Last synced: 7 days ago

Name	Email	Commits
DeCicco	l****o@u****v	377
Patrick Eslick	p****k@u****v	18
elbeejay	j****n@u****v	14
runner	r****r@M****l	3
Faunce, Kaycee Elizabeth	k****e@u****v	2
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1
runner	r****r@M****l	1

Committer domains:

• usgs.gov: 4

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/DOI-USGS/HASP

---

---

---

Dependencies

Score: 6.109247582764365