# 911 Casualty Data Visualization

This project provides a full-stack application to visualize 911 casualty data using a Flask backend and a React frontend.

ATTENTION: The data required to run this project is provided by the Communication Ventures Corporation.
In order to utilize these scripts, you will need to acquire access to this data from the data source owner.
The raw data itself is restricted and not shareable, please see the report for further details.

## Table of Contents

- [Introduction](#introduction)
- [Project Structure](#project-structure)
- [Setup Instructions](#setup-instructions)
  - [Clone the Repository](#clone-the-repository)
  - [Start the Application Using the Script](#start-the-application-using-the-script)
- [Dependencies](#dependencies)
  - [Backend Dependencies](#backend-dependencies)
  - [Frontend Dependencies](#frontend-dependencies)
- [Usage](#usage)
- [Data Source](#data-source)
- [License](#license)

## Introduction

This project visualizes 911 casualty data, performs clustering on the data, and provides a real-time backend API. The backend is built with Flask, and the frontend is built with React.

scripts/\
├── backend/\
│ ├── main.py\
│ ├── visualization.py\
│ └── requirements.txt\
├── frontend/\
│ ├── my-map-app/\
│ │ ├── public/\
│ │ ├── src/\
│ │ │ ├── app.js\
│ │ │ ├── MainApp.js\
│ │ │ ├── api.js\
│ │ │ ├── Login.js\
│ │ │ ├── index.js\
│ │ │ ├── App.js\
│ │ ├── package.json\
│ │ └── README.md\
├── start.sh\
├── README.md

## Setup Instructions

Download the complete folder and unzip into your preferred workspace (we do not have a git clone)

Start the Application Using the Script

You can start both the backend and frontend servers using the provided script:

in bash:
./start.sh

## Dependencies

## Backend Dependencies
* Python
* Flask
* Flask-CORS
* pandas
* scikit-learn
* matplotlib
* seaborn
* plotly
* cartopy
* pyspark

## Frontend Dependencies
* Node.js
* React
* react-dom
* react-scripts
* react-leaflet
* leaflet
* axios

## Usage
After starting both servers, you can access the frontend application in your web browser at http://localhost:3000.

The Flask backend will be running at http://localhost:5000.

## Data Source

- 911 Call Dataset
- Data requires permission for access

*The data used in this project is sourced from the Communication Ventures Corporation, please contact the data owner to acquire data.

- Gun Violence Archive Dataset
- Data derived from https://www.gunviolencearchive.org/

## License
This project is licensed under the MIT License. See the LICENSE file for more information.