> 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/flow-control/batch-concatenation.md).

# Batch Concatenation

Cette fonction fusionne plusieurs entrées de type batch/liste en un seul batch combiné. Utilisez-la lorsque vous souhaitez joindre plusieurs listes d'éléments (par exemple des images, des détections ou des listes de données génériques) en une seule liste pour un traitement ultérieur.

## 📥 Entrées

* `Batch`\
  Une ou plusieurs entrées de type batch/liste. Chaque entrée peut contenir une liste d'éléments (images, détections, valeurs génériques). Les entrées sont acceptées via des sockets batch.
* `Batch`\
  Une deuxième entrée batch/liste (le bloc accepte plusieurs entrées batch lorsqu'il est ajouté).

## 📤 Sorties

* `Batch`\
  Une sortie unique de type batch/liste contenant la concaténation de toutes les listes d'entrée fournies, en préservant l'ordre des éléments.

## 🕹️ Contrôles

Ce bloc fonctionnel n'a pas de contrôles visibles pour l'utilisateur. Il fonctionne automatiquement à partir des entrées fournies.

## ⚙️ Mécanisme d'exécution

Lorsque le scénario s'exécute, le bloc collecte les listes fournies sur ses entrées batch, les fusionne en ajoutant les éléments de chaque entrée dans l'ordre, et produit un batch combiné en sortie. Les entrées vides n'affectent pas la liste fusionnée (les éléments des autres entrées sont préservés).

## 🎯 Fonctionnalités

* Fusion simple de listes : concatène plusieurs listes en une seule.
* Préservation de l'ordre original des éléments pour chaque entrée.
* Accepte des éléments batch génériques (images, nombres, dictionnaires, etc.).

## 📝 Comment utiliser

1. Alimentez une ou plusieurs sorties batch/liste vers les entrées batch du bloc.
2. Connectez la sortie batch unique du bloc aux blocs en aval qui attendent une liste ou un batch.
3. Utilisez ce bloc lorsque vous avez besoin de combiner des branches parallèles (par exemple, sorties de caméras séparées ou détecteurs parallèles) en un flux de traitement unique.

## 💡 Conseils et astuces

* Combinez avec `Debatch` lorsque vous devez scinder un batch fusionné en éléments individuels pour un traitement par élément.
* Utilisez `Get Batch Size` pour inspecter combien d'éléments contient le batch fusionné.
* Utilisez `Get Element` pour extraire des éléments spécifiques du batch fusionné par index.
* Pour traiter de grandes listes de manière économe en mémoire, associez avec `Batch Processing` pour gérer les éléments par petits lots.
* Pour filtrer les entrées manquantes ou invalides avant la fusion, utilisez `Exclude Nones` ou `Replace None` sur les listes entrantes.
* Consommateurs courants de batches d'images fusionnés : `Collage Images`, `Image Concatenate`, `Image Logger`, ou tout bloc détecteur/analyse acceptant des listes d'images.

## 🛠️ Dépannage

* Si le batch fusionné semble vide : vérifiez que chaque entrée batch contient des éléments et que les entrées sont bien connectées.
* Si l'ordre est important, assurez-vous que les entrées sont fournies dans la séquence désirée, le bloc préservant l'ordre des entrées lors de la concaténation.
* Si certains éléments sont inattendus (par ex. None), utilisez des blocs de filtrage comme `Exclude Nones` avant la fusion.