Thank you for visiting the vancrime dashboard project repository. This repository hosts the dashboard for the Vancouver (Canada) crime data released by the Vancouver Police Department (VPD).
You can find the original data here. This information, which spans 2003 through 2022, is public domain and is licensed under CC0.
This README file serves as a central location for the project's documentation. You may either go directly to a subsection of interest or continue reading to learn more.
This is a dashboard application that helps users and interested parties visualize Vancouver crime data, publicly released by the Vancouver Police Department (VPD). The information will be arranged in a manner that takes into account the different types of criminal behavior, as well as the time periods and neighbourhoods involved. It is important to note that the purpose of this dashboard is not to label any specific area of Vancouver with a negative connotation, but rather to educate. For a detailed description of the motivation, description, and usage scenarios, please visit Proposal.
The program follows a conventional dashboard layout in which the user can select or specify the scope of what they need to visualize on the left side, and a set of relevant visualization components that update in response to the user's selection criteria on the right.
Here's a link to the live application if you like to check it out.
This dashboard application includes the following selection/filtering mechanisms:
This dashboard has the following visualizations:
Anyone interested in helping us improve this dashboard and take on some of the following tasks are especially welcome to get in touch. Areas that I am interested in improving are:
I love to have you contribute to this dashboard, and the next section will help you get started with that and guide you through the setup.
Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms. Before you get started, I recommend you take a look at Dash from plotly which was used to scaffold and build this application.
To setup your development environment to contribute to VanCrime please follow these instructions below:
Clone this repository and create a development branch
$ git switch -c name-of-your-contributing-branch
Install the required Python packages. For your convenience I have included both the requirements.txt and environment.yml files if you prefere to use conda.
$ conda env create -f environment.yml
Using your favorite IDE (recommending VSCode) got to app.py
in the root directory and execute it. This step depends on your the type of IDE you have used. In its simplest forms, this step boils down to invoking the python interpreter in an environment that has all the needed dependencies (see step 2.)
$ python app.py
Congratulations, you are now able to develop and contribute to the VanCrime dashboard application.
VanCrime
was created by Tony Zoght. It is licensed under the terms of the MIT license.