> 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/add.md).

# Add

Ce bloc de fonction additionne plusieurs valeurs numériques en un seul résultat numérique. Il est idéal pour agréger des compteurs, des relevés de capteurs ou des nombres calculés par d'autres blocs de fonction.

## 📥 Entrées

`Number` Une ou plusieurs entrées numériques. La configuration par défaut fournit deux entrées, mais le nombre total d'entrées peut être modifié en utilisant le contrôle décrit ci-dessous.\
(Chaque entrée accepte toute valeur numérique produite par d'autres blocs de fonction.)

## 📤 Sorties

`Number` La somme de toutes les entrées numériques connectées.

## 🕹️ Contrôles

`Input size` Un contrôle déroulant pour sélectionner le nombre de connecteurs d'entrée numériques que le bloc fournit. La modification de cette valeur ajoutera ou supprimera des connecteurs d'entrée afin que vous puissiez sommer plus ou moins de valeurs.

## 🎨 Fonctionnalités

* Nombre d'entrées dynamique : changez facilement combien de valeurs numériques vous souhaitez additionner sans ajouter plusieurs blocs.
* Sortie numérique unique : pratique pour alimenter des traitements en aval, de la journalisation ou des blocs d'affichage avec la valeur agrégée.
* Ignore les entrées non connectées : seules les entrées numériques connectées sont prises en compte pour calculer la somme.

## 📝 Instructions d'utilisation

1. Utilisez le contrôle `Input size` pour définir le nombre d'entrées numériques nécessaires.
2. Connectez les sorties numériques d'autres blocs de fonction aux entrées `Number` fournies.
3. Lisez le résultat sommée depuis la sortie `Number` du bloc et transmettez-le aux blocs en aval.

## 📊 Évaluation

Lorsque exécuté, ce bloc additionne toutes les valeurs numériques actuellement connectées à ses entrées et produit le total comme une seule valeur numérique.

## 💡 Astuces et conseils

* Sommez des valeurs manuelles avec un bloc `Number Input` pour créer des consignes ou des offsets avant traitement.
* Combinez les comptages de plusieurs détecteurs en alimentant leurs sorties `Object Count` (par exemple depuis `Object Detection`) dans ce bloc pour obtenir un compte total d'objets.
* Utilisez avec `Counter` pour accumuler des événements et avec `Get Batch Size` lors du traitement par lots pour calculer des totaux par lot.
* Chaînez avec `Divide` pour calculer des moyennes (somme ÷ nombre) ou avec `Round` pour formater les résultats numériques pour affichage/export.
* Utilisez conjointement avec des blocs d'analyse tels que `Mean Value of Image` ou `Measure Position Distance` pour combiner des résultats de mesure en une valeur récapitulative.

## 🛠️ Dépannage

* Si la sortie est inférieure à ce qui est attendu, vérifiez que toutes les sources numériques prévues sont bien connectées au bloc.
* Si vous changez `Input size` et ne voyez pas le nombre attendu de connecteurs, rouvrez la mise en page ou re-sélectionnez l'option `Input size` pour actualiser l'affichage des connecteurs.
* Les entrées non numériques ou manquantes sont ignorées ; assurez-vous que les blocs en amont produisent des valeurs numériques avant de les connecter.
