SQRT_*** : racine carrée

Description de la fonction

La fonction SQRT_*** extrait la racine carrée d'une variable. Elle peut être appelée à l'aide d'un nom générique ou d'un des noms de fonction décrits ci-dessous.

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

Fonctions disponibles

Les fonctions disponibles sont les suivantes :

SQRT_INT ;
SQRT_DINT ;
SQRT_REAL.

Représentation en FBD

Représentation appliquée à un entier :

Représentation en LD

Représentation appliquée à un entier :

Représentation en IL

Représentation appliquée à un entier :

LD Value1

SQRT_REAL

ST Sqrt_Value1

Représentation en ST

Représentation appliquée à un entier :

Sqrt_Value1 := SQRT_REAL(Value1);

Description des paramètres

Le tableau suivant décrit les paramètres d’entrée :

Paramètre	Type	Commentaire
Value1	INT, DINT, REAL.	Variable dont vous souhaitez extraire la racine carrée. Value1

Le tableau suivant décrit les paramètres de sortie :

Paramètre	Type	Commentaire
Sqrt_Value1	INT, DINT, REAL.	Sqrt_Value1 contient la racine carrée de Value1. Sqrt_Value1 est du même type que Value1. Lorsque le type est INT, Sqrt_Value1 est arrondi à la valeur inférieure : Value1 = 15, Sqrt_Value1 = 3.

Erreurs d'exécution

Lorsque Value1 est de type REAL et négatif, le résultat de la fonction contient et le bit %S18 = 1.

Si Value1 est négatif et de type INT ou DINT, le résultat de la fonction contient la valeur négative Value1 et le bit %S18 = 1.

Si %S18 = 1, le mot système %SW17 indique le type de défaut.

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.

NAN

Utilisé pour signifier que le résultat d'une opération n'est pas un nombre (NAN = Not A Number).

Exemple : calcul de la racine carrée d’un nombre négatif.

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).