Skip to content
Switch branches/tags

Build Status Version Documentation Status PyPI - License codecov

Forschungszentrum Juelich Logo

FINE - Framework for Integrated Energy System Assessment

The FINE python package provides a framework for modeling, optimizing and assessing energy systems. With the provided framework, systems with multiple regions, commodities and time steps can be modeled. Target of the optimization is the minimization of the total annual cost while considering technical and enviromental constraints. Besides using the full temporal resolution, an interconnected typical period storage formulation can be applied, that reduces the complexity and computational time of the model.

If you want to use FINE in a published work, please kindly cite following publication which gives a description of the first stages of the framework. The python package which provides the time series aggregation module and its corresponding literatur can be found here.


  • representation of an energy system by multiple locations, commodities and time steps
  • complexity reducing storage formulation based on typical periods


A "Read the Docs" documentation of FINE can be found here.


You can directly install FINE via pip as follows

pip install FINE

However in this case, the connection to this GitHub repository is not preserved. If you want to preserve it, you can clone a local copy of the repository to your computer

git clone

Then install FINE via pip as follow

pip install . 

Or install directly via python as

python install


A number of examples shows the capabilities of FINE.


MIT License

Copyright (C) 2016-2020 Lara Welder, Theresa Groß, Leander Kotzur, Robin Beer, Henrik Büsing, Dilara Caglayan, Thomas Grube, Heidi Heinrichs, Maximilian Hoffmann, Timo Kannengießer, Kevin Knosala, Felix Kullmann, Stefan Kraus, Jochen Linßen, Peter Markewitz, Lars Nolting, Jan Priesmann, Bismark Singh, Andreas Smolenko, Peter Stenzel, Chloi Syranidou, Johannes Thürauf, Michael Zier, Martin Robinius, Detlef Stolten

You should have received a copy of the MIT License along with this program. If not, see

About Us

Institut TSA

We are the Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3) belonging to the Forschungszentrum Jülich. Our interdisciplinary institute's research is focusing on energy-related process and systems analyses. Data searches and system simulations are used to determine energy and mass balances, as well as to evaluate performance, emissions and costs of energy systems. The results are used for performing comparative assessment studies between the various systems. Our current priorities include the development of energy strategies, in accordance with the German Federal Government’s greenhouse gas reduction targets, by designing new infrastructures for sustainable and secure energy supply chains and by conducting cost analysis studies for integrating new technologies into future energy market frameworks.

Contributions and Users

Within the BMWi funded project METIS we develop together with the RWTH-Aachen (Prof. Aaron Praktiknjo), the EDOM Team at FAU (PD Bismark Singh) and the Jülich Supercomputing Centre new methods and models within FINE.


Dr. Martin Robinius is teaching a course at TU Berlin in which he is introducing FINE to students.



This work was supported by the Helmholtz Association under the Joint Initiative "Energy System 2050 A Contribution of the Research Field Energy".

Helmholtz Logo


The FINE python package provides a framework for modeling, optimizing and assessing energy systems




No packages published