Les variables calculées
Les variables calculées vous permettent de créer de nouvelles données à partir de formules mathématiques appliquées sur vos variables existantes. Elles offrent une grande flexibilité pour analyser, transformer et enrichir vos données.
Les variables calculées étant un sujet à part entière, la documentation est découpée en trois pages :
- Comprendre les variables calculées (cette page) — le principe et les différents types de formules disponibles.
- Configurer une variable calculée — créer la variable, définir les périodes, le pas de temps de sortie et les variables d'entrée.
- Les formules Python — écrire des traitements personnalisés et utiliser l'assistant IA.
La vidéo ci-dessous utilise encore l'ancien moteur de formules R. La plateforme est désormais passée à Python — le code R présenté n'est plus utilisable. En revanche, la logique générale d'une variable calculée (inputs, pas de temps de sortie, périodes, sauvegarde) reste identique : la vidéo conserve donc une valeur pédagogique pour comprendre la mécanique d'ensemble. Une version Python de cette vidéo sera publiée prochainement.
Les types de formules
Avant de configurer une variable calculée, il est utile de connaître les types de formules disponibles. Le type choisi détermine la nature du calcul, les opérateurs autorisés et le comportement de la variable. Vous sélectionnerez l'un de ces types au moment de configurer votre variable calculée.
Formule arithmétique
La formule arithmétique génère un résultat numérique basé sur les opérations mathématiques.
Pour utiliser une variable dans la formule, écrivez simplement le nom de la variable entre
crochets (ex : [Seuil_1]). Les opérateurs autorisés sont +,
-, / et *, ainsi que les parenthèses ( et
).
Exemple 1 :
[Variable_1] * [Constante_1]Exemple 2 :
( [Variable_1] + [Variable_2] ) / [Variable_1]
Formule conditionnelle
Renvoie un résultat binaire, où 'oui' = 1 et 'non' = 0, en fonction de la condition énoncée dans la formule.
- Si la condition est vérifiée, le résultat sera 1
- Si la condition n'est pas vérifiée, le résultat sera 0
Vous pouvez comparer deux opérandes avec >, <,
<=, >= ou =, et combiner plusieurs conditions
avec les opérateurs logiques || (ou), && (et) ou
! (inverse).
Ce type de formule sera particulièrement pertinent pour la mise en place de nouvelles alarmes.
Formule de consommation
Suit l'évolution d'une variable sur la période donnée avec un pas de temps de sortie temporel obligatoire. Cette formule est dédiée au monitoring de compteurs et ne peut donc pas être négative.
Ce type de formule ne nécessite donc pas d'opérateurs.
Gestion des retours à zéro : Interpolation automatique des points de données manquants par régression linéaire.
Formule de temps de fonctionnement
Indique le temps pendant lequel une condition a été remplie.
Cette condition peut être variable.
L'opérateur utilisé pour cette formule est « Supérieur ou égal ».
Formule Python
Permet d'écrire des traitements personnalisés qui dépassent les capacités des formules natives : filtres horaires complexes (HP/HC/Pointe), alarmes comparatives (J-7, S-1), moyennes dynamiques tolérantes aux capteurs absents, etc.
C'est le type le plus puissant, mais aussi le plus technique. Il dispose de sa propre page : Les formules Python.
Une fois le type de formule choisi, rendez-vous sur Configurer une variable calculée pour la mise en place pas à pas.
