How letsbegincode/european-power-fair-value-forecasting works
Powerfair is a DE-LU Day-Ahead power fair-value forecasting pipeline. A command-line run loads configuration, fetches and normalizes public market data, assesses data quality, engineers forecasting features, trains and validates models, translates forecasts into prompt baseload/peak values, and writes desk-facing reports. The graph preserves the documented AI-assisted QA branch and model validation capabilities. Some subsystem links are documented only in the README; those edges cite it rather than implying unsampled calls were inspected.
Main entry points: cli.py Pipeline CLI · qa.py Deterministic QA · sources.py Public data ingestion · modeling.py Model validation
Components 19
Run orchestration
- Pipeline CLI
src/powerfair/cli.py
Market data
- Run configuration
src/powerfair/data/config.py - Public data ingestion
src/powerfair/data/sources.py - Energy-Charts API
- Hourly market data
data/processed - UTC and DST utilities
src/powerfair/data/time_utils.py
Quality assurance
- Deterministic QA
src/powerfair/validation/qa.py - Guarded AI QA
src/powerfair/ai/qa_rules.py - LLM provider
- QA reports
outputs/qa
Forecast and desk outputs
- Feature engineering
src/powerfair/forecasting/features.py - Feature table
data/processed/de_lu_features.csv - Model validation
src/powerfair/forecasting/modeling.py - Forecast artifacts
outputs/model - Prompt curve view
src/powerfair/trading/curve.py - Curve fair values
outputs/curve - Desk and project reports
src/powerfair/reports/writers.py - Trader-facing reports
reports
Other components
- Analyst
Connections 21
- Analyst → Pipeline CLI: runs
README.md - Pipeline CLI → Run configuration: loads config
src/powerfair/cli.py - Pipeline CLI → Public data ingestion: fetches data
src/powerfair/cli.py - Public data ingestion → Energy-Charts API: requests data
src/powerfair/data/sources.py - Public data ingestion → Hourly market data: normalizes and caches
src/powerfair/data/sources.py - Pipeline CLI → Hourly market data: writes processed data
src/powerfair/cli.py - Pipeline CLI → Deterministic QA: runs checks
src/powerfair/cli.py - Deterministic QA → UTC and DST utilities: checks DST
src/powerfair/validation/qa.py - Deterministic QA → Guarded AI QA: invokes
src/powerfair/validation/qa.py - Guarded AI QA → LLM provider: requests rule proposals
src/powerfair/ai/qa_rules.py - Deterministic QA → QA reports: writes reports
src/powerfair/validation/qa.py - Pipeline CLI → Feature engineering: builds features
src/powerfair/cli.py - Feature engineering → UTC and DST utilities: adds time fields
src/powerfair/forecasting/features.py - Pipeline CLI → Feature table: writes features
src/powerfair/cli.py - Pipeline CLI → Model validation: trains and validates
src/powerfair/cli.py - Model validation → Feature engineering: selects feature columns
src/powerfair/forecasting/modeling.py - Model validation → Forecast artifacts: writes forecast artifacts
README.md - Pipeline CLI → Prompt curve view: builds curve view
src/powerfair/cli.py - Prompt curve view → Curve fair values: writes fair values
src/powerfair/trading/curve.py - Pipeline CLI → Desk and project reports: writes reports
src/powerfair/cli.py - Desk and project reports → Trader-facing reports: generates desk notes
README.md