Campus Living Lab Green Stormwater Infrastructure Dashboard

About This Dashboard

The GSI Living Lab dashboard displays micro meteorological data for three GSI features at the University of Arizona. Environmental variables include temperature, relative humidity, and precipitation. Soil moisture and temperature data are also collected at each site and displayed on the dashboard. Environmental models of plant available water, evapotranspiration, and human perceived temperature using heat index and wind chill factors. gsi-dashboard

How does it work?

The gsi-wrangling-workflow repository houses gsi_wrangling.Rmd which is published to Posit Connect as a scheduled workflow running daily at noon. This .Rmd file contains code to pull the most recent data for the Campus Living Lab sites from ZentraCloud, wrangle the data, and append it to a .csv file stored on Box. The gsi-dashboard repository (this one) contains code for a Shiny app that is automatically deployed to Posit Connect (using GitHub Actions) when updates are made to the main branch. This Shiny app reads in the data from Box on start-up and provides interactive visualizations of the data.

Contributing

To get this app working locally, you will need to create a .Renviron file with the environment variable BOX_TOKEN_TEXT with the contents of a authorization token for a the Box service app used to read data in from Box.

To contribute to this project, please create a new branch for your changes and make a pull request. One easy way to do this from within R is with the usethis package and the pr_* functions. pr_init("branch-name") begins a new branch locally, pr_push() helps you create a new pull request, and after it is merged you can use pr_finish() to clean things up. More about this workflow here.

renv

This project uses renv for package management. When opening this repo as an RStudio Project for the first time, renv should automatically install itself and prompt you to run renv::restore() to install all package dependencies.

Shiny app structure

The content and layout of the dashboard is defined in app/app.R. Custom functions used (e.g. to create plots) follow the form gsi_*() and are defined in scripts in the app/R/ directory.

To learn more about Shiny and the bslib package (used to define the UI of the dashboard), see these resources:

• Welcome to Shiny
• Mastering Shiny
• bslib

Modifying plot theme

The theme for all of the ggplot2 plots in the dashboard is controlled by R/0-theme_gsi.R. (the filename starts with '0' because the files are sourced alphabetically and the theme is used by all the other functions in R/).

Notes

Two sensors at Old Main were plugged into incorrect ports upon installation. On December 11, 2024, these sensors switched logger ports. Plugs for port 3 and 5 were switched on the Old Main z6-19485 logger. This fixed the port and location pairing to match the actual location of each sensor. See site_info.csv for information on how to correct for pre-December 2024 data during analysis.

Deployment

This app is published to https://viz.datascience.arizona.edu/gsi-dashboard/ automatically by a GitHub action whenever changes are made to the main branch of this repository. If changes are not being reflected on the deployed app or there are other issues with the live app, please contact \@cct-datascience.

Citation

If you use this code, please cite as follows:

Scott, E. R., Barrios, M. J., Riemer, K., & Buzzard, V. Campus Living Lab Green Stormwater Infrastructure Dashboard (Version 0.1.0) [Computer software]. https://doi.org/10.5281/zenodo.10736077

Developed in collaboration with the University of Arizona CCT Data Science team