How henry-don/grid-connected-bess-control-validation works
This repository is a staged grid-connected battery energy storage system (BESS) simulation and automated validation platform. The main workflow starts with a reviewed YAML case matrix, creates a manifest, runs MATLAB/Simulink batch simulations, independently checks metrics in Python, and produces HTML reports with waveforms and verdicts. The README also documents staged grid, control, battery, and protection models plus a separate physically coupled 30-case validation path. Python excerpts establish runner/tool calls; model internals and MATLAB batch implementations were not sampled, so their connections are documented by the README.
Main entry points: run_phase5.py Batch Runner · phase5_tools.py Manifest and Checks · results Simulation Results · run_physical_report.py Physical Report Runner
Components 16
BESS Models
- Grid Model
models/bess_phase1_grid_base.slx - Control Model
models/bess_phase2_controlled.slx - Battery Model
models/bess_phase3_battery_dcdc.slx - Protection Model
models/bess_phase4_protection.slx - Fast Batch Model
models/bess_phase5_integrated.slx - Coupled BESS
models/bess_final_coupled.slx - Physical Validation
models/bess_final_physical_validation.slx
Validation Workflow
- Case Matrix
cases/phase5_cases.yaml - Batch Runner
python/run_phase5.py - Manifest and Checks
python/phase5_tools.py - Physical Report Runner
python/run_physical_report.py - Evidence Verifier
python/verify_repository.py
Results and Evidence
- Simulation Results
results - HTML Reports
results
Other components
- Engineer
- MATLAB / Simulink
Connections 20
- Engineer → Batch Runner: launches
README.md - Case Matrix → Batch Runner: configures
python/run_phase5.py - Batch Runner → Manifest and Checks: calls
python/run_phase5.py - Batch Runner → MATLAB / Simulink: launches batch
python/run_phase5.py - MATLAB / Simulink → Fast Batch Model: simulates
README.md - Fast Batch Model → Simulation Results: produces
README.md - Batch Runner → Simulation Results: validates
python/run_phase5.py - Manifest and Checks → HTML Reports: renders
- Engineer → Physical Report Runner: runs
README.md - Physical Report Runner → Manifest and Checks: calls
python/run_physical_report.py - Physical Report Runner → Simulation Results: validates
python/run_physical_report.py - MATLAB / Simulink → Physical Validation: simulates
README.md - Physical Validation → Simulation Results: produces
README.md - Manifest and Checks → HTML Reports: renders physical
- Evidence Verifier → Manifest and Checks: reads YAML
python/verify_repository.py - Engineer → Grid Model: inspects
README.md - Engineer → Control Model: inspects
README.md - Engineer → Battery Model: inspects
README.md - Engineer → Protection Model: runs
README.md - Engineer → Coupled BESS: reviews
README.md