Merge pull request #26 from MPavicevic/master

Addition of use cases of Dispa-SET to the docs by Matija (to be completed)

Docs/casebalkans.rst

@@ -0,0 +1,118 @@
+.. _casebalkans:
+
+Dispa-SET for the Balkans region
+================================
+
+Description
+-----------
+This is input data of the Dispa-SET model, applied to the Balkans Region
+
+Countries included in different scenarios are show in the table [1]_ [2]_ [3]_ [4]_ :
+
++-----------+------+------+------+------+
+| Countries | 2010 | 2015 | 2020 | 2030 |
++===========+======+======+======+======+
+|Albania    | [O]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Bosnia and | [O]  | [O]  | [O]  | [O]  |
+|Herzegovina|      |      |      |      |
++-----------+------+------+------+------+
+|Croatia    | [X]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Kosovo     | [O]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Macedonia  | [O]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Montenegro | [O]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Serbia     | [O]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+|Slovenia   | [X]  | [O]  | [O]  | [O]  |
++-----------+------+------+------+------+
+
+The model has the ability to describe every single unit, or a cluster of units powered by the same fuel type and technology, with a high level of detail can be modelled together with a large number of RES units with separate hourly distribution curves.
+
+Features
+--------
+
+The model is expressed as an optimization problem. Continuous variables include the individual unit dispatched power, the shedded load and the curtailed power generation. The binary variables are the commitment status of each unit. The main model features can be summarized as follows:
+
+- Minimum and maximum power for each unit
+- Power plant ramping limits
+- Reserves up and down
+- Minimum up/down times
+- Load Shedding
+- Curtailment
+- Pumped-hydro storage
+- Non-dispatchable units (e.g. wind turbines, run-of-river, etc.)
+- Start-up, ramping and no-load costs
+- Multi-nodes with capacity constraints on the lines (congestion)
+- Constraints on the targets for renewables and/or CO2 emissions
+- Yearly schedules for the outages (forced and planned) of each units
+- CHP power plants and thermal storage
+
+The demand is assumed to be inelastic to the price signal. The MILP objective function is therefore the total generation cost over the optimization period. 
+
+Quick start
+-----------
+
+If you want to download the latest version from github for use or development purposes, make sure that you have git and the [anaconda distribution](https://www.continuum.io/downloads) installed and type the following::
+
+	git clone https://github.com/energy-modelling-toolkit/Dispa-SET.git
+	cd Dispa-SET
+	conda env create  # Automatically creates environment based on environment.yml
+	source activate dispaset # in Windows: activate dispaset
+	pip install -e . # Install editable local version
+
+The above commands create a dedicated environment so that your anconda configuration remains clean from the required dependencies installed.
+
+To check that everything runs fine, you can build and run a test case by typing::
+
+	dispaset -c ConfigFiles/ConfigTest.xlsx build simulate
+
+Make sure that the path is changed to local Dispa-SET folder in folowing scripts (the procedure is provided in the scripts)::
+
+	build_and_run.py
+	read_results.py
+
+  
+Documentation
+-------------
+The general documentation of the Dispa-SET model and the stable releases are available on the main Dispa-SET website: http://www.dispaset.eu
+
+Licence
+-------
+Dispa-SET is a free software licensed under the “European Union Public Licence" EUPL v1.2. It can be redistributed and/or modified under the terms of this license.
+
+Important results
+-----------------
+
+.. image:: figures/Balkans_capacity.png
+
+.. image:: figures/Balkans_generation.png
+
+Main developpers
+----------------
+- Matija Pavičević (KU Leuven) - gathered and analysed the data, performed the computations, analysed and verified the results
+- Sylvain Quoilin (University of Liège, KU Leuven) -  designed the model and the computational framework, verified the results 
+- Andreas Zucker (Joint Research Centre, European Commission) - supervised the whole process
+
+References
+----------
+More details regarding the model and its implementation are available in the following publications
+
+.. [1] Pavičević, M., Kavvadias, K. & Quoilin, S. (2018). Impact of model formulation on power system simulations - Example with the Dispa-SET Balkans model, EMP-E conference 2018: Modelling Clean Energy Pathways, Brussels.
+.. [2] Pavičević, M., Quoilin, S. & Pukšec, T., (2018). Comparison of Different Power Plant Clustering Approaches for Modeling Future Power Systems, Proceedings of the 3rd SEE SDEWES Conference, Novi Sad.
+.. [3] Tomić, I., Pavičević, M., Quoilin, S., Zucker, A., Pukšec, T., Krajačić. G. & Duić, N., (2017). Applying the Dispa-SET model on the seven countries from the South East Europe. 8th Energy Planning and Modeling of Energy Systems-Meeting, Belgrade. https://bib.irb.hr/prikazi-rad?rad=901595
+.. [4] Pavičević, M., Tomić, I., Quoilin, S., Zucker, A., Pukšec, T., Krajačić. G. & Duić, N., (2017). Applying the Dispa-SET model on the Western Balkans power systems. Proceedings of the 2017 12th SDEWES Conference, Dubrovnik. http://hdl.handle.net/2268/215095
+
+Other contributors
+------------------
+- Ivan Tomić (University of Zagreb) - gathered and analysed the initial data
+- Tomislav Pukšec (University of Zagreb) - analysed the inital results
+- Goran Krajačić (University of Zagreb) - supervised inital project
+- Neven Duić (University of Zagreb) - supervised inital project 
+
+
+.. _Balkans: https://github.com/balkans-energy-modelling/DispaSET-for-the-Balkans
+

Docs/casebelarus.rst

@@ -0,0 +1,94 @@
+.. _casebelarus:
+
+Dispa-SET for the Belarus
+=========================
+
+Description
+-----------
+Planning the future: Integrating renewable energy sources in the Belarusian power system
+
+Background
+----------
+The Belarusian energy sector is mainly running on fossil fuels. Approximately two third of the country’s energy production is covered by natural gas, which is mainly imported from Russia. Therefore, increasing the share of renewables in the energy balance has become one of the priority areas of the economic policy of the Belarusian government. In this regard, the objective of this work is the development of smart power and heating systems that can handle increased shares of renewable energy in the Belarusian system. This research focuses on several aspects such as balancing issues, flexibility requirements and congestion management in Belarusian grid. 
+
+Methods and Features
+--------------------
+The Belarusian energy system has been modeled in Dispa-SET, an open-source unit commitment and optimal dispatch model focused on the balancing and flexibility problems in European grids. A reference and several future scenarios with high share of renewable energy sources were created. This case study analysis provides insights on the ability to integrate as much renewables as possible into the system and to check its impact on the price of runing the system.
+
+The model is expressed as an optimization problem. Continuous variables include the individual unit dispatched power, the shedded load and the curtailed power generation. The binary variables are the commitment status of each unit. The main model features can be summarized as follows:
+
+- Minimum and maximum power for each unit
+- Power plant ramping limits
+- Reserves up and down
+- Minimum up/down times
+- Load Shedding
+- Curtailment
+- Pumped-hydro storage
+- Non-dispatchable units (e.g. wind turbines, run-of-river, etc.)
+- Start-up, ramping and no-load costs
+- Multi-nodes with capacity constraints on the lines (congestion)
+- Constraints on the targets for renewables and/or CO2 emissions
+- Yearly schedules for the outages (forced and planned) of each units
+- CHP power plants and thermal storage
+
+The demand is assumed to be inelastic to the price signal. The MILP objective function is therefore the total generation cost over the optimization period. 
+
+Quick start
+-----------
+
+If you want to download the latest version from github for use or development purposes, make sure that you have git and the [anaconda distribution](https://www.continuum.io/downloads) installed and type the following::
+
+	git clone https://github.com/energy-modelling-toolkit/Dispa-SET.git
+	cd Dispa-SET
+	conda env create  # Automatically creates environment based on environment.yml
+	source activate dispaset # in Windows: activate dispaset
+	pip install -e . # Install editable local version
+
+The above commands create a dedicated environment so that your anconda configuration remains clean from the required dependencies installed.
+
+To check that everything runs fine, you can build and run a test case by typing::
+
+	dispaset -c ConfigFiles/ConfigTest.xlsx build simulate
+
+Make sure that the path is changed to local Dispa-SET folder in folowing scripts (the procedure is provided in the scripts)::
+
+	build_and_run.py
+	read_results.py
+
+  
+Documentation
+-------------
+The general documentation of the Dispa-SET model and the stable releases are available on the main Dispa-SET website: http://www.dispaset.eu
+
+Licence
+-------
+Dispa-SET is a free software licensed under the “European Union Public Licence" EUPL v1.2. It can be redistributed and/or modified under the terms of this license.
+
+Results
+-------
+In this model the potential for integration of renewables in the power system of Belarus was examined. The results of this study indicate that the current grid infrastructure can utilize up to 30% of the energy generated by renewables without causing any balancing and stability issues while applying heat pumps, thermal storage and bio-waste-based technologies.
+
+Conclusions
+-----------
+The analysis performed in this work has demonstrated that the utilization of renewables could greatly reduce the use of fossil fuels and hence reduce the annual CO2 emissions by about 5 million tons in the Belarusian energy sector. This way the high dependence on external energy markets should decrease. The designed scenarios should help to realize a Belarusian Energy and Environmental Policy where the share of renewables should reach 30%.
+
+
+Highlights
+----------
+
+.. .. image:: figures/Balkans_capacity.png
+
+.. .. image:: figures/Balkans_generation.png
+
+Main developpers
+----------------
+- Matija Pavičević (KU Leuven) - gathered and analysed the data, performed the computations, analysed and verified the results
+- Darya Muslina (Belarusian National Technical University) - gathered and analysed the data
+- Yuliya Stanetskaya (Belarusian National Technical University) - gathered and analysed the data
+
+References
+----------
+More details regarding the model and its implementation are available in the following publications
+
+
+

Docs/caseeu28.rst

@@ -0,0 +1,95 @@
+.. _caseeu28:
+
+Dispa-SET for the EU28
+======================
+
+Description
+-----------
+.. warning::
+    The Dispa-SET for the EU28 is currently in developmend and will be released soon
+
+This is input data of the Dispa-SET model, applied to the EU28 member states
+
+.. Countries included in different scenarios are show in the table [1]_ [2]_ [3]_ [4]_ :
+
+The power plants in the model are represented as a cluster of units powered by the same fuel type and technology. They can be modelled together with a large number of RES units with separate hourly distribution curves.
+
+Features
+--------
+
+The model is expressed as an optimization problem. Continuous variables include the individual unit dispatched power, the shedded load and the curtailed power generation. The binary variables are the commitment status of each unit. The main model features can be summarized as follows:
+
+- Minimum and maximum power for each unit
+- Power plant ramping limits
+- Reserves up and down
+- Minimum up/down times
+- Load Shedding
+- Curtailment
+- Pumped-hydro storage
+- Non-dispatchable units (e.g. wind turbines, run-of-river, etc.)
+- Start-up, ramping and no-load costs
+- Multi-nodes with capacity constraints on the lines (congestion)
+- Constraints on the targets for renewables and/or CO2 emissions
+- Yearly schedules for the outages (forced and planned) of each units
+- CHP power plants and thermal storage
+
+The demand is assumed to be inelastic to the price signal. The MILP objective function is therefore the total generation cost over the optimization period. 
+
+Quick start
+-----------
+
+If you want to download the latest version from github for use or development purposes, make sure that you have git and the [anaconda distribution](https://www.continuum.io/downloads) installed and type the following::
+
+	git clone https://github.com/energy-modelling-toolkit/Dispa-SET.git
+	cd Dispa-SET
+	conda env create  # Automatically creates environment based on environment.yml
+	source activate dispaset # in Windows: activate dispaset
+	pip install -e . # Install editable local version
+
+The above commands create a dedicated environment so that your anconda configuration remains clean from the required dependencies installed.
+
+To check that everything runs fine, you can build and run a test case by typing::
+
+	dispaset -c ConfigFiles/ConfigTest.xlsx build simulate
+
+Make sure that the path is changed to local Dispa-SET folder in folowing scripts (the procedure is provided in the scripts)::
+
+	build_and_run.py
+	read_results.py
+
+  
+Documentation
+-------------
+The general documentation of the Dispa-SET model and the stable releases are available on the main Dispa-SET website: http://www.dispaset.eu
+
+Licence
+-------
+Dispa-SET is a free software licensed under the “European Union Public Licence" EUPL v1.2. It can be redistributed and/or modified under the terms of this license.
+
+Important results
+-----------------
+
+.. .. image:: figures/Balkans_capacity.png
+
+.. .. image:: figures/Balkans_generation.png
+
+Main developpers
+----------------
+- Sylvain Quoilin (University of Liège, KU Leuven)
+- Konstantinos Kavvadias (European Commission, Institute for Energy and Transport)
+- Matija Pavičević (KU Leuven)
+
+References
+----------
+More details regarding the model and its implementation are available in the following publications
+
+.. .. [1] Pavičević, M., Kavvadias, K. & Quoilin, S. (2018). Impact of model formulation on power system simulations - Example with the Dispa-SET Balkans model, EMP-E conference 2018: Modelling Clean Energy Pathways, Brussels.
+.. .. [2] Pavičević, M., Quoilin, S. & Pukšec, T., (2018). Comparison of Different Power Plant Clustering Approaches for Modeling Future Power Systems, Proceedings of the 3rd SEE SDEWES Conference, Novi Sad.
+.. .. [3] Tomić, I., Pavičević, M., Quoilin, S., Zucker, A., Pukšec, T., Krajačić. G. & Duić, N., (2017). Applying the Dispa-SET model on the seven countries from the South East Europe. 8th Energy Planning and Modeling of Energy Systems-Meeting, Belgrade. https://bib.irb.hr/prikazi-rad?rad=901595
+.. .. [4] Pavičević, M., Tomić, I., Quoilin, S., Zucker, A., Pukšec, T., Krajačić. G. & Duić, N., (2017). Applying the Dispa-SET model on the Western Balkans power systems. Proceedings of the 2017 12th SDEWES Conference, Dubrovnik. http://hdl.handle.net/2268/215095
+
+Other contributors
+------------------
+
+
+

Docs/cases.rst

@@ -0,0 +1,38 @@
+.. _cases:
+
+Case Studies
+============
+
+In the past years, Dispa-SET has been used in various scientific works covering different geographical areas and with different focus points. It is originally designed to simulate EU countries (one node per country) but has also been applied to other regions such as Western Africa, Bolivia or the Balkans. The model includes the constraints linked to each generation unit (min/max power, ramping rates, efficiencies, storage capacities, etc.), to the interconnections and to the power and thermal demands. It uses high-resolution time series for the demands, renewable generation and outages in each simulated country.
+
+The case studies for which scientific analysis has been carried out are summarized hereunder:
+
+.. toctree::
+   :maxdepth: 1
+
+   caseeu28
+   casebalkans
+   casebelarus
+
+External links
+--------------
+
+* `EU28`_ DispaSET applied to the EU28 member states
+* `Balkans`_ Western Balkans and neighbouring countries
+* `Belarus`_ Planning the future: Integrating renewable energy sources in the Belarusian power system
+* `Belgium`_ Coupling a power system model to a building model to evaluate the flexibility potential of DSM at country level
+* `Bolivia`_ Techno-economic assessment of hing renewable energy source penetration in the Bolivian interconnected electric system
+* `Central Europe`_ Evaluating flexibility and adequacy in future EU power systems: model coupling and long-term forecasting
+* `Netherlands`_ Evaluating the impact of EV charging demand on the Dutch energy system
+
+
+.. _EU28:
+.. _Balkans: https://github.com/balkans-energy-modelling/DispaSET-for-the-Balkans
+.. _Bolivia: 
+.. _Netherlands:
+.. _Central Europe: 
+.. _Belgium:
+.. _Belarus: 
+
+
+

Docs/conf.py

@@ -32,7 +32,7 @@
 try:
     __release__ = check_output(["git", "describe"]).strip()
 except:
-    __release__ = None
+    __release__ = ''
 
 # -- General configuration ------------------------------------------------
 

Docs/index.rst

@@ -58,6 +58,7 @@ Contents
    formulations
    implementation
    data
+   cases
    developers
    DispaSET