> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/data-logic/mathmetical-operations/square-root.md).

# Square Root

Une fonction arithmétique simple qui calcule la racine carrée d'une valeur numérique. Utilisez ce bloc lorsque vous avez besoin de la racine positive d'un nombre non négatif dans votre scénario.

## 📥 Entrées (sockets) <a href="#inputs" id="inputs"></a>

`Number` La valeur numérique dont on souhaite calculer la racine carrée. Fournir une valeur non négative pour obtenir un résultat valide.

## 📤 Sorties (sockets) <a href="#outputs" id="outputs"></a>

`Number` La valeur résultante de la racine carrée.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

Ce bloc n'a pas de contrôles interactifs. Il calcule sa sortie directement à partir de la socket d'entrée.

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

Lorsque le bloc reçoit une entrée numérique, il produit la racine carrée de cette valeur à sa sortie à chaque cycle d'évaluation. Si l'entrée est manquante ou invalide pour la racine carrée (par exemple un nombre négatif), le bloc ne produira pas un résultat numérique significatif — effectuez une vérification avant d'alimenter de telles valeurs.

## ✨ Fonctions <a href="#features" id="features"></a>

* Opération numérique instantanée adaptée aux pipelines en temps réel.
* Empreinte UI minimale — conçu pour être combiné avec d'autres blocs mathématiques et logiques.
* Fonctionne de façon fluide dans des chaînes arithmétiques (par ex. combiner avec des blocs `Multiply` ou `Divide`).

## 📝 Utilisation <a href="#usage" id="usage"></a>

1. Fournissez une valeur numérique à la socket `Number` (par exemple depuis un bloc `Number Input` ou la sortie d'un autre bloc mathématique).
2. Lisez le résultat depuis la socket de sortie `Number`.
3. Si vous attendez des entrées négatives, validez-les d'abord (voir conseils ci‑dessous).

## 💡 Conseils et astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Alimentez les valeurs via `Number Input` pour des tests manuels ou l'ajustement des paramètres.
* Validez la non-négativité de l'entrée avec `Greater` avant de connecter afin d'éviter des valeurs invalides.
* Si vous voulez calculer la racine carrée d'une valeur absolue, utilisez `Absolute` avant ce bloc.
* Arrondissez les résultats pour l'affichage avec `Round` si vous avez besoin de moins de décimales.
* Utilisez `Multiply` ou `Divide` avant/après pour mettre les valeurs à l'échelle souhaitée.
* Visualisez les tendances numériques avec `Scope` ou enregistrez-les avec `CSV Export` ou `Data to JSON` pour la surveillance.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si la sortie paraît incorrecte, assurez-vous que la valeur d'entrée est non négative.
* Si aucune valeur n'apparaît, vérifiez que la socket d'entrée est connectée (par ex. depuis un `Number Input` ou un autre bloc mathématique).
* Utilisez une chaîne de pré-vérification simple (`Greater` → flux conditionnel) pour empêcher des entrées invalides d'atteindre ce bloc.
