Recueillir des valeurs (ModelBuilder)

Résumé

Cet outil recueille les valeurs en sortie d’un itérateur ou convertit une liste de valeurs en une entrée unique. La sortie de l'outil Recueillir des valeurs peut être utilisée comme entrée des outils Combiner, Ajouter, Mosaïque et Statistiques de cellule.

Pour en savoir plus sur le fonctionnement de l'outil Recueillir des valeurs dans ModelBuilder

Utilisation

• Cet outil est prévu pour une utilisation dans ModelBuilder, et non dans des scripts Python.

Remarque :

Dans ArcGIS, la plupart des outils sont vides (sans couleur) lorsqu’ils sont ajoutés à un modèle. Toutefois, ce n'est pas le cas des outils Recueillir des valeurs, Si Valeur égale à, Données présentes et Fusionner des branches. Contrairement à la plupart des autres outils, Recueillir des valeurs est toujours prêt à être exécuté (avec couleur). En effet, l’entrée de l’outil, même vide, est considérée comme valide.

• Les sorties de l'outil qui sont des paramètres de modèle sont ajoutées à l'affichage cartographique à l'aide du nom de variable. Si vous utilisez un itérateur dans le modèle et souhaitez ajouter les sorties de toutes les itérations pour les afficher dans la carte avec le nom de sortie unique réel au lieu du nom de la variable, connectez la sortie à afficher à l’outil Recueillir les valeurs, puis cliquez avec le bouton droit sur la sortie de Recueillir les valeurs et transformez-la en paramètre de modèle.

• L'outil Recueillir des valeurs peut également être utilisé pour supprimer les paramètres en sortie à partir de la boîte de dialogue de l'outil et faire en sorte que la sortie soit ajoutée à la carte. Par exemple, supposons que votre modèle utilise l'outil Zone tamponet que la sortie de l'outil Zone tampon soit un paramètre de modèle. Lorsque vous exécutez votre modèle à partir de la boîte de dialogue de son outil, cette dernière affiche ce paramètre, de sorte que l'utilisateur puisse changer l'emplacement d'écriture de la sortie de Zone tampon. Néanmoins, vous ne souhaitez peut-être pas que cet emplacement soit modifié dans la boîte de dialogue, c'est-à-dire que vous voulez effectivement écrire la sortie dans un emplacement spécifique non modifiable par l'utilisateur.

  La solution consiste alors à changer la sortie de l'outil Zone tampon de manière à ce qu'elle ne soit pas un paramètre et à la connecter à l'outil Recueillir des valeurs. Faites ensuite de la sortie de Recueillir des valeurs un paramètre de modèle. Lorsque vous exécutez le modèle à partir de la boîte de dialogue de l'outil, le paramètre ne s'affiche pas dans la boîte de dialogue et l'utilisateur ne peut pas le changer. Pourtant, puisqu'il s'agit d'un paramètre de sortie, il est ajouté à la carte. (Cela fonctionne car, techniquement, la sortie de Recueillir des valeurs est de type données dérivées d’entrée/sortie et que les données dérivées d’entrée/sortie ne sont pas ajoutées à la boîte de dialogue.)

Syntaxe

arcpy.mb.CollectValues(in_value)

Paramètre	Explication	Type de données
in_value [in_value,...]	Valeurs en entrée à recueillir.	Any Value

Sortie dérivée

Nom	Explication	Type de données
out_value	Valeurs calculées.	Toute valeur

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui