K_SQRT : Racine carrée

Description de la fonction

Cette fonction calcule la racine carrée pondérée d'une valeur numérique. Il est possible de définir un séparateur en dessous duquel la fonction sort la valeur zéro.

Le calcul de la racine carrée permet la linéarisation d'une mesure de débit à l'aide d'un appareil de réactance.

Les paramètres supplémentaires et peuvent être configurés.

Formule

La fonction exécute le calcul suivant :

Calcul	Condition

	ou

Représentation dans FBD

Représentation :

Représentation dans LD

Représentation :

Représentation dans IL

Représentation :

LD DigitalVariable
K_SQRT WeightingCoefficient, Cutoff
ST OUT

Représentation dans ST

Représentation :

Result := K_SQRT (DigitalVariable, WeightingCoefficient,
                  Cutoff);

Description des paramètres

Description des paramètres d'entrée :

Paramètre	Type de données	Signification
DigitalVariable	REAL	Valeur numérique à traiter
WeightingCoefficient	REAL	Coefficient de pondération
Cutoff	REAL	Séparateur

Description des paramètres de sortie :

Paramètre	Type de données	Signification
Result	REAL	Résultat du calcul

Erreur d’exécution

Une erreur est signalée lorsqu'une valeur non réelle est saisie à l'une des entrées ou lorsqu'un incident survient lors d'un calcul en valeurs en virgule flottante. Dans ce cas, la sortie Result reste inchangée.

NOTE : Pour obtenir une liste de tous les codes et valeurs d'erreur du bloc, voir Mathématiques.

Avertissement

Un avertissement est émis lorsque l'entrée Cutoff prend une valeur négative. Le bloc fonction emploie alors la valeur 0 pour le calcul.

EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie.

Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0.

Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0.

Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1.

ENO

ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN.

Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) :

les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ;
la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0.

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.