README.md

Tool for Analysis and Visualization of Violent Crimes in the Metropolitan Area of Monterrey

Table of Contents

• Demo
• Features
• Future Work
• Installation
• Contributing
• License

Demo

DEMO on Streamlit
https://ernestosaleh-tigereye-1--inicio-j7lxd4.streamlit.app/Tipos_de_Violencia

Features

This demo offers:

• Visualization of the total crimes.
• Visualization of crimes per capita.

The user is able to select the type of crime and time range they want to observe.

Future Work

This project aims to include:

• Tools to correlate external factors.
• Forecasting and anomaly detection.
• Updated data with Web Scraping.
• Interface to visualize relevant news.
• Development tools to scale this tool to more cities.

Installation

1. Clone the repository:

   git clone https://github.com/JosePabloGFnl/Monterrey-Violence.git
   cd Monterrey-Violence

2. Create a virtual environment:

   python -m venv venv

3. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate

   • On macOS/Linux:

     source venv/bin/activate

4. Install the required packages:

   pip install -r requirements.txt

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.

For more information and conceptual graphs, see "pitch.pdf".

For more information on data processing and exploratory analysis, go to https://github.com/JosePabloGFnl/Monterrey-Violence