Chapter 55 Interactive Visualization

The Massachusetts Opioid Epidemic: a Data Visualization of Findings from the Chapter 55 Report. Visit Mass.gov/Chapter55.

This repository contains code and assets for an online, interactive visualization of the Chapter 55 Report, an unprecedented data analysis of the opioid epidemic in Massachusetts. The report was a product of Chapter 55 of the Acts of 2015 signed into law by Governor Charlie Baker in August 2015.

Setup Local Environment

Requirements

To run the server, you'll need Node.js installed.

Build the server and the front-end

0. Clone the repo from Github by using the command line or repo's website on Github. On the right side of the repo's page, there is a button labeled "Clone in Desktop"

1. Run npm install from the root of the repository to load modules and install Gulp dependencies

2. Run gulp from the root of the repository to build the project and get it to run. This will set up browser-sync to run when front-end files change and will set up the server to reload on any file change

$ git clone [email protected]:massgov/chapter55.git
$ cd chapter55
$ npm install
$ gulp

Collaboration

To collaborate or contribute to this repo, instead of directly cloning from [email protected]:massgov/chapter55.git, we encourage contributors to:

0. Fork this repo to their own github account using the "Fork" button at the top right
1. Clone the repo from their own account $ git clone [email protected]:USERNAME/chapter55.git
2. Submit a pull request when the code is ready

Licenses and attribution

A few parts of this project are not in the public domain

The files in fonts/ are from Boostrap Glyphicons by Jan Kovařík under the MIT license

The files js/vendor/bootstrap.js and css/bootstrap.css are from Boostrap, copyright Twitter under the MIT license

The file js/vendor/video.js is modified from the Accessible HTML5 Video Player by the Paypal Accessibility Team, copyright PayPal under the BSD license

The file js/vendor/d3.min.js is from D3, copyright Mike Bostock under the MIT license

The file js/vendor/d3.tip.js is from D3-tip, copyright Justin Palmer under the MIT license

The file js/vendor/colorbrewer.js is from Colorbrewer 2.0 by Cynthia Brewer

The file js/vendor/angular.min.js is from AngularJS, copyright Google, Inc. under the MIT license

The file js/vendor/modernizr.js is from Modernizr under the MIT license.

The file js/vendor/jquery-1.11.1.min.js is from jQuery, copyright The jQuery Foundation, under the MIT license

The files js/vendor/jquery-ui.js and css/jquery-ui.css are from jQueryUI, copyright The jQuery Foundation, under the MIT license

The files in assets/img and video/opioid.mp4 are licensed by MassIT from Shutterstock, and are non-transferable according to Shutterstock visual content licenses

The rest of this project is in the public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.