# youssef595/hourly-electricity-price-forecasting architecture

> Architecture diagram of the GitHub repository youssef595/hourly-electricity-price-forecasting, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/youssef595/hourly-electricity-price-forecasting
- Repository: https://github.com/youssef595/hourly-electricity-price-forecasting

## Overview

##### Project type and purpose
- This is a data-science/time-series forecasting project (“Hourly-electricity-price-forecasting”) aimed at predicting hourly electricity prices in Spain using historical energy and weather data. It uses various modeling strategies (base boosting models, multiple train/test splits, walk-forward validation, hybrid multivariate forecasting) to produce reports and presentations.

##### File structure
- Top-level directories:
- Data: raw CSV datasets (energy_dataset.csv, weather_features.csv)
- Notebooks: Jupyter notebooks for exploration, feature engineering, modeling, and visualization
- Presentation: final PowerPoint
- Reports: PDF/HTML reports and model performance summaries
- README.md describes data sources (ENTSOE, Red Eléctrica España), approaches, and visualizations.
- There are no separate “src” or “backend” directories—computation is entirely in notebooks.

##### README for additional insights
- Datasets: two main CSVs (energy & weather), concatenated for modeling
- Approaches:
a. Base implementation (2015–2017 training, 2018 testing)
b. Multiple train/test splits
c. Walk-forward validation
d. Hybrid multivariate forecasting (varying time lags)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External documentation
    readme["README.md"]:::doc
    readme -->|describes sources| E

    %% External data sources
    E["External Data Sources"]:::external

    %% Raw data storage
    Data1["energy_dataset.csv"]:::data
    Data2["weather_features.csv"]:::data

    %% Data processing
    Ingest["Feature Engineering Notebook"]:::process
    Viz["Exploratory Visualizations Notebook"]:::process

    %% Modeling strategies
    subgraph "Modeling Strategies"
        Base["Base Boosting Models"]:::model
        Splits["Multiple Train/Test Splits"]:::model
        WF{"Walk-Forward Validation"}:::loop
        Hybrid["Hybrid Forecasting"]:::model
    end

    %% Evaluation and reporting
    Eval["Evaluation & Metrics (RMSE)"]:::process

    subgraph "Reports & Presentation"
        Mrep["models_report_before best RMSE.csv"]:::doc
        Rrep1["Electricity price forecasting report.pdf"]:::doc
        Rrep2["Weathergy_report.html"]:::doc
        Rrep3["final version report.pdf"]:::doc
        Pres["Presentation Deck"]:::doc
    end

    %% Data flow
    E --> Data1
    E --> Data2
    Data1 --> Ingest
    Data2 --> Ingest
    Data1 --> Viz
    Data2 --> Viz
    Ingest --> Viz
    Ingest --> Base
    Ingest --> Splits
    Ingest --> WF
    Ingest --> Hybrid
    Viz --> Base
    Viz --> Splits
    Viz --> WF
    Viz --> Hybrid
    Base --> Eval
    Splits --> Eval
    WF --> Eval
    Hybrid --> Eval
    Eval --> Mrep
    Mrep --> Rrep1
    Mrep --> Rrep2
    Mrep --> Rrep3
    Rrep1 --> Pres
    Rrep2 --> Pres
    Rrep3 --> Pres

    %% Click Events
    click Data1 "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Data/energy_dataset.csv"
    click Data2 "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Data/weather_features.csv"
    click Ingest "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/Electricity Price Prediction in Spain.ipynb"
    click Viz "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/other_Visualizations.ipynb"
    click Base "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/Electricity Price Prediction in Spain.ipynb"
    click Splits "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/Electricity Price Prediction in Spain.ipynb"
    click WF "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/Electricity Price Prediction in Spain.ipynb"
    click Hybrid "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Notebooks/Electricity Price Prediction in Spain.ipynb"
    click Mrep "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Reports/models_report_before best RMSE.csv"
    click Rrep1 "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Reports/Electricity price forecasting report.pdf"
    click Rrep2 "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Reports/Weathergy_report.html"
    click Rrep3 "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Reports/final version report.pdf"
    click Pres "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/Presentation/présentation analytics finale.pptx"
    click readme "https://github.com/youssef595/hourly-electricity-price-forecasting/blob/main/README.md"

    %% Styles
    classDef external fill:#f0f0f0,stroke:#999,stroke-width:1px
    classDef data fill:#ADD8E6,stroke:#036,stroke-width:1px
    classDef process fill:#90EE90,stroke:#060,stroke-width:1px
    classDef model fill:#FFA500,stroke:#a60,stroke-width:1px
    classDef loop fill:#FFB6C1,stroke:#c33,stroke-width:1px
    classDef doc fill:#D8BFD8,stroke:#952,stroke-width:1px
```
