Utiliser un outil de géotraitement

Une fois que vous avez trouvé un outil de géotraitement et que vous l’avez ouvert, indiquez ses valeurs de paramètre, puis exécutez-le.

Pour obtenir de l’aide sur un outil ouvert dans la fenêtre Geoprocessing (Géotraitement), positionnez le pointeur sur le bouton Help (Aide) Aide pour accéder à un résumé et une illustration de l’outil, ou cliquez sur le bouton pour ouvrir la page de référence de l’outil.

Paramètres

Une fois l’outil ouvert, indiquez ses valeurs de paramètre. Les paramètres sont un ensemble d’options ou de paramètres, tels que les données en entrée à traiter, le jeu de données en sortie et d’autres options qui modifient le mode d’exécution de l’outil. Chaque outil de géotraitement comporte un ensemble unique de paramètres. Pour en savoir plus sur chacun des paramètres de l’outil, positionnez le pointeur sur le bouton d’informations Informations qui s’affiche en regard de l’étiquette du paramètre.

Les paramètres peuvent être obligatoires ou facultatifs, et sont traités comme suit :

  • Les paramètres devant être fournis pour permettre l’exécution de l’outil sont désignés par un astérisque rouge Astérisque rouge.
  • Pour utiliser un comportement par défaut, vous n'êtes pas tenu d'indiquer les paramètres facultatifs ou de les modifier.

Les outils de géotraitement disposent à la fois de paramètres en entrée et en sortie. Les paramètres en entrée peuvent référencer des données ou être des options qui définissent les actions de l'outil. Vous pouvez désigner les données en entrée que l'outil doit traiter de différentes manières, notamment :

Modes de saisie d’entités

Concernant les paramètres en entrée qui ne sont pas des données, il suffit généralement d’indiquer un nombre, de cocher une case ou de sélectionner une option dans une liste.

Certains paramètres nécessitent une plus grande interaction, par exemple les valeurs multiples, l’étendue géographique, l’expression ou l’appariement de champ.

Un paramètre en sortie représente habituellement l’emplacement d’un nouveau jeu de données ou une valeur résultante que l’outil doit créer. Concernant les paramètres des jeux de données en sortie, un emplacement et un nom en sortie sont généralement automatiquement attribués, mais vous pouvez modifier le chemin d’accès au jeu de données ou y accéder directement à l’aide du bouton de navigation en sortie Parcourir. L’emplacement en sortie qui est automatiquement attribué dépend de votre espace de travail actuel ou temporaire.

Rétablir les valeurs par défaut des paramètres

Pour rétablir les paramètres par défaut d’un outil, ouvrez le menu Run (Exécuter) en bas de la fenêtre Geoprocessing (Géotraitement) et sélectionnez Reset Parameters (Réinitialiser les paramètres).

Remplacer les valeurs de paramètre par défaut

Vous pouvez remplacer les valeurs de paramètre par défaut des outils de géotraitement système à l’aide du fichier Pro.settingsConfig. Incluez l’élément ToolParameters dans le fichier pour définir et éventuellement verrouiller des valeurs de paramètre des outils. Les outils qui ont été configurés avec des valeurs de remplacement pour les paramètres s’ouvrent avec la valeur indiquée et non avec les valeurs par défaut définies par le système. Par exemple, vous pouvez définir le paramètre Expression Type (Type d’expression) de l’outil Calculer un champ pour faire en sorte qu’il utilise Arcade comme valeur par défaut au lieu de Python à l’aide de la syntaxe ci-après.

<Geoprocessing>
  <ToolParameters>
    <Parameter toolName="calculatefield" toolboxAlias="management" name="expression_type" isLocked="true">ARCADE</Parameter>
  </ToolParameters>
</Geoprocessing>

Remarque :

Les valeurs de remplacement de paramètre s’appliquent uniquement aux outils ouverts dans la fenêtre Geoprocessing (Géotraitement) et dans une fenêtre flottante. Les valeurs de remplacement ne sont pas utilisées lorsqu’un outil est exécuté dans Python ou dans ModelBuilder, sauf si la valeur du paramètre est indiquée.

Environnements

Vous pouvez modifier d’autres options qui influent sur les performances de l’outil dans l’onglet Environments (Environnements) de l’outil. Tous les paramètres d'environnement sont facultatifs. Seuls les environnements de géotraitement qui s’appliquent à l’outil ouvert s’afficheront dans l’onglet Environments (Environnements).

Les options d'environnement définies dans l'outil Environments (Environnements) ne s’appliquent qu’à cette instance particulière de l’exécution de l’outil. Si vous rouvrez l'outil à partir de l'historique de géotraitement, les paramètres d'environnement sont conservés. Sinon, ce sont les valeurs par défaut des paramètres d'environnement qui sont utilisées. Pour configurer les environnements de géotraitement qui doivent s’appliquer à l’intégralité du géotraitement réalisé dans le projet, ouvrez la fenêtre Environments (Environnements) en cliquant sur Analysis (Analyse) > Geoprocessing (Géotraitement) > Environments (Environnements).

