# vspvsp3355/bias-crime-intelligence-engine architecture

> Architecture diagram of the GitHub repository vspvsp3355/bias-crime-intelligence-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vspvsp3355/bias-crime-intelligence-engine
- Repository: https://github.com/vspvsp3355/bias-crime-intelligence-engine

## Overview

This repository presents a notebook-based hate-crime analysis project, with an accompanying spreadsheet dataset. The documented workflow covers preprocessing and feature engineering, exploratory analysis, predictive modeling, explainability, and geospatial visualization. The README describes these capabilities but no notebook source was provided, so the graph reflects documented relationships rather than verified calls or data transfers; the spreadsheet’s exact use is unconfirmed.

Main entry points: [`Bias Crime .ipynb`](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb) (Preprocessing), [`hate crime data set.xlsx`](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/hate%20crime%20data%20set.xlsx) (Hate crime dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_dataset["Hate crime dataset"]
  node_preprocessing["Preprocessing<br/>[Bias Crime .ipynb]"]
end

subgraph group_analysis["Analysis and modeling"]
  node_eda["Exploratory analysis<br/>[Bias Crime .ipynb]"]
  node_models["Predictive models<br/>[Bias Crime .ipynb]"]
end

subgraph group_outputs["Interpretation and mapping"]
  node_explainability["Explainability and ethics<br/>[Bias Crime .ipynb]"]
  node_maps["Geospatial visualization<br/>[Bias Crime .ipynb]"]
end

node_analyst(("Analyst"))

node_analyst -.->|"uses notebook"| node_preprocessing
node_dataset -.->|"feeds data"| node_preprocessing
node_preprocessing -->|"supports analysis"| node_eda
node_preprocessing -->|"creates features"| node_models
node_models -->|"supports interpretation"| node_explainability
node_models -.->|"supports mapping"| node_maps

click node_dataset "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/hate%20crime%20data%20set.xlsx"
click node_preprocessing "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb"
click node_eda "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb"
click node_models "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb"
click node_explainability "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb"
click node_maps "https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dataset,node_preprocessing toneBlue
class node_eda,node_models toneAmber
class node_explainability,node_maps toneMint
class node_analyst toneIndigo
```

## Components

### Data preparation

- [Hate crime dataset](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/hate%20crime%20data%20set.xlsx): `hate crime data set.xlsx`
- [Preprocessing](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb): `Bias Crime .ipynb`

### Analysis and modeling

- [Exploratory analysis](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb): `Bias Crime .ipynb`
- [Predictive models](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb): `Bias Crime .ipynb`

### Interpretation and mapping

- [Explainability and ethics](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb): `Bias Crime .ipynb`
- [Geospatial visualization](https://github.com/vspvsp3355/bias-crime-intelligence-engine/blob/main/Bias%20Crime%20.ipynb): `Bias Crime .ipynb`

### Other components

- **Analyst**

## Connections

- Analyst → Preprocessing: uses notebook
- Hate crime dataset → Preprocessing: feeds data
- Preprocessing → Exploratory analysis: supports analysis (evidence: `README.md`)
- Preprocessing → Predictive models: creates features (evidence: `README.md`)
- Predictive models → Explainability and ethics: supports interpretation (evidence: `README.md`)
- Predictive models → Geospatial visualization: supports mapping
