For the complete documentation index, see llms.txt. This page is also available as Markdown.

Get Element

Ce bloc fonction extrait un seul élément d'une liste fournie (Batch) en utilisant une valeur d'index. Il est utile lorsque vous devez sélectionner un élément d'une collection et l'envoyer vers les blocs suivants.

📥 Entrées

  • Batch : Une liste ou un lot de valeurs (images, nombres, textes, etc.) à partir duquel un élément sera extrait.

  • Index : La position d'index (commençant à zéro) indiquant quel élément retourner depuis le Batch.

📤 Sorties

  • Generic : L'élément sélectionné du Batch. Le type retourné correspond au type d'élément contenu dans le batch d'entrée.

🕹️ Contrôles

Ce bloc fonction n'a pas de widgets interactifs. Il fonctionne en lisant les sockets d'entrée fournis à chaque étape d'évaluation.

🎨 Fonctionnalités

  • Extraction simple et directe d'un élément d'une liste ou d'un batch.

  • Compatible avec n'importe quel type de donnée générique présent dans le batch (images, nombres, chaînes, formes, etc.).

  • Conçu pour une intégration facile dans des flux où le traitement d'un seul élément est nécessaire.

📝 Instructions d'utilisation

  1. Fournissez une liste ou un lot au port Batch.

  2. Fournissez la position de l'élément (index base zéro) au port Index.

  3. Le bloc renvoie l'élément à la position demandée sur sa sortie Generic.

  4. Si le Batch a une longueur dynamique, assurez-vous que la valeur Index est valide pour éviter des résultats inattendus.

📊 Évaluation

À chaque exécution, le bloc lit les valeurs courantes de Batch et Index, puis transmet l'élément se trouvant à cet index vers la sortie. Si l'index correspond à une seule valeur, un seul élément est retourné ; combiné avec le contrôle de flux par batch, il permet de sélectionner des éléments spécifiques pour un traitement ultérieur.

💡 Astuces et Conseils

  • Utilisez Batch Processing avant ce bloc lorsque vous souhaitez alimenter des données groupées ou en flux et réduire l'utilisation mémoire.

  • Combinez avec Debatch pour convertir un batch en éléments individuels, puis utilisez Get Element pour choisir un élément spécifique dans ce flux.

  • Utilisez Get Batch Size pour vérifier la longueur du batch avant de sélectionner un index ; cela évite les sélections hors plage.

  • Utilisez Is None et Replace None après ce bloc pour gérer proprement les valeurs manquantes.

  • Utilisez Data Memory pour geler ou mettre en cache un batch et garder les mêmes données disponibles pendant que vous testez différents index.

  • Utilisez Debug Input pour inspecter le batch ou l'index lorsque les résultats sont inattendus.

  • Lors de la construction de pipelines d'images indexées, combinez avec des blocs de visualisation comme Show Image pour prévisualiser l'élément d'image sélectionné.

🛠️ Dépannage

  • Si vous recevez une sortie vide ou inattendue, vérifiez que le Batch contient bien des éléments et que Index est dans la plage valide (0..length-1).

  • Si le pipeline fournit parfois des valeurs None, utilisez Is None ou Replace None pour protéger le traitement en aval.

  • Pour les flux avec des tailles de batch changeantes, vérifiez toujours Get Batch Size avant d'utiliser Index afin d'éviter des accès invalides.

Mis à jour