Pour en savoir plus sur les paramètres d'environnement de géotraitement

Remarque :

L’onglet Environments (Environnements) de l’outil peut ne pas s’afficher si un outil est ouvert dans une fenêtre flottante à partir d’un bouton du ruban ou d’une commande de l’interface utilisateur. Définissez les environnements de projet à partir de la fenêtre Environments (Environnements) décrite précédemment pour appliquer des paramètres d’environnement le cas échéant.

Exécuter un outil

Pour exécuter un outil de géotraitement, cliquez sur le bouton Run (Exécuter) Exécuter en bas de la fenêtre Geoprocessing (Géotraitement).

Bannière de statut, progression et messages

Une fois que vous avez exécuté un outil, une bannière de statut est ajoutée au bas de la fenêtre Geoprocessing (Géotraitement) avec une barre de progression qui indique le pourcentage d’accomplissement de la tâche et un bouton d’annulation pour arrêter le traitement.

Vous pouvez positionner le curseur sur la bannière ou la barre de progression pour afficher une fenêtre contextuelle contenant des informations sur l’outil en cours d’exécution (des messages, le temps d’exécution, les paramètres de l’outil et les environnements spécifiés, par exemple). Vous pouvez cliquer sur View Details (Afficher les détails) pour accéder aux mêmes informations détaillées dans une fenêtre distincte, ou cliquer sur Open History (Ouvrir l’historique) pour ouvrir l’historique de géotraitement du projet.

La bannière de statut contient également un lien sur lequel vous pouvez cliquer pour accéder à la liste Suggestions, qui inclut des outils pouvant vous être utiles pour passer à l’étape suivante du processus de géotraitement. Les suggestions se basent sur les outils que vous avez exécutés précédemment dans le projet actuel, qui sont consignés dans l’historique de géotraitement.

En savoir plus sur les suggestions de l’outil de géotraitement

Au terme de l’exécution de l’outil, des couches en sortie sont ajoutées à la carte ouverte et la barre de progression affiche une icône et un message pour indiquer l’état de l’outil, comme suit :

IcôneStatut
Coche

L’exécution de l’outil a réussi.

Avertissement

L’outil a été exécuté, mais a généré des avertissements. Cliquez sur View Details (Afficher les détails) ou positionnez le pointeur sur l’icône d’état Avertissement pour consulter les messages d’avertissement.

Erreur

L’exécution de l’outil a échoué. Cliquez sur View Details (Afficher les détails) ou positionnez le pointeur sur l’icône d’état Erreur pour consulter les messages d’erreur.

Lorsque vous avez fini d’exécuter un outil de géotraitement, cliquez sur le bouton Back (Retour) Précédent en haut de la fenêtre Geoprocessing (Géotraitement) pour revenir à la dernière page consultée.

Suggestions

Les suggestions de l’outil de géotraitement peuvent vous être utiles pour passer à l’étape suivante du processus de géotraitement. Les suggestions se basent sur les outils que vous avez exécutés précédemment dans le projet actuel, qui sont consignés dans l’historique de géotraitement. Si vous effacez l’historique de géotraitement ou que le projet est nouveau, aucune suggestion n’est répertoriée.

Les suggestions sont disponibles dans les emplacements suivants :

  • Une fois que vous avez exécuté un outil, la liste Suggestions apparaît dans la bannière de statut de l’outil.
  • Onglet Favorites (Favoris) de la fenêtre Geoprocessing (Géotraitement).

Les suggestions utilisent un modèle de prévision qui a été entraîné avec des séquences d’utilisation des outils du programme d’amélioration de l’expérience des utilisateurs Esri. Les outils suggérés ont été utilisés dans des séquences avec les outils précédemment exécutés par la communauté des utilisateurs ArcGIS Pro.

La prévision est aléatoire et vous pouvez obtenir d’autres suggestions. Si aucune des suggestions ne s’applique à votre processus, cliquez sur Try Again (Réessayer) pour accéder à d’autres suggestions.

Remarque :

Des suggestions sont disponibles si vous avez choisi d’installer le fichier AI Models (Modèles d’IA) > Tool Suggestions (Suggestions d’outils) lors de l’installation de ArcGIS Pro.

Remarque :

Les suggestions nécessitent un processeur prenant en charge le jeu d’instructions AVX2. Si cette exigence matérielle n’est pas satisfaite, les suggestions ne sont pas disponibles, même si le fichier de modèle des suggestions d’outils est installé.

Planifier un outil

Dans le menu Run (Exécuter), sélectionnez Schedule (Planifier) pour exécuter l’outil à une date et à une heure ultérieures, voire avec une répétition. Tous les paramètres requis doivent être spécifiés pour planifier un outil.

En savoir plus sur la planification des outils de géotraitement

