/CCISS_ShinyApp

CCISS RMD knitr report graphics and Shiny App

Primary LanguageRApache License 2.0Apache-2.0

Welcome to CCISS!

Lifecycle:Maturing

This is the main github repo for the CCISS web tool.

What is CCISS?

Climate Change Informed Species Selection (CCISS – pronounced ‘kiss’) is a Biogeoclimatic Ecosystem Classification-based analysis framework built to anticipate the change climate implications to tree species environmental suitability at a site specific level. The CCISS tool is a web-based application that makes this analysis accessible to practitioners to help guide climate change adaptation in reforestation decisions.

Understanding climate- and site-level species suitability is one of the foundational pieces of information that practitioners require for the creation of silvicultural prescriptions that will lead to successful reforestation over a rotation period. Climate change will affect this goal by progressively altering environmental conditions and therefore the suitability of tree species established on a site over time.

To address this challenge, the CCISS tool projects changes to species environmental suitability at a site series level for any user selected location in the province and estimates the future suitability of a tree species to this changing climate. To account for future climate uncertainty the tool looks at a wide range of global climate change models and emissions scenarios to capture the range of plausible climate futures for any location in BC in 20-year periods out to 2100.

To assist users, the tool compares the current species selection guidance in the Chief Foresters Reference Guide with the future forecast from the CCISS analysis. Reports from the tool highlight where currently acceptable species are stable/improving or declining/unsuitable and where new species have become suitable and could be considered as candidates for assisted migration.

Usage

Install shiny

install.packages("shiny")

Run locally

  • Clone repository
  • Setup environment variables
  • Open project
  • Run shiny::runApp("./app")

.Renviron

The app requires the following environment variables.

BCGOV_USR={postgres user}
BCGOV_PWD={postgres password}
BCGOV_DB={postgres database}
BCGOV_HOST={postgres host}
BCGOV_TILESERVER={tileserver gl x, y, z url template}
BCGOV_TILELAYER={tileserver layer}
BCGOV_MAPBOX_TOKEN={mapbox api key}
BCGOV_MAPBOX_LABELS_STYLE={mapbox labels style ref user/styleref}
BCGOV_MAPBOX_HILLSHADE_STYLE={mapbox hillshade style ref user/styleref}

Repository structure

R packages folders

Special

.gitignore

Tells git which files to ignore. See git documentation.

.Rbuildignore

Tells R which files to ignore when it builds the package. See Writing R extension.

.github

Github actions workflows.

  • Package checks (R-CMD-check)
  • Online documentation (pkgdown),
  • Tests coverages report (test-coverage)
  • Style code / run roxygen2 (pr-commands) You can read more about actions from r-lib/actions

Workflows are setup or updated with the following instruction.

usethis::use_tidy_github_actions()

Custom modifications made.

  • Reduce the number of target for R CMD check.

To disable a workflow, go the github actions tab, select a workflow, click on the ... dots on the right and select disable workflow.


Copyright 2021 Province of British Columbia

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.