README.md

R-CMD-check

About

midasdashboard is a Shiny App to browse the microbial community of activated sludge and anaerobic digesters of (mostly) Danish waste water treatment plants. Live at https://eb-aau.shinyapps.io/midasdashboard/.

Usage

Clone the repository, then run devtools::load_all() and run_app().

The login is MiDAS2017 and password spildevand

How to update the app (developers)

git submodules

The amplicon data used in this app is included directly from cmc-aau/amplicon_data and cmc-aau/midas_onlinekontrol as git submodules. To include the data make sure to clone this repository recursively. To do so you must have your git credentials for your github account set up correctly because of private repositories. If you have already cloned this repository non-recursively, i.e. without including submodules, use git submodule update --init --recursive or use whatever GUI you normally do. To update submodules use git submodule foreach git pull.

R package development

The app is an R package, so remember to reinstall it with fx devtools::install_local(). If you just want to test changes before publishing the app you can load the local development package directly into memory without installing it using devtools::load_all() and then launch app with midasdashboard::run_app(). Set options(testmode = TRUE) to avoid constantly typing the login+password.

Publishing app

When happy with the changes commit and push them to github and pull them to the hosting server (/root/shinyserver/apps/midasdashboard), then run docker exec -it shiny-server R --slave -e "devtools::install_local('/srv/shiny-server/midasdashboard', Ncpus = 8)" to install the new version, followed by docker restart shiny-sever. If the app is hosted on shinyapps.io retrieve a token through shinyapps.io/admin, follow the instructions, and then ONLY upload the following files/folders:

.Rbuildignore
app.R
DESCRIPTION
NAMESPACE
data/
inst/
R/

If some packages fail to install try running devtools::install() before publishing.



cmc-aau/midasdashboard documentation built on Jan. 29, 2024, 1:42 p.m.