Skip to content

README_FR.md

Latest commit

 

History

History
92 lines (69 loc) · 5.47 KB

README_FR.md

File metadata and controls

92 lines (69 loc) · 5.47 KB

Eoles

Eoles est un modèle d'optimisation de l'investissement et de l'exploitation du système énergétique en France cherchant à minimiser le coût total tout en assurant une demande en énergie exogène.
Voici une présentation d'une version antérieure du modèle : http://www.centre-cired.fr/quel-mix-electrique-optimal-en-france-en-2050/
La plupart des versions du modèle, ainsi que des articles les utilisant, sont présentées dans https://www.centre-cired.fr/the-eoles-family-of-models/

Installer le code et les dépendances

Récupération du code :

Si vous n'avez pas installé Git sur votre ordinateur, vous pouvez téléchargez le dossier zip de Github (latest release) ou Zenodo, dans le format que vous souhaitez. Pour obtenir le dernier build, vous pouvez récupérer les fichiers de ce Github à travers la commande :
git clone https://github.com/CIRED/EOLES.git
Un dossier sera créé dans le répertoire courant avec tout les fichiers contenus dans ce Github. \

Installation des dépendances

Pour pouvoir lancer le modèle vous aurez besoin d'installer certaines dépendances dont ce programme à besoin pour fonctionner :

  • Python : Python est un langage de programmation interprété, utilisé avec Pyomo il va permettre de modéliser Eoles.
    Vous pouvez télécharger la dernière version sur le site dédié : https://www.python.org/downloads/
    Ensuite il vous suffit de l'installer sur votre ordinateur.
    Si vous comptez installer Conda ou si vous avez installé Condé sur votre ordinateur, Python à des chances d'être déjà installé. Le modèle nécessite python3. Nous recommendons d'utiliser une version utlérieure à python3.10 (les versions antérieures à 3.9 n'ont pas été testées)

  • Conda ou Pip selon votre préférence : Conda et Pip sont des gestionnaires de paquets pour Python. Conda est recommendé.

    • Conda
      Vous pouvez retrouver toutes les informations nécéssaires pour télécharger et installer Conda ici:
      https://docs.conda.io/projects/conda/en/latest/user-guide/install/
      Attention à bien choisir la version de Conda en accord avec la version de Python !
      Vous pouvez installer Miniconda qui est une version minimale de Conda,
      cela vous permettra de ne pas installer tous les paquets compris dans Conda,
      mais seulement ceux qui sont nécéssaires.
    • Pip
      Vous pouvez retrouver toutes les informations nécéssaires pour télécharger et installer Pip ici :
      https://pip.pypa.io/en/stable/installing/
      Pip est également installé si vous avez installé Conda.

  • Installer les dépendances avec Conda: Déplacez-vous jusqu'au dossier de votre choix Créer l'environnement et installer les dépendances: conda env create -f environment.yml Activer l'environnement : conda activate envEOLES Si vous souhaitez utiliser Jupyter Notebook : Utiliser conda install -c anaconda ipykernel and python -m ipykernel install --user --name=envEOLES L'environnement sera alors disponible dans la liste des kernel.

  • Installer les dépendances avec Pip: Créer un environnement virtuel: python -m venv envEOLES Si vous tuilisez un autre nom pour l'environnement et avez prévu d'envoyer vos modifications vers le github, souvenez-vous d'exclure le dossier de l'environnement des commit. Activer l'environnement : Windows : envEOLES\Scripts\activate macOS/Linux: source envEOLES/bin/activate Installer les dépendances : pip install -r requirements.txt

  • Solveur : Le solveur que ce modèle utilise est le solveur Gurobi, bien plus rapide que le solveur Cbc.
    Des licenses gratuites sont mises à dispositions pour les chercheurs et étudiants. Pour utiliser Gurobi :

Utilisation du modèle :

Le modèle Eoles est écrit sous forme de classe contenue dans le package modelEoles.py.
Plusieurs fonctions utilitaires (pour l'initialisation ou pour générer des graphiques) sont incluses dans le package utils.py.
Un fichier .py d'exemple est fourni, et montre comment : importer la classe ModelEOLES, en créer un instance avec un fichier de configuration donné, et utiliser les différentes méthodes pour construire et résoudre le modèle et extraire les résultats.

Données d'entrées

Des examples de données d'entrée permettant d'utiliser example.py sont fournies dans le dossier inputs et sourcés dans le fichier Sources.xml.
Le chemin d'accès à chaque fichier de donnée peut être modifié dans les fichier de configuration.
Des profils de demande et de production supplémentaires peuvent être trouvés dans ce dépôt Zenodo

Le format attendu pour les données d'entrée est clarifié pour chaque type (constante ou profil) dans la fonction utilitaire associée dans utils.py.

La version originale de ce README a été écrite par Quentin Bustarret.
Vous pourrez trouver les anciennes versions du modèle (code et articles pour lesquels elles ont été utilisées) sur cette page web : https://www.centre-cired.fr/the-eoles-family-of-models/