How danielrosehill/iran-israel-war-2026-osint-data works
This repository publishes an OSINT dataset tracking Iranian attack waves across four escalation rounds. The principal workflow is to consult the structured wave records and reference data, then explore the information through the interactive map or obtain it in analysis-friendly formats. The README also documents Neo4j relationship analysis and Kaggle/Hugging Face distribution. The sampled Python sources confirm enrichment and export responsibilities; frontend wiring and unsampled integrations are represented only where the tree or README supports them.
Main entry points: waves.json Round Records · iranian_weapons.json Reference Data · build_export.py Export Bundle · build_neo4j.py Graph Builder
Components 21
Incident Data
- Round Records
data/tp4-2026/waves.json - Prior Rounds
data/tp1-2024/waves.json - Reference Data
data/reference/iranian_weapons.json - Data Schema
data/schema/wave.schema.json
Data Enrichment
- Normalization
scripts/normalization.py - Wave Enrichment
scripts/wave_enrichment.py - Coordinate Resolution
scripts/fill_coords.py - GeoJSON Export
scripts/build_geojson.py - ArcGIS Export
scripts/build_arcgis.py - Tabular Export
scripts/build_kaggle.py
User Access
- Interactive Map
docs/map.html - Map Data Client
docs/js/data.js - Map Logic
docs/js/map.js - Dataset Dashboard
docs/index.html
Analysis and Distribution
- Graph Builder
scripts/build_neo4j.py - Export Bundle
scripts/build_export.py - Published Exports
exports/latest/json/incidents_all.json
Other components
- Researcher
- Neo4j Aura
- Kaggle
- Hugging Face
Connections 25
- Researcher → Interactive Map: explores
- Interactive Map → Map Data Client: loads data
- Interactive Map → Map Logic: renders map
- Researcher → Dataset Dashboard: views dataset
- Researcher → Published Exports: downloads
- Round Records → Coordinate Resolution: fills coordinates
- Reference Data → Coordinate Resolution: resolves locations
- Round Records → GeoJSON Export: builds layers
- Reference Data → GeoJSON Export: matches targets
- Round Records → ArcGIS Export: builds layers
- Wave Enrichment → ArcGIS Export: enriches records
- Round Records → Tabular Export: flattens records
- Wave Enrichment → Tabular Export: enriches records
- Reference Data → Normalization: indexes aliases
- Round Records → Graph Builder: loads records
- Reference Data → Graph Builder: loads entities
- Normalization → Graph Builder: normalizes entities
- Graph Builder → Neo4j Aura: writes graph
- Round Records → Export Bundle: bundles rounds
- Export Bundle → GeoJSON Export: invokes builder
- Export Bundle → ArcGIS Export: invokes builder
- Export Bundle → Published Exports: publishes bundle
- Tabular Export → Kaggle: supports upload
- Researcher → Kaggle: gets dataset
- Researcher → Hugging Face: gets dataset