Guide de Démarrage Rapide

Ce guide vous permet de commencer à utiliser EnergySystemModels en quelques minutes.

Installation 

Méthode standard 

Installez la bibliothèque via pip :

pip install energysystemmodels

Environnement virtuel (recommandé)

# Créer un environnement virtuel
python -m venv .venv

# Activer l'environnement (Windows)
.venv\Scripts\activate

# Activer l'environnement (Linux/Mac)
source .venv/bin/activate

# Installer la bibliothèque
pip install energysystemmodels

Astuce

L’utilisation d’un environnement virtuel est recommandée pour éviter les conflits de dépendances.

Principe d’utilisation 

EnergySystemModels suit un modèle de programmation orienté objet simple et cohérent.

Workflow en 4 étapes 

Workflow standard

Créer un objet représentant un composant énergétique
Définir les paramètres d’entrée (températures, pressions, débits, etc.)
Appeler la méthode calculate() pour effectuer les calculs
Accéder aux résultats via les attributs de l’objet ou le DataFrame

Exemple simple 

Voici un exemple minimal pour illustrer le principe :

from HeatTransfer import CompositeWall

# 1. Créer l'objet
wall = CompositeWall.Object(he=23, hi=8, Ti=20, Te=-10, A=10)

# 2. Définir la structure (ajouter des couches)
wall.add_layer(thickness=0.20, material='Parpaings creux')
wall.add_layer(thickness=0.05, material='Polystyrène')
wall.add_layer(thickness=0.02, material='Plâtre')

# 3. Calculer
wall.calculate()

# 4. Accéder aux résultats
print(f"Résistance thermique : {wall.R_total:.3f} m².K/W")
print(f"Flux thermique : {wall.Q:.2f} W")
print(wall.df)  # DataFrame avec tous les résultats

Voir aussi

Pour plus d’exemples, consultez Usage

Modules disponibles 

La bibliothèque est organisée en modules thématiques :

Transfert thermique 

Transfert de chaleur

Calculs thermiques pour murs, tuyauteries, échangeurs

Systèmes thermodynamiques 

Cycles thermodynamiques

Modélisation de cycles frigorifiques, pompes à chaleur, compresseurs

Systèmes HVAC 

Centrales de traitement d’air (CTA)	Simulation complète de CTA avec batteries, humidification, récupération
Hydraulique	Calculs de pertes de charge, dimensionnement de pompes et vannes

Optimisation énergétique 

Analyse énergétique

Analyse Pinch, IPMVP, optimisation d’intégration thermique

Données et production 

Données météo	Récupération de données climatiques en temps réel ou historiques
Production solaire	Simulation de production photovoltaïque

Facturation et certificats 

Facturation

Calcul du TURPE, certificats d’économies d’énergie (CEE)

Unités et conventions 

Important

Toutes les entrées et sorties utilisent le Système International (SI) avec ces unités par défaut :

Grandeur physique	Unité	Symbole
Température	Degré Celsius	°C
Pression	Bar	bar
Débit massique	Kilogramme par seconde	kg/s
Débit volumique	Mètre cube par heure	m³/h
Puissance	Kilowatt	kW
Énergie	Kilowatt-heure	kWh

Avertissement

Ne mélangez pas les unités (par exemple °C et K, ou bar et Pa) dans les calculs.

Structure des résultats 

Les résultats sont accessibles de deux manières :

Méthode 1 : Attributs de l’objet 

Accès direct aux propriétés calculées :

from ThermodynamicCycles.Source import Source

source = Source.Object()
source.Pi_bar = 5.0
source.fluid = "R134a"
source.calculate()

# Accès direct
print(source.h_outlet)  # Enthalpie
print(source.T_outlet)  # Température

Méthode 2 : DataFrame pandas 

Accès tabulaire pour analyse et export :

# Tableau complet des résultats
print(source.df)

# Accès à une colonne spécifique
print(source.df['h[J/kg]'])

# Export vers Excel
source.df.to_excel('resultats.xlsx', index=False)

Astuce

Les DataFrames pandas permettent une manipulation et analyse facile des résultats.

Pour aller plus loin 

Documentation détaillée 

Consultez les sections spécialisées :

Usage - Guide d’utilisation complet
API Reference - Référence API détaillée
1. Transfert de chaleur - Transfert de chaleur

2. Cycles thermodynamiques - Cycles thermodynamiques
3. Centrales de Traitement d’Air - Centrales de traitement d’air
6. Analyse de pincement - Analyse Pinch

Ressources et support 

Liens utiles 

Ressource	Lien
📚 Documentation en ligne	https://energysystemmodels-fr.readthedocs.io/
💻 Code source	https://github.com/ZoheirHADID/EnergySystemModels
📦 PyPI	https://pypi.org/project/energysystemmodels/
🐛 Issues et support	https://github.com/ZoheirHADID/EnergySystemModels/issues

Besoin d’aide ?

Comment obtenir de l’aide

Consultez la API Reference pour la référence complète
Parcourez les exemples dans Usage
Vérifiez les Issues GitHub
Créez une nouvelle issue avec un exemple minimal reproductible