Présentation

Cette séance est une introduction à l’utilisation et à la programmation des classes externes de Thermoptim.

Elle est structurée en trois parties :

Elle complète la séance S07 de présentation générale de l’outil. Si vous ne connaissez pas encore Thermoptim, commencez par visualiser cette séance.

Les classes externes sont des éléments de code Java permettant à des utilisateurs de personnaliser leur environnement de travail en définissant leurs propres composants (transfos, mélangeurs et diviseurs) ou leurs propres corps, et facilite l’inter-opérabilité du progiciel avec l’extérieur, notamment avec d’autres applications développées sous Java.

Une fois créées, les classes externes s’intègrent dans les écrans de Thermoptim tout comme les éléments du noyau, et peuvent être utilisées pour modéliser des systèmes énergétiques complexes. Cette manière de faire permet de limiter le travail de modélisation et de bénéficier des fonctionnalités de l’environnement de Thermoptim, ce qui a pour effet de faciliter et sécuriser la modélisation.

Attention : Cette présentation date de l’époque où seule les versions de Thermoptim 1.3 à 1.5 étaient distribuées. Les nouvelles versions 2.5 à 2.8 diffusées depuis font appel à des bibliothèques externes nommées légèrement différemment : on a ajouté un 2 à leur nom pour les distinguer des anciennes. Ainsi extThopt.zip et extUser.zip deviennent respectivement extThopt2.zip et extUser2.zip. Cette séance sera mise à jour dès que possible.

Vous trouverez des informations complémentaires d’une part dans la petite note sur l’utilisation des classes externes téléchargeable à partir du lien ci-dessous, et d’autre part dans le troisième tome du manuel de référence du progiciel disponible sous format électronique dans le dossier doc du répertoire d’installation de Thermoptim, et directement accessible à partir du menu Aide du simulateur dans les dernières versions. Ce document présente de plus l’avantage d’avoir été mis à jour.

Pour programmer des classes externes, il vous sera indispensable de vous y référer.

(Séance réalisée le 14/04/05 et revue le 15/10/18 par Renaud Gicquel)

Composants externes

Composants externes

Corps externes

Utilisation pratique

Nous allons maintenant montrer comment utiliser en pratique une classe externe.

Nous montrerons :

Utilisation d’une transfo externe

Instanciation par défaut

Sélection de la classe

Instanciation de la classe choisie

Configuration de Thermoptim

Chargement d’extUser2.zip avec Winzip

Concepts de base

Nous allons maintenant présenter, pour ceux qui ne sont pas familiers du langage Java, quelques concepts de base qui seront par la suite utilisés régulièrement.

Nous expliquerons :

Ces explications étant nécessairement sommaires, vous trouverez des informations complémentaires dans le troisième tome du manuel de référence du progiciel.

Composants externes

Compilation d’une classe

Regroupement des classes par paquets

Archives des classes externes

Visualisateur de classes externes

Thermocoupleurs

Thermocoupleurs

Thermocoupleurs

Programmation

Nous allons maintenant montrer comment développer une classe externe.

Nous présenterons :

Environnement Java

L’environnement de développement Java que nous vous recommandons s’appelle Eclipse.

Le lien ci-dessous pointe sur la page du portail Thermoptim-UNIT où vous trouverez les explications vous permettant de l’installer.

Deux modes opératoires

Émulation de Thermoptim

Structure du mécanisme des classes externes

Classe SolarCollector

Classe SolarCollector

Calcul de la classe

Sauvegarde / relecture des paramètres

Nœuds externes

Enchaînement des opérations :

  1. vérification de la cohérence et mise à jour du nœud avant calcul
  2. lecture des paramètres sur l’écran du composant externe
  3. mise à jour des transfos connectées au nœud externe
  4. mise à jour et calcul des thermocoupleurs associés
  5. mise à jour de l’écran du composant externe
  6. sauvegarde et chargement des paramètres du modèle

Vérification de la cohérence