TH NextGen :Constructeur de Tag - Formule

La fonctionnalité de formule vous permet de créer des tags calculés à l'aide d’opérateurs mathématiques et de fonctions simples. Elle peut être utilisée pour définir des valeurs calculées, telles que des pressions différentielles, des deltas de température, des débits totaux, des KPI (indicateurs de performances), etc. 

A more general overview on Tags can be found here.

The formula tags can be found in the tag builder menu.

screenshot1.png

Formula Submenu

Champ de formule : Dans ce champ, vous pouvez saisir la formule de votre choix en utilisant des variables. Toute variable saisie apparaîtra comme un champ "Mapper les variables" dans la section en dessous. 

Next to variables the field also accepts pre-defined functions you can use, see "Functions" below for more details.

Remarque : vous pouvez utiliser n'importe quel nom de variable s'il n'a pas été affecté à une fonction prédéfinie.

Mapper les variables : Dès qu'une variable est saisie dans le champ de formule, vous pouvez mapper la variable à n'importe quel tag existant dans TrendMiner. Le champ de mappage vous permet de sélectionner rapidement un tag dans votre liste active ou de rechercher un tag quelconque. 

Currently a maximum of 10 variables can be mapped.

Décalages temporels : Cette case à cocher vous permet d'inclure des décalages temporels pour toute valeur mappée. Le comportement par défaut de la formule est de prendre les valeurs au même horodatage pour toutes les valeurs mappées. screenshot2.png

Formula Functions

You can enter certain keywords in the formula-field that act as a predefined function. Cliquez sur le bouton " ?" pour ouvrir la documentation des fonctions intégrées. Vous pouvez y voir toutes les fonctions disponibles et apprendre à les utiliser. screenshot3.pngscreenshot4.png

Exemple 1 : Dans cet exemple, vous voulez renvoyer un calcul différent en fonction de la température. Vous voulez renvoyer la mesure avec un facteur de correction de 0,789 si la température est inférieure à 30°C et un facteur de 1,345 si la température est supérieure. Dans ce cas, vous pouvez utiliser la fonction "if".  

From the help-menu you can see that the syntax for the "if" function is:

if(condition,value_if_true,value_if_false)

Ici, nous devons définir notre condition (température supérieure à 30°C) et ce qu'on doit retourner si cette condition est vraie (facteur 1,345) ou fausse (facteur 0,789). La formule que nous devons entrer devient : 

if(temp>30, 1.345 * tagA, 0.789 * tagA)

Using this formula we could then map the temperature-measurement to the variable "temp" and the measurement we want to correct for to "tagA".

Exemple 2 : Dans cet exemple, vous voulez calculer une somme si au moins 1 des 3 valves est ouverte. Si elles sont toutes fermées, nous voulons afficher 0. We will use a combination of an "if" and "or" function to accomplish this.

From the help-menu you can see that the syntax for the "or"-function is:

or(expression1,expression2,…,expression10)

Notez que la fonction "or" renvoie VRAI si l'une des expressions est évaluée comme vraie. C'est ce que nous pouvons introduire directement dans la fonction "if" comme condition : 

if(or(valve1="open", valve2="open", valve3=1), A+B, 0) 

This formula will return a value of zero if all valves are closed and returns the calculation of the tags mapped to "A+B" if at least one of the valves is open.

Remarque : pour les nombres en notation scientifique, vous devez utiliser la notation "*10^(-3)" car la lettre "E" pour "E(-3)" est déjà prise pour le mappage de variables.

Formula Output

Output of a formula tag is always an analog (linearly interpolated) tag.

Tag Type & Input conversions

Discrete, Digital and Sting tags will first be converted to linear analog values when used in mathematical operations.

Calcul

Le calcul des tags de formule est effectué sur la base de tous les points d'indexation existants des variables cartographiées. Une valeur interpolée entre deux points est utilisée lorsqu'aucun point d'indexation n'existe pour d'autres variables mappées à cet horodatage spécifique. 

Lorsqu'on examine des fenêtres temporelles plus petites (inférieures à 300 fois la résolution de l'index), TrendMiner récupère directement les données de l'historien au lieu d'utiliser les valeurs indexées. Dans ce scénario, un calcul ad hoc est effectué sur la base des données visualisées au lieu des valeurs indexées, qui peuvent être plus précises que les valeurs indexées. 

Remarque : Les autres fonctionnalités de TrendMiner utilisent toujours les valeurs d'index stockées des tags de formule pour les calculs ultérieurs.

Restrictions

Les restrictions générales mentionnées dans le document de présentation du Constructeur Tag sont applicables aux tags de formule. 

Variables

A maximum of 10 variables can be included for mapping of each formula.

Input and Output

  • Discrete, Digital and Sting tags will first be converted to linear analog values when used in mathematical operations.
  • Output of a formula tag is always an analog (linear interpolated) tag.
Enjoying TrendMiner? Share your experience to help the community and receive $25.
Rate TrendMiner