Itérateurs

L’itération, parfois appelée boucle ou traitement par lots, consiste à répéter plusieurs fois un processus avec plus ou moins d’automatisation. L’itération s’avère importante car l’automatisation réduit le temps et l’effort requis pour effectuer des tâches répétitives. Grâce à l’itération qu’offre ModelBuilder, un traitement peut être exécuté plusieurs fois avec des données ou des paramètres différents dans chaque itération. De plus, l’itération que propose ModelBuilder est souple, car elle permet l’exécution répétitive d’un modèle entier ou d’un outil ou traitement individuel.

How to use iterators in ModelBuilder video

• Durée de la vidéo : 2:02.
• Cette vidéo a été créée avec ArcGIS Pro 3.0.

Remarque :

• Un seul itérateur peut être utilisé par modèle. Les options d’ajout d’un autre itérateur sont désactivées si un itérateur existe dans le modèle.
• Si un itérateur est ajouté à un modèle, tous les outils du modèle itèrent chaque valeur de l’itérateur. Si vous ne souhaitez pas exécuter chacun des outils que le modèle comprend pour chaque valeur itérée, créez un sous-modèle ou modèle dans un modèle ou un modèle imbriqué qui contient uniquement l’itérateur et ajoutez-le comme outil de modèle au modèle principal.
• Pour donner un nom unique à la sortie d’un outil connecté à un itérateur, utilisez la substitution de variables en ligne.

ModelBuilder comporte plusieurs itérateurs que vous pouvez utiliser pour itérer des valeurs, jeux de données et espaces de travail différents.

Itérateur	Description
Pour	Exécute une itération sur une valeur de début et une valeur de fin en fonction d'une valeur donnée.
Itérer dans des jeux de données	Itère des types de jeux de données différents dans un espace de travail.
Iterate Feature Classes (Itérer dans des classes d’entités)	Itère des classes d'entités dans un espace de travail ou un jeu de données d'entité.
Itérer dans une sélection d'entités	Itère des entités dans une classe d'entités.
Itérer dans des valeurs de champ	Itère chaque valeur d’un champ.
Itérer les champs	Itère sur les champs d’une table
Itérer dans des fichiers	Itère des fichiers dans un dossier.
Iterate Layers (Itérer sur les couches)	Itère les couches dans une carte.
Itérer dans des valeurs multiples	Itère une liste de valeurs.
Itérer dans des rasters	Itère des rasters dans un espace de travail.
Itérer dans une sélection d'enregistrements	Itère les lignes d'une table.
Itérer dans des tables	Itère des tables dans un espace de travail.
Itérer sur le temps	Itère sur le temps dans un champ de date.
Itérer dans des espaces de travail	Itère les espaces de travail d'un dossier.
Tant que	Itère jusqu’à ce qu’une condition devienne vraie ou fausse.

Ajouter et utiliser un itérateur

Pour ajouter un itérateur à votre modèle, cliquez sur ModelBuilder > Insert (Insérer) > Iterator (Itérateur) et choisissez un itérateur dans la liste.

Double-cliquez sur l’élément d’itérateur à afficher et modifiez ses paramètres. Vous trouverez ci-dessous une présentation et des explications concernant un itérateur courant, Iterate Feature Classes (Itérer dans des classes d’entités).

Elément	Description
Espace de travail	Espace de travail en entrée (par exemple, géodatabase) ou jeu de classes d’entités.
Caractère générique	Combinaison de * et d’autres caractères pour limiter les résultats. Par exemple, A* signifie que seules les classes d’entités commençant par A sont incluses. Ce paramètre est facultatif.
Type d'entités	Filtre de type d’entités qui aide à limiter les résultats. Les plus courants sont Point, Line et Polygon. Ce paramètre est facultatif.
Récursif	Détermine si l’itérateur doit ouvrir les sous-dossiers de l’espace de travail. Ce paramètre est facultatif.
Classe d’entités en sortie	Variable en sortie qui contient le chemin de la classe d’entités. Vous pouvez utiliser cette variable comme entrée de tous les outils de géotraitement acceptant des couches d’entités ou des classes d’entités.
Nom	Variable en sortie qui contient le nom de la classe d’entités. Il s'agit d'une chaîne.

L’outil Itérer dans des classes d’entités nécessite une valeur Input Workspace (Espace de travail en entrée) (la variable nommée Workspace (Espace de travail) dans le graphique ci-dessus), où toutes les classes d’entités devant faire l’objet d’une itération sont stockées. Trois paramètres supplémentaires, Wildcard (Caractère générique), Feature Type (Type d’entité) et Recursive (Récursif), permettent de restreindre les classes d’entités devant être itérées dans l’espace de travail et de contrôler l’itération dans les sous-dossiers de l’espace de travail.

L’outil Itérer dans des classes d’entités possède deux variables en sortie : une classe d’entités et le nom de la classe d’entités. La variable de classe d’entités peut être connectée à l’outil suivant pour le traitement, et la variable Name (Nom) peut être utilisée pour la substitution de variables en ligne.