theodoreback / envreportutils

An R package with ggplot2 themes & other functions related to Environmental Reporting BC work flows

envreportutils

Overview

An R package with ggplot2 themes and other functions commonly used by the Environmental Reporting BC team when developing environmental reporting indicators and related products.

Features

Currently there are six main functions:

• theme_soe() - default ggplot2 theme for Environmental Reporting BC graphs
• theme_soe_facet() - default ggplot2 theme for Environmental Reporting BC graphs using facetting
• multiplot() - combine multiple ggplot2 plots into one (this function is deprecated, see the cowplot package for the same functionality)
• bgc_colours() - get colour codes for B.C. Biogeoclimatic (BGC) Zones
• get_data_licence() - get the url, or a markdown or html-formatted link to one of several B.C. or Canadian licences
• order_df() - order a data frame using summary of a specified column or specify the order manually (this function is deprecated, see forcats::fct_reorder for the same functionality)

The package also installs an RStudio Addin for adding a custom footer to READMEs for projects maintained by Environmental Reporting BC.

Installation

You can install the package directly from this repository. To do so, you will need the devtools package:

install.packages("devtools")

Next, install the envreportutils package using devtools::install_github():

library("devtools")
install_github("bcgov/envreportutils")

Project Status

This package is under continual development.

Getting Help or Reporting an Issue

To report bugs/issues/feature requests, please file an issue.

How to Contribute

If you would like to contribute to the package, please see our CONTRIBUTING guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

Copyright 2015 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.

This repository is maintained by Environmental Reporting BC. Click here for a complete list of our repositories on GitHub.