| 1 | Data Source | Truth-grounded synthetic flaring dataset: 3 stacks (FL-A/B/C) × 13,032 hourly records, Jan–Jun 2025. Truth tables match fact rows 1:1. | Ground truth enables objective evaluation of detection quality — not just description. | Raw CSVs frozen in data/; SHA-256 in _audit table and Manifest below. |
| 2 | Data Model | SQLite flaring.db: fact_hourly, dim_asset, truth_events, truth_routing, _audit. Indexed on (stack_id, timestamp_utc). | Single source of truth across 9 scripts. Typed schema prevents silent drift between runs. | DDL + load: 06_Analysis/build_db.py. |
| 3 | Metrics | Flaring Volume (sm³) · Flaring Intensity (flared / throughput) · Utilization Rate (recovered / capacity) · Emission Factor (kg CO₂ / sm³). Total flared: 9.04 M sm³ · Total CO₂: 18.22 M kg | Four standard O&G KPIs, each answering one decision question. Comparable to World Bank / IEA benchmarks. | Formulas hardcoded in 06_Analysis/analysis.py. |
| 4 | Statistical Methods | IQR Tukey fence (k = 1.5) · Robust z-score on MAD (threshold 3.5, scale 0.6745) · Two-method union for detection · Confusion matrix · MAE / RMSE / MAPE. | Handles right-skewed distributions without over-flagging; two detectors make conclusions robust to any single method's bias. | Thresholds are named constants; reported in analysis_summary.json → methodology. |
| 5 | Anomaly Detection | Per-stack IQR + MAD union. Detection variable: flaring_intensity. Flagged hours: 611 across 13,032 (4.7%). | Per-stack baselines respect that each stack has its own operating envelope. Union = defense-in-depth. | Per-row flags in analysis_table.csv: is_anomaly_iqr, is_anomaly_mad, is_anomaly_either. |
| 6 | Uncertainty & Validation | Truth-based scoring at three levels: event (recall 75.0%), hour (accuracy 91.7%), volume (baseline MAE 5.75 sm³/h). | Separates "does the detector find real events?" from "does the recording track truth?" — two distinct analytical questions. | 07_Evaluation/evaluation_metrics.json contains every score; evaluation_report.txt is human-readable. |
| 7 | Software Stack | Python 3.14 · pandas · numpy · matplotlib (SVG + PNG) · SQLite 3 · Playwright (channel=chrome) for PDF · GitHub + Cloudflare for web. | Full-stack, reproducible, Iran-geo-compatible (Playwright via Runflare mirror). | requirements.txt; deploy path in 10_Publish/public/README.md. |