How souvik-dey-2029/margganit works
MargGanit is a NumPy road-safety analytics engine. Its main workflow loads accident records, removes duplicates and builds a validated numerical feature matrix, calculates and ranks risk for occupied 10-km road segments, then prints the top results. The risk indicator combines spatial concentration, mean severity, and hourly-entropy-based temporal concentration, with reliability adjustments for severity and temporal estimates. The README also documents notebook analyses and visualizations; their internal wiring is not shown in the sampled source.
Main entry points: main.py Analysis runner · risk_engine.py Segment risk engine · preprocessing.py Dedup and features · data_loader.py CSV loader
Components 16
Data preparation
- Accident CSV
data/ETP_4_New_Data_Accidents.csv - CSV loader
src/data_loader.py - Dedup and features
src/preprocessing.py - Feature validation
src/preprocessing.py
Risk analytics
- Segment risk engine
src/risk_engine.py - Spatial concentration
src/risk_engine.py - Adjusted severity
src/risk_engine.py - Temporal concentration
src/risk_engine.py - Composite ranking
src/risk_engine.py
Analysis runtime
- Analysis runner
src/main.py - Printed top segments
src/main.py
Exploratory analysis
- Data exploration
notebook/01_data_exploration.ipynb - NumPy cleaning
notebook/02_numpy_cleaning.ipynb - Risk analysis
notebook/03_risk_engine.ipynb - Results and plots
notebook/04_analysis.ipynb
Other components
- Analyst
Connections 16
- Analyst → Analysis runner: runs analysis
README.md - Accident CSV → CSV loader: loaded from
README.md - Analysis runner → CSV loader: loads data
src/main.py - Analysis runner → Dedup and features: preprocesses data
src/main.py - Dedup and features → Feature validation: builds features
src/preprocessing.py - Analysis runner → Feature validation: validates matrix
src/main.py - Analysis runner → Segment risk engine: calculates risk
src/main.py - Segment risk engine → Spatial concentration: calculates counts
src/risk_engine.py - Segment risk engine → Adjusted severity: adjusts severity
src/risk_engine.py - Segment risk engine → Temporal concentration: calculates entropy
src/risk_engine.py - Segment risk engine → Composite ranking: ranks segments
src/risk_engine.py - Analysis runner → Printed top segments: prints results
src/main.py - Analyst → Data exploration: explores records
README.md - Analyst → NumPy cleaning: reviews cleaning
README.md - Analyst → Risk analysis: examines risk
README.md - Analyst → Results and plots: reviews analysis
README.md