How phd-brown/cascade-entropy works
cascade-entropy is a computational-physics research package for simulating cascading transmission-grid failures, evolving the network to generate blackout time series, and comparing electrical, statistical, and entropy-based diagnostics. Its main workflow builds a DC network, dispatches generation and served load, iterates outages and redispatch, then runs slow evolution and analyzes the resulting series. The README describes the physics and information-analysis streams as mostly separate, exchanging series through files; evolution’s documented entropy observable is an exception. Some links below rely on README descriptions or SOURCE INDEX references because excerpts are partial.
Main entry points: cascade.py Daily cascade · analyse_entropie.py Entropy analysis · entropie.py Entropy measures · evolution.py Slow evolution
Components 17
Grid physics
- DC network
cascade_entropy/reseau.py - Constrained dispatch
cascade_entropy/dispatch.py - Carreras regions
cascade_entropy/carreras.py
Failure simulation
- Daily cascade
cascade_entropy/cascade.py - Slow evolution
cascade_entropy/evolution.py
Series analysis
- Reference indicators
cascade_entropy/indicateurs.py - Series analysis
cascade_entropy/analyse_series.py - Carreras replication
scripts/05_reproduction_carreras.py
Information diagnostics
- Entropy measures
cascade_entropy/entropie.py - Entropy analysis
cascade_entropy/analyse_entropie.py - Surrogate controls
cascade_entropy/controles.py - Synthetic series
cascade_entropy/synthetiques.py - Surrogate generators
cascade_entropy/substituts.py - Input validation
cascade_entropy/_validation.py
Other components
- Researcher
- Series files
- Research figures
cascade_entropy/figures.py
Connections 19
- Researcher → Carreras replication: runs study
README.md - DC network → Constrained dispatch: supplies flows
cascade_entropy/dispatch.py - Carreras regions → Daily cascade: sets demand
cascade_entropy/carreras.py - Daily cascade → Constrained dispatch: redispatches
cascade_entropy/cascade.py - Daily cascade → DC network: calculates flows
cascade_entropy/cascade.py - Slow evolution → Daily cascade: simulates days
cascade_entropy/evolution.py - Slow evolution → Entropy measures: computes observable
cascade_entropy/evolution.py - Carreras replication → Daily cascade: runs cascades
scripts/05_reproduction_carreras.py - Slow evolution → Series files: writes series
README.md - Series files → Series analysis: loads series
README.md - Series files → Entropy analysis: loads series
README.md - Series analysis → Reference indicators: estimates Hurst
README.md - Entropy analysis → Entropy measures: calculates measures
cascade_entropy/analyse_entropie.py - Entropy analysis → Surrogate generators: uses surrogates
cascade_entropy/analyse_entropie.py - Surrogate controls → Entropy measures: compares measures
cascade_entropy/controles.py - Surrogate controls → Synthetic series: tests on series
cascade_entropy/controles.py - Entropy measures → Input validation: validates inputs
cascade_entropy/entropie.py - Series analysis → Input validation: validates inputs
cascade_entropy/analyse_series.py - Entropy analysis → Research figures: plots results