# Darkoza GridFlex Screen v0.1 — reproducible research package

Publication date: 2026-11-03  
Evidence status: evidence synthesis + new deterministic screening tool; no new physical experiment or new scientific law claimed.

## Package contents

- report.html / report.md — integrated Persian research note.
- darkozagridflex.py — standard-library Python hourly screening model.
- test_darkozagridflex.py — six unit tests.
- example_synthetic_48h.csv — fully synthetic 48-hour demonstration input.
- example_synthetic_48h_result.json — output for the synthetic demonstration.
- methodology.json — machine-readable evidence and model boundaries.
- Public API record: https://darkoza.com/science-api/v1/experiments/global-grid-resilience.json

## Run it

Python 3.10+; standard library only.

    python3 -m py_compile darkozagridflex.py test_darkozagridflex.py
    python3 -m unittest -v test_darkozagridflex.py
    python3 darkozagridflex.py example_synthetic_48h.csv \
      --battery-power-mw 0.8 --battery-energy-mwh 2.4 --battery-rte 0.90 \
      --ldes-power-mw 0.4 --ldes-energy-mwh 8 --ldes-rte 0.60 \
      --output result.json

## Input CSV

Required columns:
- load_mw
- solar_mw
- wind_mw

Optional:
- timestamp (ISO 8601; if used, all rows must be consecutive hourly intervals)

Rows are interpreted as chronological one-hour intervals. Values are non-negative MW. Power limits are MW; energy capacities are MWh.

## Model contract

- Direct renewables serve load first.
- Surplus renewable energy charges storage under the chosen charge priority.
- Remaining deficit is served by storage under the chosen discharge priority.
- Remaining demand is reported as unserved; remaining surplus is reported as curtailed.
- Round-trip efficiency is split evenly: charge and discharge efficiencies are both sqrt(RTE).
- Initial SOC defaults to zero. End SOC is reported, not forced to zero.

## Important limitations

The tool is a screening model only. It is not a grid dispatch optimizer or engineering design. It omits imports, thermal generation, hydropower, nuclear, demand response, exports, transmission, reserves, power quality, sub-hour dynamics, degradation, costs, fuel, emissions, water, land, by-product markets and project financing. It treats LDES as a generic energy buffer and does not simulate rSOC, hydrogen, methane, compressed air, pumped hydro or thermal storage physics. Do not use outputs as investment, safety, regulatory or engineering advice.

The synthetic example is only a code demonstration. It is not evidence of real-world performance or an empirical finding.

## Public evidence sources

- United Nations SDG Goal 7, 2026: https://unstats.un.org/sdgs/report/2026/Goal-07/
- IEA Electricity 2026: https://www.iea.org/reports/electricity-2026/executive-summary
- IEA Modernising Grids (2026): https://www.iea.org/reports/modernising-grids-in-the-age-of-electricity
- Wei et al., Nature Communications 17, 8071 (2026): https://www.nature.com/articles/s41467-026-74229-z
- Stanford HAI AI Index 2026, Science: https://hai.stanford.edu/ai-index/2026-ai-index-report/science
- OERSI SRSF1 secondary research note: https://darkoza.com/science/reports/srsf1-aging-safety-window/report.html

All claims about third-party research remain attributed to their original sources. The Darkoza report does not claim those findings as Darkoza's own experiments.