Copier la commande Python

Pour copier un extrait de commande Python pouvant être utilisé pour exécuter l’outil dans Python avec les paramètres et environnements actuellement spécifiés, dans le menu Run (Exécuter), sélectionnez Copy Python Command (Copier la commande Python). Le code Python est copié dans le Presse-papiers. Vous pouvez ensuite le coller dans la fenêtre Python, un notebook ou une autre interface Python.

Remarque :

Il n’est pas nécessaire d’exécuter l’outil avant de copier la commande Python. Toutefois, toutes les valeurs de paramètre requises doivent avoir été spécifiées pour que l’option Copy Python Command (Copier la commande Python) soit activée.

Les commandes Python peuvent également être copiées depuis les entrées de l’historique de géotraitement.

Threads de géotraitement

Lorsque vous exécutez un outil de géotraitement, il s’exécute généralement dans un thread d’arrière-plan dédié au géotraitement. Ceci permet à l’application et à la carte de demeurer disponibles pour d’autres tâches pendant l’exécution de l’outil, ce qui est particulièrement important si vous exécutez un outil dont la durée de fonctionnement est longue. Il existe plusieurs cas où un outil de géotraitement ne s’exécute pas dans ce thread de géotraitement ; l’outil s’exécute alors dans le thread d’application principal et verrouille l’application pendant le temps d’exécution de l’outil. Les autres tâches ne peuvent alors pas être exécutées avant la fin de l’exécution de l’outil. Les cas suivants verrouillent l’application jusqu’au terme de l’exécution de l’outil de géotraitement :

  • Exécution d’un outil de géotraitement dans la fenêtre Python.
  • L’exécution d’un outil de géotraitement dans un complément ArcGIS Pro est susceptible de verrouiller l’application, en fonction des méthodes et propriétés des outils définies dans le complément.
  • Exécution d’un outil de géotraitement lorsque des mises à jour sont en attente.
  • Exécution interactive d’un modèle dans ModelBuilder.
  • L’exécution d’un outil de géotraitement à partir d’une fenêtre flottante ouverte depuis un bouton du ruban ou une commande de l’interface utilisateur est susceptible de verrouiller l’application, selon les méthodes et propriétés des outils définies par le développeur du bouton ou de la commande.

Historique et outils récemment exécutés

Lorsqu’un outil de géotraitement est exécuté, une entrée est ajoutée à l’historique de géotraitement du projet. Elle fournit des détails sur la date/l’heure d’exécution de l’outil, les paramètres utilisés, la réussite ou l’échec de l’outil, ainsi que des informations, avertissements ou messages d’erreur.

L’onglet Favorites (Favoris) de la fenêtre Geoprocessing (Géotraitement) comporte aussi une section Recent (Récent), qui répertorie les outils que vous avez récemment exécutés.

Les outils récemment exécutés affichent une icône d’état ainsi que la liste des instances récentes de l’outil. Vous pouvez passer le curseur sur les entrées de la liste pour afficher les détails, et cliquer sur l’outil sélectionné pour l’ouvrir avec les paramètres utilisés lors de sa précédente exécution.

Outils de géotraitement récemment utilisés

Ouvrir et exécuter plusieurs outils

La fenêtre Geoprocessing (Géotraitement) permet d’ouvrir plusieurs outils de géotraitement, d’afficher une liste des outils ouverts et de passer facilement de l’un à l’autre. Pour ouvrir plusieurs outils, procédez comme suit :

  1. Ouvrez un outil de géotraitement.
  2. Cliquez sur le bouton Add (Ajouter) Addition dans l’angle supérieur droit de la fenêtre Geoprocessing (Géotraitement) pour ouvrir un menu qui répertorie tous les outils de géotraitement ouverts.
  3. Sélectionnez Open Another Tool (Ouvrir un autre outil).

    La fenêtre Geoprocessing (Géotraitement) revient à la page précédente et ajoute le nom du premier outil ouvert à la liste des outils ouverts. Toutes les modifications de l’outil précédent sont enregistrées et sont chargées lorsque cet outil est rouvert à partir de ce menu.

  4. Recherchez ou sélectionnez un autre outil et ouvrez-le.
  5. Cliquez sur le bouton Add (Ajouter) Addition dans la fenêtre Geoprocessing (Géotraitement) pour afficher la liste des différents outils ouverts.

Vous pouvez permuter entre tous les outils ouverts sans perdre le fil de votre travail. En effet, la configuration et les paramètres d’environnement sont préservés tant que l’outil reste affiché dans la liste des outils ouverts.

Vous pouvez exécuter plusieurs outils. Ceux-ci seront placés dans une file d’attente des outils actifs, visible dans l’historique de géotraitement. Si vous lancez un outil alors qu’un autre outil est en cours d’exécution, le deuxième outil est placé en état d’attente et est exécuté automatiquement dès que le premier outil prend fin.