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.
Requirements
- Python >= 3.8 & < 3.12
- Miniconda (optional)
- A Rasberry Pi cluster, for cluster deployment (optional)
The simplest way to install Illuminator is from PYPI, using pip:
pip install illuminatorThe environment.yml provides all dependecies to create a conda environment called illuminator.
conda env create -f environment.yml
conda activate illuminatorRefer to the Quick Start guide for a brief explanation on how to set up and run your first simulation.
Refer to the Cluster Pi Setup documentation for instructions on how to set up an Illuminator cluster.
The Illuminator team accepts contributions to the Illuminator source, test files, documentation, and other materials distributed with the program. To contribute read our guidelines
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.
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.
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 |
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.
For more comprehensive support, please contact us at illuminator@tudelft.nl. Additionally, you can reach out to the main contributors for specific inquiries: