Heroku: https://dash-app-murder.herokuapp.com
Organization Link: https://github.com/DahboardTeam/HomicideDashboard
First and foremost, Welcome! 🎉🎈🎈🎈
Thank you for visiting the Watch out for homicides app project repository.
This document (README file) is a hub to provide you with some information about the project. Jump directly to one of the sections below, or scroll straight down to find out more.
- Who are we?
- What is our ideal project?
- What are we doing?
- What does our package include?
- How to use our project?
- How can you get involved?
- Get in touch
- Group members: Yuxin Chen 😉 & Siyue Gao 😊 & Xinyu Dong 😁 & Matthew Yau 😏
There will be four tabs in total to depict the homicide cases data in America: geographical distribution, Rose chart breaking down by season and month, the direction of crimes among different race and gender groups with a Sankey graph, and the trend line graph by gender over time.
The first tab is designed to mainly demonstrate the geographical distribution of homicide over America, with a date selection component, a drop-down menu to filter weapon categories and a bar chart to summarize race and gender aggregation. By using this tab the user can easily filter out the interested subset and observe how those cases are distributed geographically.
The second tab is to show the frequency of homicide is regulated by season or month. By changing the drop-down menu, users can select the cases given specific relationship, weapon, crime type and state.
The third tab aims to show specific crime corridors between different race and gender groups. The area sitting on the left and right side means the percentage of that group as perpetrator or Victim. The width of the line connecting each group indicates the count of cases.
Homicides in the United States is an important topic to think about. Compared to other high-income countries, the US contains greater homicide rates (e.g. gun homicides, https://pubmed.ncbi.nlm.nih.gov/30817955/). Because homicides can cause significant negative effects (e.g. loss of life), it may be important to investigate ways to reduce the negative effects of homicides.
One way to address the negative effects of homicides in the US may be to provide general education about homicides. General education can be helpful in at least two ways: 1) For everyday citizens, awareness about homicides (e.g. what types of crimes are likely to be committed, in which regions), may increase citizens’ abilities to prepare and defend themselves against attacks. 2) For people working in crime-related areas (e.g. law enforcement), information about homicides may increase their ability to pinpoint and reduce criminal activity.
Therefore, the aim of the current project is to create tools that could provide education about homicides in the US. Specifically, we will create an interactive dashboard investigating homicide-related data from the 2010’s to 2014s. This dashboard could be used to provide insights into relevant questions, such as examining how homicide-related activity is distributed geographically across the US.
project/
├── data/
│ └── database.csv
│
├── src/
│ ├── apps/
│ ├── __init__.py
│ ├── Interactive-Map-page.py
│ ├── Monthly-Record-Graph.py
│ └── Sankey-Plot.py
│ ├── assets/
│ ├── custom.css
│ ├── data/
│ ├── database.csv
│ └── app.py
│
├── reports/
├── doc/
│ ├── sketch/
│ ├── main_submission_proposal.md
│ ├── reflection-milestone2.md
│ ├── reflection-milestone4.md
│ ├── v1_demo.gif
│ ├── page1.png
│ ├── page2.png
│ ├── page3.png
│ └── team-contract.md
│
├── requirements.txt
├── README.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
└── LICENSE.md
$ pip install -r requirements.txt
$ python src/app.py
Open the link displayed on the terminal.
Figure1: v1 demo
Figure2: v2 page1 Interactive Map
Figure3: v2 page2 Rose Graph
Figure4: v2 page3 Sankey Plot
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.
If you think you can help in any of these areas or in many areas we haven't thought of yet, then please take a look at our Contributors' guidelines.
If you want to report a problem or suggest an enhancement we'd love for you to open an issue at this github repository because then we can get right on it. But you can also contact Yuki(Yuxin) by email yuxin.yuki.chen@gmail.com.