Thank you for visiting the pyVanCrime
app project repository. This repository hosts the dashboard for the Vancouver (Canada) crime data released by the Vancouver Police Department (VPD). 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 Dash app for the Data Visualization II individual project.
In a nutshell, 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.
There are four visulization components in total:
User can make use of the widgets on the left to narrow down the scope of search:
Select All
button allows user to select all Neighbourhood in one go.Anyone interested in improving this dashboard and take on some of the following tasks are especially welcome to get in touch. Areas for improvments are:
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.
To setup your development environment to contribute to pyVanCrime
please follow these instructions below:
Clone this repository and create a development branch
$ git switch -c name-of-your-contributing-branch
Open app.py
under the src
folder with an IDE such as Jupyter Lab or Visual Studio Code.
You're almost there. After editing app.py
, type python app.py
in a command prompt.
Copy the link shown on the command prompt. (in this example, it is http://127.0.0.1:8050/
)
Dash is running on http://127.0.0.1:8050/
* Serving Flask app 'app' (lazy loading)
* Environment: production
...
Paste the link to a browser. This will launch pyVanCrime
app
Congratulations, you are now able to develop and contribute to the pyVanCrime
dashboard application.
pyVanCrime
was created by Markus Nam. It is licensed under the terms of the MIT license.