{"id":14067556,"url":"https://github.com/bcgov/shinyrems","last_synced_at":"2025-07-30T02:30:43.246Z","repository":{"id":43703230,"uuid":"175714992","full_name":"bcgov/shinyrems","owner":"bcgov","description":"An R package to launch shinyrems; an online application that allows a user to access, download, clean, plot and calculate simple statistics using data from the B.C. government Environmental Monitoring System database. ","archived":false,"fork":false,"pushed_at":"2023-11-27T22:18:23.000Z","size":122619,"stargazers_count":18,"open_issues_count":7,"forks_count":4,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-12-16T17:15:27.994Z","etag":null,"topics":["data-analysis","environment","environmental-data","water-quality"],"latest_commit_sha":null,"homepage":"https://bcgov.github.io/shinyrems/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bcgov.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-03-14T23:25:14.000Z","updated_at":"2024-07-15T22:14:20.000Z","dependencies_parsed_at":"2024-02-19T19:15:56.706Z","dependency_job_id":"d1b1b374-262c-4bc3-8d91-128229c130a5","html_url":"https://github.com/bcgov/shinyrems","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bcgov/shinyrems","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fshinyrems","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fshinyrems/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fshinyrems/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fshinyrems/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bcgov","download_url":"https://codeload.github.com/bcgov/shinyrems/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bcgov%2Fshinyrems/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267798625,"owners_count":24145727,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-analysis","environment","environmental-data","water-quality"],"created_at":"2024-08-13T07:05:39.649Z","updated_at":"2025-07-30T02:30:41.897Z","avatar_url":"https://github.com/bcgov.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r setup, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# shinyrems\n\n\u003c!-- badges: start --\u003e\n[![img](https://img.shields.io/badge/Lifecycle-Maturing-007EC6)](https://github.com/bcgov/repomountie/blob/master/doc/lifecycle-badges.md)\n[![Apache license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\u003c!-- badges: end --\u003e\n\n`shinyrems` is an app that allows you to download, clean, visualize and analyze data from the Environmental Monitoring System (EMS) database. Create plots and view water quality data with BC aquatic life water quality guidelines. \n\n## Installation\n\nTo install the latest development version from [GitHub](https://github.com/bcgov/shinyrems)\n``` r\n# install.packages(\"remotes\")\nremotes::install_github(\"bcgov/rems\")\nremotes::install_github(\"bcgov/wqbc\")\nremotes::install_github(\"bcgov/shinyrems\")\n```\n\nPlease remember to restart your R session after installation.\n\n## Usage\nSee the [User Guide](https://bcgov.github.io/shinyrems/articles/shinyrems.html) for a more detailed explanation of app usage. \n\nShinyRems app can be run with various EMS datasets that must be downloaded and stored on the user's computer. Prior to app startup, you will be prompted to download data if required and you will be notified if data updates are available.\n\nThere are six possible run modes corresponding to different \ndatasets:\n\n- **'demo'** - uses a demo dataset that requires no download of EMS data  \n- **'2yr'** - uses most recent 2 years of EMS data\n- **'4yr'** - uses most recent 4 years of EMS data \n- **'historic'** - uses historic EMS data (1965 - (Current Year - 2 Years))\n- **'all'** - uses combined \"2yr\" and \"historic\" EMS data \n- **'upload'** - allows user to upload their own data following correct format \n\nTo select a run mode, provide the value (as it appears above) to `shinyrems::run_ems_app()`. For example, type the following into your R console:\n\n```{r, eval = FALSE}\n# select historic run mode\nshinyrems::run_ems_app(\"historic\")\n\n# select upload run mode\nshinyrems::run_ems_app(\"upload\")\n\n# \"2yr\" run mode is the default and will be selected if no other value is provided\nshinyrems::run_ems_app()\n```\n\n## Contribution\n\nPlease report any [issues](https://github.com/bcgov/shinyrems/issues).\n\n[Pull requests](https://github.com/bcgov/shinyrems/pulls) are always welcome.\n\nPlease note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). \nBy participating in this project you agree to abide by its terms.\n\n## License\n\n    Copyright 2019 Province of British Columbia\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at \n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcgov%2Fshinyrems","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbcgov%2Fshinyrems","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbcgov%2Fshinyrems/lists"}