√

SquareRoot

Math

Le bloc SquareRoot calcule la racine n-ième du signal d'entrée. Bien que nommé SquareRoot pour l'usage courant (où n=2), il s'agit d'un bloc de calcul de racine polyvalent qui prend en charge les racines cubiques (n=3) et tout autre ordre de racine numérique.

Modèle Mathématique

Le bloc implémente le calcul suivant :

y(t) = \sqrt[n]{u(t)}

Où :

y(t) est le signal de sortie
in(t) est le signal d'entrée
n est l'ordre de la racine (par défaut 2.0)

Handling of Negative Inputs

Le calcul de la racine d'un nombre négatif peut être problématique pour les ordres de racine pairs (par exemple √-1). Le bloc propose plusieurs modes de sécurité configurables :

Return Zero (Par défaut) : Renvoie 0.0 lorsqu'une entrée négative est rencontrée. Il s'agit de l'option la plus sûre pour la stabilité de la simulation et elle comprend un avertissement visuel unique.
Use Absolute Value : Calcule la racine de la valeur absolue de l'entrée. Utile lorsque le signe du signal n'a pas d'importance pour le calcul.
Return NaN : Renvoie "Not a Number". Notez que cette valeur se propagera dans votre schéma et pourra conduire d'autres blocs à produire un NaN.

Entrées & Sorties

Direction	ID	Label	Type	Status
→ In	`in`	In	number	Required
← Out	`out`	Out	number	Output

Paramètres

Paramètres	Label	Type	Défaut
`rootOrder`	Root Order (n)	number	`2`
`negativeHandling`	Negative Input	select	`zero`
`reportWarning`	Report Warning	boolean	`true`

Exemples d'Utilisation

Calcul de distance

Calculer la distance à partir des coordonnées (x, y) :

Sum (x^2 + y^2) → SquareRoot (n=2) → Distance

Mesure de débit

Calculer le débit d'un fluide à partir de la pression différentielle (où le débit ∝ √ΔP) :

PressureDifference → SquareRoot (n=2) → FlowRate

Remarques & Bonnes Pratiques

Entrées négatives : Les ordres de racine pairs (n = 2, 4, 6) produisent NaN pour les entrées négatives ; utilisez le mode "Use Absolute Value" ou l'option de sécurité "Return Zero"
Entrée nulle : Renvoie 0 pour tout ordre de racine positif
Ordre de racine < 1 : Équivaut à élever l'entrée à une puissance > 1 (par ex., n = 0.5 élève le signal au carré)
Performance : Coût de calcul très faible ; adapté à la simulation temps réel
Stabilité numérique : La racine de très petits nombres positifs peut produire de fortes variations ; envisagez de borner les entrées proches de zéro

Composants Associés

Product : Pour la multiplication générale et le carré (n=0.5)
Gain : Pour la mise à l'échelle des signaux
MathFunction : Pour d'autres opérations mathématiques