AVE : Moyenne

Description de la fonction

La procédure calcule la moyenne des valeurs d'entrée pondérées et donne le résultat en sortie.

Deux entrées successives (K_Xn) représentent une paire de valeurs. La première entrée K_Xn correspond à K1, la suivante à X1, celle qui suit à K2, etc.

Le nombre d'entrées K_Xn peut atteindre 32 en modifiant verticalement la taille de la trame du bloc. Cela correspond à 16 paires de valeurs maximum.

Le nombre d'entrées doit être pair ; sinon AVE génère une erreur système et définit ENO sur Faux.

Les types de données de toutes les valeurs d'entrée et de sortie doivent être identiques.

et peuvent être configurés en tant que paramètres supplémentaires.

Formule

Formule du bloc :

Représentation en FBD

Représentation :

Représentation en LD

Représentation :

Représentation en IL

Représentation :

LD FactorFirstValue
AVE FirstValue, FactorSecondValue, SecondValue
ST Result

Représentation en ST

Représentation :

Result := AVE (FactorFirstValue, FirstValue,
          FactorSecondValue, SecondValue) ;

Description des paramètres

Description des paramètres d'entrée :

Paramètre	Type de données	Signification
FactorFirstValue	INT, DINT, UINT, UDINT, REAL	Facteur (K1) pour la première valeur
FirstValue	INT, DINT, UINT, UDINT, REAL	Première valeur (X1)
FactorSecondValue	INT, DINT, UINT, UDINT, REAL	Facteur (K2) pour la seconde valeur
FactorSecondValue	INT, DINT, UINT, UDINT, REAL	Seconde valeur (X2)
:
FactorHalfnValue	INT, DINT, UINT, UDINT, REAL	Facteur pour la valeur de (K_X(n-1))
HalfnValue	INT, DINT, UINT, UDINT, REAL	Valeur de K_X(n) n = 32 max.

Description des paramètres de sortie :

Paramètre	Type de données	Signification
Résultat	INT, DINT, UINT, UDINT, REAL	Valeur moyenne

Erreur d'exécution

Le bit système %S18 est mis à 1 si :

la plage de valeurs de la sortie est dépassée (tous les types de données disponibles)

ou
une division non valide par 0 est exécutée (tous les types de données disponibles)

ou
un numéro à virgule flottante non autorisé est défini sur un paramètre d'entrée de type REAL. Dans ce cas, l'état est également placé dans %SW17.

Remarque : L'indicateur %SW17.1 (opérande non normalisé/le résultat est acceptable) n'est pas géré par la procédure AVE.

NOTE : Pour obtenir une liste de tous les codes et de toutes les valeurs d'erreur de bloc, reportez-vous à la section Statistiques.

REAL

Le type REAL (réel) est codé sur 32 bits.

Les plages de valeurs possibles sont indiquées dans la figure suivante :

Lorsqu'un résultat est :

compris entre -1,175494e-38 et 1,175494e-38, il est considéré comme étant un DEN ;
inférieur à -3,402824e+38, le symbole -INF (pour - infini) s'affiche ;
supérieur à +3,402824e+38, le symbole INF (pour + infini) s'affiche ;
indéfini (racine carrée d'un nombre négatif), le symbole NAN s'affiche.

NOTE : La norme CEI 559 définit deux catégories de NAN : le NAN silencieux (QNAN) et le NAN de signalement (SNAN). Un QNAN est un NAN (Not a Number) avec un bit de fraction de poids fort tandis qu'un SNAN est un NAN sans bit de fraction de poids fort (bit numéro 22). Les QNAN peuvent être propagés par la plupart des opérations arithmétiques, sans générer d'exception. Quant aux SNAN, ils signalent en général une opération non valide lorsqu'ils sont utilisés en tant qu'opérandes dans des opérations arithmétiques (voir %SW17 et %S18).

NOTE : Lorsqu'un DEN (nombre non normalisé) est utilisé en tant qu'opérande, le résultat n'est pas significatif.