(PR33) Documentation/Tutorial_1_Unit_Commitment (jupyter notebook)

[GuillaumeMaistre]

This PR is under progress and it is not ready to be reviewed

This PR has the following changes :

• add jupyter notebook using GEMSPy with the unit commitment example

[GuillaumeMaistre]

I added a new environment ; the tutorial_environment containing the needed libraries for running this jupyter notebook (especially GEMSPy)

[aoustry]

General comments :

• Could avoid duplicating the library of models ?
• please rename the folder "QSE_2_Unit_Commitment_tutorial" into "Tutorial_Unit_Commitment_with_GemsPy". In any case, please avoid the reference to the QSE example, a bit misleading.
• Is it really a need to create an "input" folder in the Github repo, below the aforementioned folder?
• How can we access to this tutorial from the GEMS website ? Where do you suggest to place the tutorial in the website.
• Please add "Spilled energy" to the Figures.

[aoustry]

Why duplicating this file? Couldn't we just use the antares_legacy_models library from the reference folder ?

[GuillaumeMaistre]

because we need to add expec function

[aoustry]

I suggest deleting this file, since the system is created from scratch with GemsPy

[GuillaumeMaistre]

I deleted them

[aoustry]

I have several comments on the Jupyter Notebook:

• "This tutorial shows the different commands for using GEMSPy python package for modeling and simulating an Unit Commitment problem." => Add link to GemsPy
• "We use in this tutorial the library, antares-legacy-models, present in GEMS repo" => "We use in this tutorial the reference library of models called antares-legacy-models"
• "An area is the central node in the electrical grid where different components connect." => "In the library of models used here, an area is a component representing an energy balance constraint ; several types of components (production, load, storage, links...) might be connected to it."
• Use € rather than $
• Labels in the three Graphs "Thermal Generation and... etc" : "Thermal" => "Thermal Generation", "Unsupply" => "Unsupplied" energy.
• "The wind_farm has a fluctuated power generation" => "The wind_farm has a variable power generation" and same for solar_farm.
• Results visualization : why load, wind and farm are not printed?
• "Interconnect Wind Farm and Solar Farm" => "Add Variable Renewable Energies in the system"
• In the last section, can you add positive starting_cost and fixed_cost to the thermal cluster ? (ex: 20€ and 10 € respectively). This will force the UC to be a bit more realistic. Please don't forget to add this in the description paragraph above the code.
• nb_units_max_variation_forward and nb_units_max_variation_backward should be equal to nb_units_max for both thermal clusters created.

[GuillaumeMaistre]

• "This tutorial shows the different commands for using GEMSPy python package for modeling and simulating an Unit Commitment problem." => Add link to GemsPy
• "We use in this tutorial the library, antares-legacy-models, present in GEMS repo" => "We use in this tutorial the reference library of models called antares-legacy-models"
• "An area is the central node in the electrical grid where different components connect." => "In the library of models used here, an area is a component representing an energy balance constraint ; several types of components (production, load, storage, links...) might be connected to it."
• Use € rather than $
• Labels in the three Graphs "Thermal Generation and... etc" : "Thermal" => "Thermal Generation", "Unsupply" => "Unsupplied" energy.
• "The wind_farm has a fluctuated power generation" => "The wind_farm has a variable power generation" and same for solar_farm.
• Results visualization : why load, wind and farm are not printed?
• "Interconnect Wind Farm and Solar Farm" => "Add Variable Renewable Energies in the system"
• In the last section, can you add positive starting_cost and fixed_cost to the thermal cluster ? (ex: 20€ and 10 € respectively). This will force the UC to be a bit more realistic. Please don't forget to add this in the description paragraph above the code.
• nb_units_max_variation_forward and nb_units_max_variation_backward should be equal to nb_units_max for both thermal clusters created.

[GuillaumeMaistre]

General comments :

• Could avoid duplicating the library of models ?
• please rename the folder "QSE_2_Unit_Commitment_tutorial" into "Tutorial_Unit_Commitment_with_GemsPy". In any case, please avoid the reference to the QSE example, a bit misleading.
• Is it really a need to create an "input" folder in the Github repo, below the aforementioned folder?
• How can we access to this tutorial from the GEMS website ? Where do you suggest to place the tutorial in the website.
• Please add "Spilled energy" to the Figures.

• Could avoid duplicating the library of models ? => I have an error by using the new antares-legacy-models library
• please rename the folder "QSE_2_Unit_Commitment_tutorial" into "Tutorial_Unit_Commitment_with_GemsPy". In any case, please avoid the reference to the QSE example, a bit misleading. => I changed it
• Is it really a need to create an "input" folder in the Github repo, below the aforementioned folder? => I deleted the inputs/ folder, all the files are in the same dedicated study folder
• How can we access to this tutorial from the GEMS website ? Where do you suggest to place the tutorial in the website. => I added a link to the jupyter notebook in the getting started section
• Please add "Spilled energy" to the Figures. => I added them