OMEGAlpes is a linear energy systems modelling library
OMEGAlpes Lib for linear energy systems modelling
OMEGAlpes stands for Generation of Optimization Models As Linear Programming for Energy Systems.
OMEGAlpes aims to be an energy systems modelling tool for linear optimisation (LP, MILP).
We are happy that you will use or develop the OMEGAlpes library.
It is an Open Source project located on GitLab at https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes
OMEGAlpes library :
Please have a look to OMEGAlpes presentation : https://omegalpes.readthedocs.io/en/latest/
The library is available at: https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes.git
Examples and article case studies :
Please have a look to examples : https://omegalpes-examples.readthedocs.io/en/latest/
The OMEGAlpes Examples folder is available at: https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes-examples.git
A scientific article presenting OMEGAlpes with a detailed example is available here: https://hal.archives-ouvertes.fr/hal-02285954v1
Please subscribe to our mailing lists :
- for our newsletters: https://groupes.renater.fr/sympa/subscribe/omegalpes-news
- as an OMEGAlpes' developer: https://groupes.renater.fr/sympa/subscribe/omegalpes-users
Please use the git issues system to report an error: https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes.git
Otherwise you can also contact de developer team using the following email adress: firstname.lastname@example.org
You can install the library as a user or as a developer. Please follow the corresponding installation steps below.
You can use any development environment If you use Pycharm, some indications below will help you for the installation https://www.jetbrains.com/pycharm/
Please install Python 3.6 https://www.python.org/downloads/
Installation as a user
Please install OMEGAlpes Lib with pip using the command prompt.
If you are admin on Windows or working on a virtual environment
pip install omegalpes
If you want a local installation or you are not admin
pip install --user omegalpes
If you are admin on Linux:
sudo pip install omegalpes
Then, you can download (or clone) the OMEGAlpes Examples folder (repository) at : https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes-examples
Launch the examples (with Pycharm for instance) to understand how the OMEGAlpes Lib works. Remember that the examples are detailed at : https://omegalpes-examples.readthedocs.io/en/latest/
Enjoy your time using OMEGAlpes !
Installation as a developer and local branch creation
Create a new folder in the suitable path, name it as you wish for example : OMEGAlpes
Clone the OMEGAlpes library repository
git clone https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes.git
On the Pycharm window, click on "Check out from version control" then choose "Git".
A "clone repository" window open.
Copy the following link into the URL corresponding area:
Copy the path of the new folder created just before.
Test if the connection to the git works and if it works click on "Clone".
Once OMEGAlpes is cloned, you must be able to see the full OMEGAlpes library on Pycharm or on another development environment.
If the connection does not work and if you are working with local protected network, please try again with the wifi.
First, choose or change your project interpreter
Click on the yellow warning link or go to "File", "settings...", "Project Interpreter"
- either select the "Python 3.6" project interpreter but you may change the version of some library that you could use for another application
- either create a virtual environment in order to avoid this problem (recommended).
Click on the star wheel near the project interpreter box. Click on "add...".
Select "New environment" if it not selected.
The location is pre-filled, if not fill it with the path of the folder as folder_path/venv
Select "Python 3.6" as your base interpreter
Then click on "Ok"
You can install the library on developing mode using the following command in command prompt once your are located it on the former folder. If you are calling OMEGAlpes library in another project, the following command enables you to refer to the OMEGAlpes library you are developing
python setup.py develop
If it is not already done, install the library requirements.
pip install <library_name>
If required, the command to upgrade the library is :
pip install --upgrade <library_name>
You should still have a yellow warning.
- install automatically the libraries clicking on the yellow bar
- install automatically the library using pip with Pycharm on "File", "settings...", "Project Interpreter", "+", and choosing the required library as indicated in the Library Installation Requirements part
Finally, you can create your own local development branch.
git branch <branch_name>
By default you are on a local branch named master.
Click on "Git: master" located on the bottom write of Pycharm
Select "+ New Branch"
Name the branch as you convenience for instance "dev_your_name"
Do not forget to "rebase" regularly to update your version of the library.
git rebase origin
To do so, click on "VCS", "Git", "Fetch" Then, click on your branch name on the bottom write of the Pycharm window select "Origin/master" and click on "Rebase current onto selected"
For contribution, have a look to CONTRIBUTING.md Once your code is ready for contribution, do a last rebase (see 7.) and then, request for a merge with the master branch in OMEGAlpes gitlab https://gricad-gitlab.univ-grenoble-alpes.fr/omegalpes/omegalpes.git
If you want to have access to other examples and study cases, please have a look to the user's installation.
Enjoy your time developing OMEGAlpes!
Library Installation Requirements
PuLP > 1.6.10
Matplotlib > 2.2.2
Numpy > 1.14.2
Pandas > 0.22.0
B. DELINCHANT, S. HODENCQ, Y. MARECHAL, L. MORRIET, C. PAJOT, V. REINBOLD, F. WURTZ
Univ. Grenoble Alpes, CNRS, Grenoble INP, G2Elab, CEA, UniversitÃ© Paris-Sud
This work has been partially supported by the CDP Eco-SESA receiving fund from the French National Research Agency in the framework of the "Investissements dâ€™avenir" program (ANR-15-IDEX-02)
This code is under the Apache License, Version 2.0
This library has been tested using
- PyCharm 2018.2.4
- Python 3.6.0
- pip 18.1
- setuptools 39.1.0
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size omegalpes-0.2.1-py3-none-any.whl (77.5 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size omegalpes-0.2.1.tar.gz (59.7 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for omegalpes-0.2.1-py3-none-any.whl