Configurer un traçage

Dans un réseau de traces, le traçage permet de résoudre des problèmes et de répondre aux questions liées à l’état de votre réseau à n’importe quel moment. Pour tracer un réseau de traces, utilisez l’outil Tracer.

De nombreux types de traces sont fournis avec l’outil Traçage :

Outre ces types de traçage, l’outil Trace (Traçage) comprend également un ensemble complet de configurations avancées qui permettent d’affiner chaque type de traçage fourni. Ces configurations vous permettent de constituer latraversabilité, de distinguer quelles entités doivent être renvoyées, et de configurer les calculs à exécuter. ModelBuilder permet d’enregistrer des configurations complexes et de réduire le nombre de paramètres présentés sur l’interface de l’outil de modèle. Cela vous permet ainsi qu’à autrui d’exécuter à nouveau des traces avancées en un seul clic.

Chaque composant de configuration est examiné dans les sections suivantes. Reportez-vous à l’outil Traçage pour prendre connaissances des options des paramètres et des instructions d’utilisation.

Inclure des interruptions dans les résultats

Par défaut, les entités d’interruption sont renvoyées dans les résultats d’une trace sauf si l’entité d’interruption existe le long d’un point de début. Vous pouvez modifier ce comportement à l’aide des options Include Barrier Features (Inclure les entités d’interruption) et Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début).

Inclure les entités d’interruption

Permet d’inclure les interruptions dans les résultats d’un parcours. Cela englobe les entités d’interruption définies dans la fenêtre Trace (Traçage) ainsi que les interruptions configurées dynamiquement : interruptions conditionnelles, interruptions fonctionnelles, filtres d’interruption et filtres par fonctions d’interruption.

La sélection définie renvoyée par un parcours peut afficher des résultats inattendus lorsque des barrières sont placées sur des entités de tronçon avec la connectivité à mi-portée et l’option Include Barrier Features (Inclure des interruptions) est désactivée. Si une partie de l’entité est renvoyée par le parcours, l’entité intégrale est sélectionnée et affichée dans le résultat de parcours.

Option de configurationDescription

Inclure les entités d’interruption

  • Activée : les entités d’interruption sont incluses dans les résultats de la trace. Il s’agit de l’option par défaut.
  • Désactivée : les entités d’interruption ne sont pas incluses dans les résultats de la trace.

Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début)

Permet de ne pas tenir compte des interruptions dans la configuration de la trace s’il s’agit de points de début.

Option de configurationDescription

Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début)

  • Activée : les résultats de la trace ne tiennent pas compte des interruptions aux points de début.
  • Désactivée : les résultats de la trace respectent les interruptions aux points de début. Il s’agit de l’option par défaut.

Garantir la cohérence du réseau

La zone cohérente d’un réseau est une zone dans laquelle la topologie de réseau a été validée et ne présente aucune zone à valider. La validation est la seule façon de garantir qu’une trace lit les dernières informations concernant votre réseau via la topologie de réseau.

L’option de configuration Validate Consistency (Valider la cohérence) de l’outil Traçage vous assure que les résultats du traçage sont cohérents avec la topologie de réseau. Lorsque l’option Validate Consistency (Valider la cohérence) est définie sur vrai, l’opération de traçage échoue si des zones à valider sectionnent le chemin de traçage. Dans ce cas, l’outil renvoie une erreur qui inclut le nom de la classe et l’ID global des entités dans le chemin de la trace identifiés comme étant à valider, comme indiqué dans l’exemple ci-dessous.

ERROR 002041: One or more dirty areas were discovered.
[[NHDFlowline: {0DBFACDA-45D6-BA67-33CE-A750BE632C05}]]
Failed to execute (Trace).

Pour que vous puissiez retirer les zones à valider associées aux mises à jour, la topologie de réseau doit être validée.

Remarque :

Seules les zones à valider créées à l’issue d’opérations de suppression, de mises à jour d’entités de réseau existantes ou de la création d’entités d’erreurs entraînent le déclenchement d’une erreur relative aux incohérences dans les résultats de la trace. Les zones à valider issues d’entités nouvellement créées n’entraînent pas d’échec au niveau de la vérification Validate Consistency (Valider la cohérence).

Une trace exécutée alors que la case Validate Consistency (Valider la cohérence) n’est pas cochée peut générer des résultats de trace inattendus. Par exemple, une entité est supprimée d’un réseau, ce qui interrompt l’unique chemin reliant l’emplacement A à l’emplacement B. Une zone à valider est créée pour l’entité supprimée. Avant de valider la topologie de réseau, un traçage est effectué afin de rechercher les entités connectées à partir de l’emplacement A, en décochant l’option Validate Consistency (Valider la cohérence). Le traçage atteint l’emplacement B et l’exécution de l’outil se termine sans avertissements. L’emplacement B a été atteint car la suppression de l’entité qui connecte A et B n’a pas été mise à jour dans la topologie de réseau par une opération de validation.

Si, dans le scénario ci-dessus, l’option Validate Consistency (Valider la cohérence) est cochée, lorsque la trace atteint la zone à valider qui signale l’entité supprimée, une erreur est renvoyée dans l’outil pour vous informer qu’une zone à valider a été trouvée et la trace échoue. Une fois la topologie validée pour la zone en cours de traçage, le parcours ne peut pas atteindre l’emplacement B, car l’entité supprimée est désormais reflétée dans la topologie. Tant que la topologie de réseau n’est pas validée pour toute l’étendue de la zone à tracer, il est probable que d’autres zones à valider soient détectées.

Option de configurationDescription

Valider la cohérence

  • Activée : l’outil renvoie une erreur si des zones à valider intersectent les entités tracées. Il s’agit de l’option par défaut.
  • Désactivée : les zones à valider sont ignorées.

Contrôler ce qui est tracé

Les barrières sont utilisées pendant un traçage pour dénoter un emplacement d’arrêt ; les entités au-delà de cet emplacement ne sont pas tracées. Les résultats d’un tracé n’incluent pas les entités au-delà d’une interruption mais peuvent inclure en option l’interruption elle-même. D’autres paramètres tels que Allow Indeterminate Flow (Autoriser la circulation indéterminée) et ceux figurant dans Advanced Options (Options avancées) aident à définir les éléments permettant de contrôler la capacité des chemins de réseau à être traversés.

Autoriser la circulation indéterminée

Lors de la réalisation d’un traçage en amont ou en aval, les fonctions d’analyse du tracé utilisent la valeur de l’attribut de réseau Flow direction afin de déterminer sa direction. Dans certains cas de figure, un sens de circulation indéterminé peut être spécifié pour des entités linéaires afin d’indiquer une circulation bidirectionnelle. Cette option indique si des entités le long d’un chemin et dont le sens de circulation est indéterminé sont tracées ou interrompent la capacité du tracé à être traversé. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval.

Option de configurationDescription

Autoriser la circulation indéterminée

  • Activée : les entités dont la circulation est indéterminée sont tracées.
  • Désactivée : les entités dont la circulation est indéterminée interrompent la capacité à être traversé le long d’un chemin et ne sont pas tracées. Il s’agit de l’option par défaut.

Options avancées

La section Advanced Options (Options avancées) de l’outil Traçage inclut les options Condition Barriers (Interruptions conditionnelles) et Function Barriers (Interruptions de fonctions) permettant de contrôler la capacité à être traversé d’un tracé. Les interruptions conditionnelles sont des expressions basées sur des attributs de réseau qui définissent où une trace doit s’arrêter. Les interruptions de fonctions définissent à quel endroit une trace doit s’arrêter lorsqu’une condition est remplie.

La portée de la capacité à être traversé est contrôlée par le paramètre traversability_scope étiqueté Apply Traversability To (Appliquer la capacité à être traversé à) dans l’outil Traçage. Ce paramètre indique si la traversabilité est appliquée aux jonctions et aux tronçons, uniquement aux jonctions ou uniquement aux tronçons. Par exemple, si la capacité à être traversé est appliquée uniquement aux jonctions et qu’un tronçon remplit la condition spécifiée dans une interruption conditionnelle, le tracé ne s’arrête pas au tronçon en raison de la portée de la capacité à être traversé.

Pour en savoir plus, reportez-vous à la rubrique Barrières.

Configurer les fonctions

Une fonction est une configuration de trace qui permet d’exécuter des calculs sur des attributs de réseau associés à des entités tracées. Il est possible d'ajouter un filtre d’attribut du réseau facultatif à chaque fonction. Une fois spécifiée, la fonction s'applique uniquement aux entités qui correspondent au filtre d'attribut de réseau. Les filtres dans les fonctions servent à introduire un critère conditionnel. Par exemple, ajoutez la longueur de toutes les lignes où l’attribut PathType comprend la valeur Paved (Goudronné). Vous pouvez spécifier plusieurs fonctions pour un traçage.

Remarque :

Les traçages utilisant des attributs de réseau répartis avec des fonctions (Ajouter, Moyenne, Total, Max, Min et Soustraire) renvoient des résultats répartis selon les tronçons. Par exemple, l’utilisation d’une fonction au sein d’un traçage de type connecté pour totaliser l’attribut shape length renvoie un total selon les entités de tronçons individuelles et non selon la ligne entière. Reportez-vous à la rubrique Attributs de réseau répartis pour plus d'informations.

Contrôler ce qui est renvoyé

Deux paramètres, Output Conditions (Conditions de sortie) et Result Types (Types de résultats), permettent de contrôler ce qui est renvoyé dans les résultats.

Conditions de sortie

Le filtre Output Conditions (Conditions de sortie) prend en charge l’utilisation d’attributs de réseau et contrôle chaque entité rencontrée dans une trace pour vérifier qu’elle répond aux critères spécifiés dans le filtre. Les attributs de réseau résident dans la topologie du réseau et sont associés à un champ d’une classe d’entités ou de plusieurs. Dans une condition en sortie, le nom de l’attribut de réseau, un opérateur et une valeur valide pour l’attribut de réseau sont spécifiés.

Prenons l’exemple d’un scénario impliquant un réseau de sentiers ; dans ce cas, un attribut de réseau est indiqué en entrée pour que les sentiers goudronnés soient renvoyés. La classe Trails (Sentiers) possède alors un champ nommé PathType. Ce champ est associé à un attribut de réseau nommé Surface (Surface). Le paramètre Output Conditions (Conditions de sortie) est configuré pour rechercher les classes d’entités dont l’attribut de réseau Surface (Surface) a pour valeur Paved (Goudronné). Les résultats du traçage incluent les entités d’une classe d’entités comportant ce champ et la valeur Paved (Goudronné), ainsi que les entités des classes ne possédant pas le champ PathType.

Vous pouvez associer plusieurs valeurs de Output Conditions (Conditions en sortie) à appliquer avec le paramètre Combine Using (Combiner en utilisant). Les deux types de sortie peuvent être utilisés et il est possible de configurer plusieurs types de sortie. Associer des types en sortie vous permet par exemple de renvoyer tous les sentiers goudronnés dont la longueur est supérieure à 1 000 mètres.

Type de résultat

Le paramètre Result Types (Types de résultat) facultatif permet de contrôler le type de résultat renvoyé par le traçage. Les types de résultat Aggregated Geometry (Géométrie agrégée), Selection (Sélection), Network Layers (Couches de réseau), Connectivity (Connectivité) et Elements (Éléments) peuvent être spécifiés indépendamment ou simultanément afin de respectivement générer des géométries en sortie, générer un ensemble de sélections, renvoyer les résultats du traçage sous forme d’ensembles de sélection sur des couches d’entités dans un groupe de couches, renvoyer un diagramme de connectivité d’entités de réseau connectées via une coïncidence géométrique ou renvoyer des informations basées sur les entités dans un fichier .json.

ParamètreOptions

Type de résultat

  • Selection (Sélection) : les résultats de l’opération de traçage sont renvoyés comme un ensemble de sélections des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • Aggregated Geometry (Géométrie agrégée) : les résultats de l’opération de traçage sont agrégés par type de géométrie et stockés dans les classes d’entités affichées dans les couches de la carte active.
  • Network Layers (Couches de réseau) : le groupe de couches créé contient les couches d’entités avec un jeu de sélection des entités renvoyées par le tracé.
  • Connectivity (Connectivité) – Les résultats du traçage sont renvoyés sous forme de diagramme de connectivité dans le fichier .json en sortie spécifié.
  • Elements (Éléments) – Les résultats du traçage sont renvoyés sous forme d’informations fondées sur les entités dans le fichier .json en sortie spécifié.

Remarque :

Pour les géodatabases d’entreprise, l’option Connectivity (Connectivité) nécessite ArcGIS Enterprise 10.9.1 ou version ultérieure.

L’option Aggregated Geometry (Géométrie agrégée) permet aux résultats de traçage d’être renvoyés en tant que géométrie multi-parties dans une classe d’entités. Cela prend en compte l’emplacement des points de début et des interruptions placés à mi-portée sur les entités tronçons pour renvoyer des résultats d’entités partielles.

Examinez les images ci-dessous pour comparer les différences entre les options de type de résultat de sélection et de géométrie agrégée dans un traçage en aval. Le réseau ci-dessous contient cinq entités linéaires (représentées en tant que f1, f2, f3, f4 et f5) composées de neuf éléments de tronçon (représentés en tant que e1, e2, e3, etc.).

Dans cet exemple, qui inclut des entités d’interruption, le résultat de la sélection renvoie cinq entités ponctuelles et trois entités linéaires composées de sept éléments de tronçon (f1::e1,e2,e3, f2::e1,e2 et f5::e1,e2). Le résultat de géométrie agrégée renvoie les mêmes entités mais exclut les éléments tronçons f1::e1,e2 et f5::e2.

Résultats de traçage en aval utilisant les options de sélection et de géométrie agrégée

Lorsqu’une interruption est placée le long d’un tronçon avec l’option de configuration Include Barrier Features (Inclure les entités d’interruption) cochée, le traçage s’arrête à l’entité d’interruption et renvoie la géométrie d’entité partielle pour le tronçon dans les résultats de traçage. Si l’option Include Barrier Features (Inclure les entités d’interruption) n’est pas cochée, le traçage s’arrête à la fin de ligne ou la jonction précédente rencontrée avec une connectivité à mi-portée.

Les images ci-dessous affichent la différence dans les résultats de la trace lorsque l’option Include Barrier Features (Inclure les entités d’interruption) inclut ou exclut les entités d’interruption dans les résultats de la trace. Dans cet exemple, le point de début et l’interruption sont placés le long d’un tronçon. Lorsque cette option est activée, le résultat de la sélection renvoie quatre entités ponctuelles et trois entités linéaires composées de sept éléments de tronçon (f1::e1,e2,e3, f2::e1,e2 et f5::e1,e2). Le résultat de type géométrie agrégée renvoie les mêmes trois entités mais exclut les éléments de tronçon f1::e1 et f5::e2. Le résultat de sélection ne changerait pas si nous devions exclure les entités d’interruption en ne cochant pas l’option Include Barrier Features (Inclure les entités d’interruption) ; toutefois, les résultats de géométrie agrégée excluraient en plus f1::e2.

Comparaison des résultats de la trace avec l’option de configuration Include Barrier Features (Inclure les entités d’interruption) activée et désactivée

Lorsque l’option Aggregated Geometry (Géométrie agrégée) est sélectionnée pour le type de résultat, quatre paramètres supplémentaires sont proposés pour défini le comportement en sortie de la trace.

  • Effacer tous les résultats de trace précédents
  • Nom de la trace
  • Points agrégés
  • Lignes agrégées

La case à cocher Clear All Previous Trace Results (Effacer tous les résultats de traçage précédents) permet de tronquer le contenu des classes d’entités choisies pour stocker la géométrie agrégée ou lui ajouter des éléments. L'option par défaut remplace les résultats de traçage précédents et présente la géométrie agrégée uniquement pour l'opération de traçage actuelle.

ParamètreOptions

Effacer tous les résultats de trace précédents

  • Cochée : les classes d’entités stockant la géométrie de traçage agrégée sont tronquées. Seule la géométrie en sortie issue de l’opération actuelle de traçage sera écrite. Il s’agit de l’option par défaut.
  • Non cochée : la géométrie en sortie issue de l’opération de traçage actuelle est ajoutée aux classes d’entités qui stockent la géométrie agrégée.

Le paramètre facultatif Trace Name (Nom de la trace) permet de créer un identifiant de chaîne pour l’opération de traçage qui facilite l’identification des résultats de trace. S'il est utilisé avec la case du paramètre Clear All Previous Trace Results (Effacer tous les résultats de trace précédents) décochée, il permet d'exécuter plusieurs opérations de trace et de comparer les résultats dans les classes d’entités de la géométrie agrégée en sortie.

Les paramètres Aggregated Points (Points agrégés) et Aggregated Lines (Lignes agrégées) vous permettent de spécifier des classes d’entités pour le stockage de la géométrie résultante agrégée. Par défaut, chaque paramètre est renseigné avec une classe d’entités générée par le système stockée dans la géodatabase par défaut du projet :

  • Trace_Results_Aggregated_Lines : classe d’entités linéaires
  • Trace_Results_Aggregated_Points : classe d’entités multi-points

Ces classes d’entités sont automatiquement créées si elles n’existent pas. Il est également possible d’utiliser des classes d’entités existantes pour stocker la géométrie agrégée. Si une classe d’entités autre que la classe d’entités par défaut est utilisée, elle doit contenir un champ de type chaîne nommé TRACENAME et correspondre au type de géométrie de la sortie.

La génération de géométrie en sortie avec les résultats d’entité partielle offre une représentation plus précise du traçage et permet de comparer et de réutiliser les résultats de traçage pour d’autres tâches.

Remarque :

La désactivation de l’option de géotraitement Allow geoprocessing tools to overwrite existing datasets (Autoriser les outils de géotraitement à remplacer les jeux de données existants) peut générer des problèmes de validation d’outil si les classes d’entités en sortie pour les types de résultat de géométrie agrégée existent dans la géodatabase par défaut du projet. Pour résoudre ce problème, activez l’option de géotraitement ou renommez les classes d’entités ponctuelles, linéaires et surfaciques agrégées dans la géodatabase par défaut du projet.

Lorsque l’option Selection (Sélection) est sélectionnée pour le type de résultat, un paramètre Selection Type (Type de sélection) supplémentaire est fourni pour définir la manière dont la sélection sera appliquée et l’action à effectuer s’il existe déjà une sélection.

ParamètreOptions

Type de sélection

  • New selection (Nouvelle sélection) : la sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut.
  • Add to the current selection (Ajouter à la sélection courante) : la sélection obtenue est ajoutée à la sélection courante s’il en existe une. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.
  • Remove from the current selection (Supprimer de la sélection courante) : la sélection obtenue est supprimée de la sélection courante. S’il n’existe aucune sélection, cette option ne produit aucun effet.
  • Select subset from the current selection (Sélectionner le sous-ensemble de la sélection courante) : la sélection obtenue est combinée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés.
  • Switch the current selection (Passer à la sélection courante) : la sélection obtenue est changée. Les résultats qui étaient sélectionnés sont supprimés de la sélection actuelle, tandis que les résultats qui ne l’étaient pas sont ajoutés à la sélection actuelle. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection.

L’option de type de résultat Network Layers (Couches de réseau) permet de renvoyer les résultats de traçage sous forme de jeux de sélection de couches d’entités d’un groupe de couches. Lorsque cette option est sélectionnée dans ArcGIS Pro, un nouveau groupe de couches est ajouté à la carte. Des couches d’entités sont uniquement créées pour les classes contenant des entités renvoyées par le tracé. Chaque couche d’entités contient un jeu de sélection d’entités renvoyées par le tracé et utilisables avec les résultats d’un tracé dans ModelBuilder et Python.

Lorsque l’option Network Layers (Couches de réseau) est sélectionnée, un paramètre supplémentaire Output Group Layer Name (Nom du groupe de couches en sortie) est fourni pour nommer le groupe de couches créé en sortie. Si vous utilisez ArcGIS Pro, un nouveau groupe de couches portant le nom spécifié est ajouté à la carte active.

L'option de type de résultat Connectivity (Connectivité) renvoie les résultats du traçage sous forme de diagramme de connectivité d’entités de réseau connectées par coïncidence géométrique. Lorsque cette option est sélectionnée, la connectivité est restituée dans un fichier .json à l’emplacement spécifié, qui peut être analysé et importé dans d’autres systèmes pour créer votre propre diagramme de représentation des données. Les informations de connectivité sont uniquement renvoyées pour les entités de réseau qui sont elles-mêmes renvoyées par le traçage.

Lorsque l’option Connectivity (Connectivité) est sélectionnée pour le type de résultat, un paramètre Output JSON (JSON en sortie) supplémentaire est spécifié pour indiquer l’emplacement du fichier .json en sortie.

L'option de type de résultat Elements (Éléments) renvoie les résultats du traçage sous forme d’informations fondées sur les entités. Lorsque cette option est sélectionnée, les informations fondées sur les entités sont restituées dans un fichier .json à l’emplacement spécifié, qui peut être utilisé comme entrée pour effectuer une analyse supplémentaire.

Lorsque l’option Elements (Éléments) est sélectionnée, un paramètre Output JSON (JSON en sortie) supplémentaire est spécifié pour indiquer l’emplacement du fichier .json en sortie. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous elements :

  • networkSourceId
  • globalId
  • objectId

Des informations supplémentaires sont renvoyées pour les entités linéaires :

  • positionFrom et positionTo

Charger des configurations de traçage nommées

Les configurations de traçage nommées permettent de créer des traçages complexes à des fins de partage et de réutilisation. L’outil Traçage vous permet de charger une configuration de traçage nommée existante pour définir les propriétés d’un traçage. Cela simplifie l’expérience utilisateur associée au traçage et assure une cohérence via la réutilisation des traçages courants dans une organisation.

ParamètreOptions

Use Trace Configuration (Utiliser la configuration du tracé)

  • Activée : l’outil utilise une configuration de traçage nommée existante pour définir les propriétés du traçage. Lorsque cette option est activée, seuls les paramètres Trace Configuration Name (Nom de la configuration du tracé), Starting Points (Points de départ) et Barriers (Interruptions) sont affichés. Lorsqu’une configuration de tracé qui utilise l’option de types de résultat de géométrie agrégée est chargée, les paramètres Aggregated Points (Points agrégés) et Aggregated Lines (Lignes agrégées) sont également affichés.
  • Désactivée : l’outil n’utilise pas de configuration de traçage nommée pour définir les propriétés du traçage. Il s’agit de l’option par défaut.

Un paramètre Trace Configuration Name (Nom de la configuration du tracé) est fourni pour spécifier le nom de la configuration du tracé à utiliser pour définir les propriétés du tracé. Ce paramètre n’est disponible que si l’option Use Trace configuration (Utiliser la configuration du tracé) est activée.

Remarque :

Vous pouvez également utiliser l’onglet Named Configurations (Configurations nommées) de la fenêtre Trace (Traçage) pour exécuter un traçage à l’aide d’une configuration de tracé nommée déjà configurée.

En savoir plus sur les configurations de traçage nommées