illuminator 3.1b0

A development toolkit for simulating energy systems

Illuminator

The Illuminator is an easy-to-use Energy System Integration Development kit to demystify energy system's operation, illustrate challenges that arise due to the energy transition and test state-of-the-art energy management concepts. The kit utilises Raspberry Pi's as individual components of an energy system emulator, and the simulation engine is based on Mosaik.

Installation

Requirements

• Python >= 3.8 & < 3.12
• Miniconda (optional)
• A Rasberry Pi cluster, for cluster deployment (optional)

Using Pip

The simplest way to install Illuminator is from PYPI, using pip:

pip install illuminator

Using Conda

The environment.yml provides all dependecies to create a conda environment called illuminator.

conda env create -f environment.yml

conda activate illuminator

Refer to the Quick Start guide for a brief explanation on how to set up and run your first simulation.

Illuminator Raspberry Pi Cluster

Refer to the Cluster Pi Setup documentation for instructions on how to set up an Illuminator cluster.

Contributing Guidelines

The Illuminator team accepts contributions to the Illuminator source, test files, documentation, and other materials distributed with the program. To contribute read our guidelines

License

Illuminator is available under a GNU Lesser General Public License (LGPL). The Illuminator team does not take responsibility for any damage or loss derive from using this sourcecode.

Citation

Please cite this software as follows:

A. Fu, R. Saini, R. Koornneef, A. van der Meer, P. Palensky and M. Cvetković, "The Illuminator: An Open Source Energy System Integration Development Kit," 2023 IEEE Belgrade PowerTech, Belgrade, Serbia, 2023, pp. 01-05, doi: 10.1109/PowerTech55446.2023.10202816.

Contributors

Many people have contributed to the development of Illuminator, we list their names and contributions below:

Role	Contributor
v3 Core Developers	J. Groen, D. Georgiadi
Conceptualization	A. Fu, A. Neagu, M. Cvetkovic, M. Garcia Alvarez, M. Rom
Funding acquisition	A. Fu, M. Cvetkovic, P. Palensky
Project management	A. Neagu, M. Cvetkovic
Research	A. Fu, M. Cvetkovic, N. Balassi, R. Saini, S.K. Trichy Siva Raman
Resources	R. Koornneef
Software	A. Fu, J. Grguric, J. Pijpker, M. Garcia Alvarez, M. Rom., D. Georgiadi, J. Groen
Model Development	J. Groen, D. Georgiadi, L. Klootwijk
Tutorials	J. Riedler
Supervision	A. Neagu, M. Cvetkovic

Acknowledgements

The Illuminator team extends its sincere gratitude for the invaluable support and contributions from our dedicated members:

• Aihui Fu, who played a pivotal role as the main developer for both Versions 1.0 and 2.0.
• Remko Koornneef, whose expertise in hardware development has been instrumental.
• Siva Kaviya, for her significant contributions to the development of the initial version.
• Raghav Saini, for his substantial involvement in developing the models for Version 1.0.
• Niki Balassi, for his crucial role in advancing the multi-energy system models in Version 2.0.

Each of these individuals has been essential in shaping the success and evolution of our project. We are profoundly thankful for their dedication and expertise.

• The Illuminator project is supported by TU Delft PowerWeb and Stichting 3E.
• The development of the Illuminator was supported by the Digital Competence Centre, Delft University of Technology.

Contact and Support

For more comprehensive support, please contact us at [e-mail]. Additionally, you can reach out to the main contributors for specific inquiries:

• Dr.ir. Jort A. Groen
• Despoina Georgiadi
• Dr.ir. Milos Cvetkovic