Chicago / vision-zero-dashboard

Vision Zero Dashboard
MIT License
14 stars 20 forks source link

Vision Zero Dashboard

last updated 2020-01-08

Background on Vision Zero

Vision Zero Chicago (VZC) is the commitment and approach to eliminating fatalities and serious injuries from traffic crashes. The plan emphasizes reporting and accountability in an transparent manner. To this end, the VZ committee has requested a public facing dashboard that communicates our progress toward Vision Zero goals, which can be referenced internally and externally.

Much more information is available in the Action Plan, and the City’s website: https://www.chicago.gov/city/en/depts/cdot/supp_info/vision-zero-chicago.html

The Vision Zero Dashboard

The purpose of the proposed dashboard is to help Vision Zero Chicago achieve its mission, and increase transparency and accountability.

There are a wide variety of ways this information could be communicated, and technologies that could be used. We feel that it would be best to begin with open source software and open data. The most relevant data that we would want to communicate is already publicly available on the open data portal: https://data.cityofchicago.org/Transportation/Traffic-Crashes-Crashes/85ca-t3if

The data sets include crash, vehicle, and person information reported into our eCrash system. These data sets are updated daily.

We are also working with IDOT to determine how we can incorporate data for prior years so that we can accurately measure progress toward goals, and identify trends.

Example dashboard elements:

Examples of dashboards from other cities, and Illinois:

More detail and documentation here: resources/example_dashboards.md

How to get involved!

We meet at Chi Hack Night, which is a free weekly event here in Chicago. To learn more and register visit www.chihacknight.org

We have a "vision-zero-dashboard" slack channel in the chihacknight slack, which can join here: http://slackme.chihacknight.org

Please use github issues for any discussion related to devleopment, or just general discussion about contributions.

Technical requirements

Note: you are welcome to participate without making any technical contributions.

However, if you want run the code in this repo you will need to:

  1. Download [R] (https://www.r-project.org/) (please see the presentation from Nov 2019 for details if you're unsure how)
  2. Download R Studio
  3. Open the vision zero project (the file called "vision-zero-dashboard.Rproj")
  4. Install packages as needed. Note, the geneorama package is only for convenience.

Contribution requirements

To make code contributions (i.e. submit any files to the project) please follow this pattern: fork, clone, add, commit, push. More documentation in resources/git_fork_management. Note, branching is optional.

For best results, please let issues guide your contributions! If the pull request is well documented, discussed, and agreed upon within an issue, then it's much easier to accept into the master branch.

The main thing we need at this point are examples of relationships and visualizations that could become components of a dashboard.

Technical details and quick start guides

Please refer to the resources/ folder for examples.

Important reminder about IDOT crash / person / vehicle data: Please use to the metadata to understand the fields, and please note the readme on how to document your use of the data.

To install geneorama please use devtools, devtools::install_github("geneorama/geneorama")

About the Chicago R User Group and Shiny

This project was started to support a hackathon hosted through the Chicago R User Group. You can learn more about it here: https://www.meetup.com/Chicago-R-User-Group/

The CRUG Organization is focused on R, which is an open source language with broad application and compatibility with other technology. The open source software company R Studio has developed a library that works with R to create modern, secure, websites.

You can learn more about the web development software, and view examples here: https://shiny.rstudio.com https://shiny.rstudio.com/gallery/

City Seal of Chicago