loadforecasting-models 0.3.0

Package, containing multiple state-of-the-art forecasting models.

Overview

This Python package provides state-of-the-art models for short-term load forecasting (STLF), designed for both academic research and real-world energy applications.

The models and evaluation framework are described in the following publication:

Moosbrugger et al. (2025). Load Forecasting for Households and Energy Communities: Are Deep Learning Models Worth the Effort?
arXiv:2501.05000

For more details and the full project source code, visit the GitHub repository.

Quick Start

Install the package:

pip install loadforecasting_models

You can easily integrate and train our forecasting machine learning models in your Python workflow:

from loadforecasting_models import Knn, Lstm, Transformer, xLstm, Persistence, Normalizer
import torch

# ------------------------------------------------------------------------------
# Define dataset parameters
# ------------------------------------------------------------------------------
features = 10          # Number of input features
seq_len = 24           # Sequence length (e.g., 24 hours)
batches_train = 365    # Number of training samples (e.g., one year of daily sequences)
batches_test = 90      # Number of test samples

# ------------------------------------------------------------------------------
# Prepare training data
# ------------------------------------------------------------------------------
normalizer = Normalizer()

# Generate dummy training data (replace with your own)
x_train = torch.randn(batches_train, seq_len, features)   # Shape: (batch_size, seq_len, features)
y_train = torch.randn(batches_train, seq_len, 1)          # Shape: (batch_size, seq_len, 1)

# Normalize data
x_train = normalizer.normalize_x(x_train, training=True)
y_train = normalizer.normalize_y(y_train, training=True)

# ------------------------------------------------------------------------------
# Initialize and train the model
# ------------------------------------------------------------------------------

# Available models: Transformer, LSTM, xLSTM, KNN, Persistence
myModel = Transformer(model_size='5k', normalizer=normalizer)
myModel.train_model(x_train, y_train, epochs=100, verbose=1)

# ------------------------------------------------------------------------------
# Make predictions
# ------------------------------------------------------------------------------
x_test = torch.randn(batches_test, seq_len, features)
x_test = normalizer.normalize_x(x_test, training=False)
y_pred = myModel.predict(x_test)
y_pred = normalizer.de_normalize_y(y_pred)

print('\nOutput shape:', y_pred.shape)

Using a non-machine learning model is very similar, e.g. for a KNN model:

from loadforecasting_models import Knn, Lstm, Transformer, xLstm, Persistence, Normalizer
import torch

# Same setup as above
# ...
myModel = Knn(k=40, weights='distance', normalizer=normalizer)
myModel.train_model(x_train, y_train)
# ...

Currently Available Model Types:

• 'Transformer'

• 'Lstm'

• 'xLstm'

• 'Knn'

• 'Persistence'

Citation

If you use this package in your work, please cite the following paper:

@article{moosbrugger2025load,
  title={Load Forecasting for Households and Energy Communities: Are Deep Learning Models Worth the Effort?},
  author={Moosbrugger, Lukas and Seiler, Valentin and Wohlgenannt, Philipp and Hegenbart, Sebastian and Ristov, Sashko and Eder, Elias and Kepplinger, Peter},
  journal={arXiv preprint},
  year={2025},
  doi={10.48550/arXiv.2501.05000}
}

License

This project is open-source and available under the terms of the MIT License.