How shubhamcore/feederflex works
FeederFlex is a synthetic feeder-coordination testbench and evidence/demo package, not a live grid-control or settlement system. Its main workflow prepares household and weather inputs, simulates forecasts and coordinated dispatch across scenarios, then presents validated results as an offline dashboard and explanatory receipts. The repository also produces research and pitch deliverables. Some simulator internals and output wiring are unsampled; those relationships are shown only where the README or excerpts support them.
Main entry points: simulate_feeder.py Scenario simulation · scenario_timeseries.csv Simulation results · build_dashboard.py Dashboard generation · dashboard.html Interactive dashboard
Components 19
Data inputs
- CEEW load profiles
data/ceew_bareilly_2019_profiles_15m.csv - Profile preparation
scripts/prepare_ceew.py - Weather retrieval
scripts/fetch_nasa_power.py - NASA weather series
data/nasa_power_bihta_2019_hourly.csv
Feeder simulation
- Scenario simulation
scripts/simulate_feeder.py - Coordinated dispatch
scripts/simulate_feeder.py - Forecast evaluation
scripts/simulate_feeder.py
Results and evidence
- Simulation results
results/scenario_timeseries.csv - Result checks
scripts/validate_results.py - Dashboard payload
results/dashboard_data.json
Dashboard experience
- Dashboard generation
scripts/build_dashboard.py - Interactive dashboard
dashboard.html - Local dashboard server
scripts/serve_dashboard.py
Research and pitch
- Research report
docs/FeederFlex_Research_Report.md - DOCX report builder
scripts/render_report_docx.py - Formatted report
docs/FeederFlex_Competition_Report.docx - Pitch deck builder
scripts/build_pitch_deck.py - Competition pitch deck
docs/FeederFlex_Competition_Pitch.pptx
Other components
- Judge or analyst
Connections 17
- Profile preparation → CEEW load profiles: prepares profiles
scripts/prepare_ceew.py - Weather retrieval → NASA weather series: writes series
scripts/fetch_nasa_power.py - CEEW load profiles → Scenario simulation: load input
README.md - NASA weather series → Scenario simulation: weather input
README.md - Scenario simulation → Forecast evaluation: evaluates forecasts
scripts/simulate_feeder.py - Scenario simulation → Coordinated dispatch: runs dispatch
scripts/simulate_feeder.py - Scenario simulation → Simulation results: writes run outputs
README.md - Simulation results → Result checks: checks outputs
scripts/validate_results.py - Simulation results → Dashboard generation: reads results
scripts/build_dashboard.py - Dashboard generation → Dashboard payload: builds payload
scripts/build_dashboard.py - Dashboard generation → Interactive dashboard: generates dashboard
README.md - Local dashboard server → Interactive dashboard: serves at root
scripts/serve_dashboard.py - Judge or analyst → Interactive dashboard: explores results
README.md - Research report → Formatted report: rendered report
README.md - DOCX report builder → Research report: reads markdown
scripts/render_report_docx.py - DOCX report builder → Formatted report: writes document
README.md - Pitch deck builder → Competition pitch deck: builds deck
README.md