https://github.com/germanocastanho/crime-analysis
Criminal data analysis from the Rio Grande do Sul, Brazil (2022-2024) 🚨
https://github.com/germanocastanho/crime-analysis
brazil crime crime-data data-science rio-grande-do-sul
Last synced: 2 months ago
JSON representation
Criminal data analysis from the Rio Grande do Sul, Brazil (2022-2024) 🚨
- Host: GitHub
- URL: https://github.com/germanocastanho/crime-analysis
- Owner: germanocastanho
- License: gpl-3.0
- Created: 2025-08-16T09:23:56.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-09-20T13:05:59.000Z (10 months ago)
- Last Synced: 2025-09-20T15:25:56.483Z (10 months ago)
- Topics: brazil, crime, crime-data, data-science, rio-grande-do-sul
- Language: Jupyter Notebook
- Homepage: https://www.ssp.rs.gov.br/dados-abertos
- Size: 232 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚨 Crime Analysis
Repository focused on **criminal data analysis** from the Rio Grande do Sul (RS), Brazil, between 2022 and 2024. Collected in July 2025 from the [**Public Security Department**](https://www.ssp.rs.gov.br/dados-abertos) (SSP/RS) website, the data under analysis aim to help understand criminal patterns and trends in the region. Used for data science studies, exploratory analysis and (soon!) development of predictive models.
# 🚀 Main Features
- **Interactive Notebooks:** 🗒️ Real data exploration and analysis using JupyterLab.
- **Data Visualization:** 📊 Insightful visualizations to understand crime trends.
- **Reproducible Workflow:** ♻️ Replicable environment for extended analyses and studies.
# ✅ Prerequisites
- **Python 3.12+**, available through the [**official website**](https://www.python.org/downloads/).
- **JupyterLab**, following the [**official installation guide**](https://jupyter.org/install).
# 🛠️ Local Installation
```bash
# Clone the repository
git clone https://github.com/germanocastanho/crime-analysis.git
# Navigate to the directory
cd crime-analysis
# Set up a virtual environment
python3 -m venv .venv
source .venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Access the "crimes.ipynb" notebook
jupyter-lab crimes.ipynb
```
# 📜 Free Software
Distributed under the [**GNU GPL v3**](LICENSE), ensuring freedom to use, modify, and redistribute the software, as long as these freedoms are preserved in any derivative versions. By using or contributing, you support the **free software** philosophy and help build an open, community-driven technological environment! ✊