Traçage (Réseau de traces)

Synthèse

Renvoie des entités sélectionnées dans un réseau de traces en fonction de la connectivité ou de la traversabilité (capacité à être traversé) et à partir des points de départ spécifiés.

Les fonctionnalités de traçage du réseau de traces vous permettent d’analyser les chemins dans votre réseau. La traversabilité, ou capacité à être traversé, concerne les chemins établis par les entités connectées qui répondent également aux exigences de configuration.

Par défaut, les résultats du traçage sont renvoyés en tant que sélection et incluent l’intégralité de l’entité linéaire. Pour renvoyer des résultats d’entités partiels, définissez le paramètre Result Types (Types de résultats) sur Aggregate Geometry (Agréger la géométrie). Lorsqu’un point de départ ou une interruption est placé sur une jonction avec une connectivité à mi-portée, les résultats du traçage renvoient des éléments partiels de l’entité tronçon. Lorsqu’une interruption est placée sur un tronçon, les résultats du traçage peuvent être arrêtés à la jonction la plus proche avec une connectivité à mi-portée. L’ensemble de sélection ou la classe d’entités en sortie obtenus par traçage peut ensuite se propager vers une autre carte, une vue de diagramme du réseau ou servir d’entrée pour un autre outil ou une autre trace.

En savoir plus sur le traçage d’un réseau de traces

Utilisation

• La topologie du réseau doit être activée.

• Lorsque vous utilisez une géodatabase entreprise, le réseau de traces en entrée doit provenir d’un service d’entités ; les réseaux de traces issus d’une connexion à une base de données ne sont pas pris en charge.

• Étant donné que l’outil Traçage repose sur la topologie du réseau, la précision des résultats du traçage n’est pas garantie si des zones à valider se trouvent dans l’étendue de la trace. La topologie du réseau pour la zone à tracer doit être validée pour refléter les modifications ou les mises à jour les plus récentes apportées au réseau.

• Lorsque vous utilisez des attributs de réseau affectés à un champ de date pour les interruptions conditionnelles, les interruptions de fonctions, les fonctions et les conditions de sortie, la valeur de date doit avoir le format yyyy-mm-dd hh:mm:ss (par exemple, 2020-10-12 18:45:31).

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Réseau de traces en entrée	Réseau de traces sur lequel le traçage est exécuté. Lorsque vous utilisez une géodatabase entreprise, le réseau de traces en entrée doit provenir d’un service d’entités ; les réseaux de traces issus d’une connexion à une base de données ne sont pas pris en charge.	Trace Network; Trace Network Layer
Type de traçage	Spécifie le type de traçage à exécuter. Connected (Connecté) : un traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. Upstream (En amont) : un traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. Downstream (En aval) : un traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. Shortest path (Chemin le plus court) : un traçage qui recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux, est utilisé. Le coût de la traversée du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre Shortest Path Network Attribut Name (Nom d’attribut de réseau du chemin le plus court). Connecté—Un traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. En amont—Un traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. En aval—Un traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. Plus court chemin—Un traçage du chemin le plus court qui recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux, est utilisé. Le coût de la traversée du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre shortest_path_network_attribute_name.	String
Points de début	Couche d’entités créée dans l’onglet Starting Points (Points de départ) de la fenêtre Trace Locations (Localisations de traçage), ou table ou classe d’entités contenant un ou plusieurs enregistrements qui représentent les points de départ du traçage. La classe d’entités TN_Temp_Starting_Points est utilisée par défaut et générée dans la géodatabase par défaut du projet lorsque vous créez des points de départ à l’aide de l’outil Starting Points (Points de départ) dans la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
Interruptions (Facultatif)	Table ou classe d’entités contenant une ou plusieurs entités représentant les interruptions qui empêchent le traçage d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et générée dans la géodatabase par défaut du projet lors de la création des interruptions dans l’onglet Barriers (Interruptions) de la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
Direction du chemin (Facultatif)	Indique la direction du chemin de traçage. Le coût de la traversée du chemin est déterminé en fonction de la valeur du paramètre Shortest Path Network Attribut Name (Nom de l’attribut de réseau du chemin le plus court). Ce paramètre est respecté uniquement lors de l’exécution d’un traçage de type Shortest path (Chemin le plus court). Aucun sens—Le chemin entre les deux points de départ, quel que soit le sens de flux, est utilisé. Il s’agit de l’option par défaut. Chemin en amont—Le chemin en amont entre les deux points de départ est utilisé. Chemin en aval—Le chemin en aval entre les deux points de départ est utilisé.	String
Nom d’attribut de réseau du chemin le plus court (Facultatif)	Nom de l’attribut de réseau utilisé pour calculer le chemin. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.	String
Inclure les entités d’interruption (Facultatif)	Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Coché - Les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Il s’agit de l’option par défaut. Non coché - Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de la recherche de parcours.	Boolean
Valider la cohérence (Facultatif)	Indique si une erreur est renvoyée lorsque des zones à valider figurent dans les entités renvoyées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau. Activé : le parcours retourne une erreur si une zone à valider figure dans les entités traversées. Désactivé : le traçage renvoie des résultats, que des zones à valider figurent ou non dans les entités renvoyées. Il s’agit de l’option par défaut.	Boolean
Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début) (Facultatif)	Indique si les interruptions dans la configuration de tracé sont ignorées pour les points de départ. Activé : les interruptions aux points de début sont ignorées dans le traçage. Désactivé : les interruptions aux points de début ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.	Boolean
Autoriser la circulation indéterminée (Facultatif)	Indique si les entités dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval. Activé : les entités dont le sens de flux est non initialisé ou indéterminé sont tracées. Désactivé : les entités dont le sens de flux est non initialisé ou indéterminé ne sont pas tracées. Il s’agit de l’option par défaut.	Boolean
Interruptions conditionnelles (Facultatif)	Définit une interruption conditionnelle de traversabilité (capacité à être traversé) sur les entités en fonction d’une comparaison avec un attribut de réseau. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Code d’une entité est égal à la valeur spécifique de ArtificialPath. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le paramètre Combine Using (Combiner en utilisant) pour définir une condition And (Et) ou une condition Or (Ou). Les composants d’interruptions conditionnelles sont les suivants : Name (Nom) : filtrez selon un attribut de réseau défini dans le système. Operator (Opérateur) : choisissez un des opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur spécifiée dans le composant Name (Nom). Value (Valeur) : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur. Combine using (Utilisation combinée) : définissez cette valeur si vous voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou Or (Ou). Les composants Operator (Opérateur) sont les suivants : Is equal to (Est égal à) : l’attribut est égal à la valeur. Does not equal (Est différent de) : l’attribut est différent de la valeur. Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur. Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur. Is less than (Est inférieur à) : l’attribut est inférieur à la valeur. Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur. Les composants Type sont les suivants : Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique. Network Attribute (Attribut de réseau) : filtrez en fonction d’un attribut de réseau. Les composants Combine using (Combiner en utilisant) sont les suivants : And (Et) : combine les interruptions conditionnelles. Or (Ou) : utilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite. Est égal à—L’attribut est égal à la valeur. Est différent de—L’attribut est différent de la valeur. Est supérieur à—L’attribut est supérieur à la valeur. Est supérieur ou égal à—L’attribut est supérieur ou égal à la valeur. Est inférieur à—L’attribut est inférieur à la valeur. Est inférieur ou égal à—L’attribut est inférieur ou égal à la valeur. Valeur spécifique—Filtrez en fonction d’une valeur spécifique. Attribut de réseau—Filtrez en fonction d’un attribut de réseau. Et—Combinez les interruptions conditionnelles. Ou—Utilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.	Value Table
Interruptions de fonctions (Facultatif)	Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions de fonctions peuvent être utilisées, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de départ ou pour définir une valeur maximale à laquelle arrêter une trace. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête. Les composants d’interruptions de fonctions sont les suivants : Function (Fonction) : choisissez une des fonctions de calcul. Attribute (Attribut) : filtrez selon un attribut de réseau défini dans le système. Operator (Opérateur) : choisissez un des opérateurs. Value (Valeur) : valeur spécifique du type d’attribut en entrée qui, en cas d’identification, entraînera l’arrêt. Use Local Values (Utiliser les valeurs locales) : calcule les valeurs dans chaque direction par opposition à une valeur globale. Considérons, par exemple, une interruption de fonction qui calcule la somme de longueur de forme à laquelle le traçage s’interrompt si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4 de sorte que la recherche de parcours s’arrête. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit. Les composants Function (Fonction) sont les suivants : Minimum : minimum des valeurs en entrée. Maximum : maximum des valeurs en entrée. Add (Additionner) : somme des valeurs en entrée. Average (Moyenne) : moyenne des valeurs en entrée. Count (Nombre) : nombre d’entités. Subtract (Soustraire) : différence entre les valeurs en entrée. Considérons, par exemple, une entité de point de départ dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20, le maximum est de 30, la somme est de 50, la moyenne est de 25, le nombre est de 2, et la différence est de -10. Les composants Operator (Opérateur) sont les suivants : Is equal to (Est égal à) : l’attribut est égal à la valeur. Does not equal (Est différent de) : l’attribut est différent de la valeur. Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur. Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur. Is less than (Est inférieur à) : l’attribut est inférieur à la valeur. Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur. Les composants Use Local Values (Utiliser les valeurs locales) sont les suivants : Coché - Les valeurs locales sont utilisées. Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut. Moyenne—Moyenne des valeurs en entrée. Effectif—Nombre d’entités. Max.—Maximum des valeurs en entrée. Min—Minimum des valeurs en entrée. Addition—Ajoutez les valeurs. Soustraire—Soustrayez les valeurs. Est égal à—L’attribut est égal à la valeur. Est différent de—L’attribut est différent de la valeur. Est supérieur à—L’attribut est supérieur à la valeur. Est supérieur ou égal à—L’attribut est supérieur ou égal à la valeur. Est inférieur à—L’attribut est inférieur à la valeur. Est inférieur ou égal à—L’attribut est inférieur ou égal à la valeur.	Value Table
Appliquer la traversabilité à (Facultatif)	Spécifie le type de traversabilité (capacité à être traversé) à appliquer. La portée de la traversabilité détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Par exemple, dans un réseau de pistes de loisirs, si une interruption conditionnelle est définie pour arrêter une trace lorsqu’un attribut surfacetype est défini comme étant du gravier et que la portée de la traversabilité est définie sur les jonctions uniquement, la trace ne s’arrêtera pas, même si elle rencontre une entité tronçon avec cette valeur dans le champ surfacetype, car l’attribut surfacetype s’applique uniquement aux tronçons. Jonctions et tronçons—La traversabilité s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. Jonctions uniquement—La traversabilité s’applique uniquement aux jonctions. Tronçons uniquement—La traversabilité s’applique uniquement aux tronçons.	String
Fonctions (Facultatif)	Fonction(s) de calcul appliquée(s) aux résultats du traçage. Les composants des fonction sont les suivants : Function (Fonction) : choisissez une des fonctions de calcul. Attribute (Attribut) : filtrez selon un attribut de réseau défini dans le système. Filter Name (Nom du filtre) : filtrez les résultats de la fonction par nom d’attribut. Filter Operator (Opérateur de filtrage) : choisissez un des opérateurs. Filter Type (Type de filtre) : choisissez un des types de filtre. Filter Value (Valeur de filtrage) : fournissez une valeur spécifique de l’attribut de filtrage en entrée. Les options des composants Function (Fonction) sont les suivantes : Min : minimum des valeurs en entrée. Max : maximum des valeurs en entrée. Add (Ajouter) : somme des valeurs en entrée. Average (Moyenne) : moyenne des valeurs en entrée. Count (Nombre) : nombre d’entités. Subtract (Soustraire) : différence entre les valeurs en entrée. Considérons, par exemple, une entité de point de départ dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Min, le résultat est égal à 20. Le résultat est de 30 pour Max, de 50 pour Add (Ajouter), de 25 pour Average (Moyenne), de 2 pour Count (Nombre) et de -10 pour Substract (Soustraire). Les options des composants Filter Operator (Opérateur de filtre) sont les suivantes : Is equal to (Est égal à) : l’attribut est égal à la valeur. Does not equal (Est différent de) : l’attribut est différent de la valeur. Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur. Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur. Is less than (Est inférieur à) : l’attribut est inférieur à la valeur. Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur. Les options des composants Filter Type (Type de filtre) sont les suivantes : Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique. Network Attribute (Attribut de réseau) : filtrez en fonction d’un attribut de réseau. Moyenne—Moyenne des valeurs en entrée. Effectif—Nombre d’entités. Max.—Maximum des valeurs en entrée. Min—Minimum des valeurs en entrée. Addition—La somme des valeurs. Soustraire—La différence entre les valeurs. Est égal à—L’attribut est égal à la valeur. Est différent de—L’attribut est différent de la valeur. Est supérieur à—L’attribut est supérieur à la valeur. Est supérieur ou égal à—L’attribut est supérieur ou égal à la valeur. Est inférieur à—L’attribut est inférieur à la valeur. Est inférieur ou égal à—L’attribut est inférieur ou égal à la valeur.	Value Table
Conditions de sortie (Facultatif)	Types des entités renvoyées selon un attribut de réseau. Par exemple, sur un tracé configuré pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle l’attribut Tap (Dérivation) n’est pas attribué n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélections résultant. Les composants des Conditions de sortie sont les suivants : Name (Nom) : filtrez selon un attribut de réseau défini dans le système. Operator (Opérateur) : choisissez un des opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur spécifiée dans le composant Name (Nom). Value (Valeur) : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur. Combine using (Utilisation combinée) : définissez cette valeur si vous voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou Or (Ou). Les options des composants Operator (Opérateur) sont les suivantes : Is equal to (Est égal à) : l’attribut est égal à la valeur. Does not equal (Est différent de) : l’attribut est différent de la valeur. Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur. Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur. Is less than (Est inférieur à) : l’attribut est inférieur à la valeur. Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur. Les options des composants Type sont les suivantes : Specific value (Valeur spécifique) : filtrez en fonction d’une valeur spécifique. Network Attribute (Attribut de réseau) : filtrez en fonction d’un attribut de réseau. Est égal à—L’attribut est égal à la valeur. Est différent de—L’attribut est différent de la valeur. Est supérieur à—L’attribut est supérieur à la valeur. Est supérieur ou égal à—L’attribut est supérieur ou égal à la valeur. Est inférieur à—L’attribut est inférieur à la valeur. Est inférieur ou égal à—L’attribut est inférieur ou égal à la valeur.	Value Table
Type de résultat (Facultatif)	Spécifie le type de résultat renvoyé par le traçage. Sélection—Les résultats du traçage sont renvoyés en tant qu’ensemble de sélection des entités de réseau appropriées. Il s’agit de l’option par défaut. Géométrie agrégée—Les résultats du traçage sont agrégés par type de géométrie et stockés dans des classes d’entités affichées dans les couches de la carte active. Couches de réseau—Les résultats du traçage sont ajoutés aux couches d’entités en tant qu’ensemble de sélection dans un groupe de couches. Connectivité—Les résultats du traçage sont renvoyés sous forme d’un graphe de connectivité dans un fichier .json en sortie spécifié. Cette option active le paramètre Output JSON (JSON en sortie). Eléments—Les résultats du traçage sont renvoyés sous forme d’informations basées sur les entités dans un fichier .json en sortie spécifié. Cette option active le paramètre Output JSON (JSON en sortie).	String
Type de sélection	Spécifie la manière dont la sélection est appliquée et la marche à suivre si une sélection existe déjà. Nouvelle sélection—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. Ajouter à la sélection actuelle—La sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection. Supprimer de la sélection actuelle—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. Sélectionner un sous-ensemble à partir de la sélection actuelle—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés. Inverser la sélection actuelle—La sélection obtenue est inversé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.	String
Effacer tous les résultats de trace précédents (Facultatif)	Indique si le contenu sera tronqué des classes d’entités choisies ou ajouté à ces dernières pour stocker la géométrie agrégée. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée. Activé : les classes d’entités qui stockent 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. Désactivé : 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.	Boolean
Nom de la trace (Facultatif)	Nom de l’opération de traçage. Cette valeur est stockée dans le champ TRACENAME de la classe d’entités en sortie pour contribuer à l’identification des résultats de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	String
Points agrégés (Facultatif)	Classe d’entités multi-points en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Points, qui est stockée dans la géodatabase par défaut du projet. Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités multi-points contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	Feature Class
Lignes agrégées (Facultatif)	Classe d’entités polylignes en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Lines, qui est stockée dans la géodatabase par défaut du projet. Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités polylignes contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	Feature Class
Nom du groupe de couches en sortie (Facultatif)	Nom du groupe de couches en sortie qui contient les couches d’entités avec les ensembles de sélection d’entités renvoyés par le traçage. Cette couche permet d’accéder à la sortie d’un traçage et de l’utiliser dans ModelBuilder et Python. Ce paramètre ne s’applique qu’au type de résultat Couches de réseau.	Group Layer
Use Trace Configuration (Utiliser la configuration du tracé) (Facultatif)	Indique si une configuration de tracé nommée existante doit être utilisée pour renseigner les paramètres de l’outil Traçage. Activé : une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Tous les paramètres, excepté Trace Configuration Name (Nom de la configuration du tracé), Starting Points (Points de départ) et Barriers (Interruptions) sont ignorés. Désactivé : une configuration de tracé nommée existante n’est pas utilisée pour définir les propriétés du traçage. Il s’agit de l’option par défaut. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure.	Boolean
Nom de la configuration de tracé (Facultatif)	Nom de la configuration de tracé à utiliser pour définir les propriétés du traçage. Ce paramètre n’est actif que si le paramètre Use Trace Configuration (Utiliser une configuration de tracé) est sélectionné. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure.	String
JSON en sortie (Facultatif)	Nom et emplacement du fichier .json qui est généré.	File

Sortie obtenue

Étiquette	Explication	Type de données
Réseau de traces mis à jour	Réseau de traces actualisé.	Any Value

Python

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})

Nom	Explication	Type de données
in_trace_network	Réseau de traces sur lequel le traçage est exécuté. Lorsque vous utilisez une géodatabase entreprise, le réseau de traces en entrée doit provenir d’un service d’entités ; les réseaux de traces issus d’une connexion à une base de données ne sont pas pris en charge.	Trace Network; Trace Network Layer
trace_type	Spécifie le type de traçage à exécuter. CONNECTED—Un traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. UPSTREAM—Un traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. DOWNSTREAM—Un traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Ce type de traçage requiert que le sens de flux soit défini. SHORTEST_PATH—Un traçage du chemin le plus court qui recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux, est utilisé. Le coût de la traversée du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre shortest_path_network_attribute_name.	String
starting_points	Couche d’entités créée dans l’onglet Starting Points (Points de départ) de la fenêtre Trace Locations (Localisations de traçage), ou table ou classe d’entités contenant un ou plusieurs enregistrements qui représentent les points de départ du traçage. La classe d’entités TN_Temp_Starting_Points est utilisée par défaut et générée dans la géodatabase par défaut du projet lorsque vous créez des points de départ à l’aide de l’outil Starting Points (Points de départ) dans la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
barriers (Facultatif)	Table ou classe d’entités contenant une ou plusieurs entités représentant les interruptions qui empêchent le traçage d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et générée dans la géodatabase par défaut du projet lors de la création des interruptions dans l’onglet Barriers (Interruptions) de la fenêtre Trace Locations (Localisations de traçage).	Feature Layer; Table View
path_direction (Facultatif)	Indique la direction du chemin de traçage. Le coût de la traversée du chemin est déterminé en fonction de la valeur du paramètre shortest_path_network_attribute_name. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage de type SHORTEST_PATH. NO_DIRECTION—Le chemin entre les deux points de départ, quel que soit le sens de flux, est utilisé. Il s’agit de l’option par défaut. PATH_UPSTREAM—Le chemin en amont entre les deux points de départ est utilisé. PATH_DOWNSTREAM—Le chemin en aval entre les deux points de départ est utilisé.	String
shortest_path_network_attribute_name (Facultatif)	Nom de l’attribut de réseau utilisé pour calculer le chemin. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.	String
include_barriers (Facultatif)	Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. INCLUDE_BARRIERS—Les entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut. EXCLUDE_BARRIERS—Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	Boolean
validate_consistency (Facultatif)	Indique si une erreur est renvoyée lorsque des zones à valider figurent dans les entités renvoyées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau. VALIDATE_CONSISTENCY—Le traçage renvoie une erreur si des zones à valider figurent dans les entités renvoyées. DO_NOT_VALIDATE_CONSISTENCY—Le traçage renvoie des résultats que des zones à valider figurent ou non dans l’une des entités renvoyées. Il s’agit de l’option par défaut.	Boolean
ignore_barriers_at_starting_points (Facultatif)	Indique si les interruptions dans la configuration de tracé sont ignorées pour les points de départ. IGNORE_BARRIERS_AT_STARTING_POINTS—Les interruptions au points de départ sont ignorées dans le traçage. DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Les interruptions au points de départ ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.	Boolean
allow_indeterminate_flow (Facultatif)	Indique si les entités dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval. TRACE_INDETERMINATE_FLOW—Les entités dont le sens de flux est indéterminé ou non initialisé sont tracées. IGNORE_INDETERMINATE_FLOW—Les entités dont le sens de flux est indéterminé ou non initialisé ne sont pas tracées. Il s’agit de l’option par défaut.	Boolean
condition_barriers [Name, Operator, Type, Value, Combine Using,...] (Facultatif)	Définit une interruption conditionnelle de traversabilité (capacité à être traversé) sur les entités en fonction d’une comparaison avec un attribut de réseau. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Code d’une entité est égal à la valeur spécifique de ArtificialPath. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le composant Combine Using pour définir une condition And (Et) ou une condition Or (Ou). Les composants d’interruptions conditionnelles sont les suivants : Name : filtrez en fonction de n’importe quel attribut de réseau défini dans le système. Operator : faites votre choix parmi les différents opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur spécifiée dans le composant Name. Value : indiquez la valeur spécifique pour le type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur. Combine Using : définissez cette valeur si vous voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou). Les composants Operator sont les suivants : IS_EQUAL_TO—L’attribut est égal à la valeur. DOES_NOT_EQUAL—L’attribut est différent de la valeur. IS_GREATER_THAN—L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN—L’attribut est inférieur à la valeur. IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur. Les composants Type sont les suivants : SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau. Les composants Combine Using sont les suivants : AND—Combinez les interruptions conditionnelles. OR—Utilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.	Value Table
function_barriers [Function, Attribute, Operator, Value, Use Local Values,...] (Facultatif)	Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions de fonctions peuvent être utilisées, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de départ ou pour définir une valeur maximale à laquelle arrêter une trace. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête. Les composants d’interruptions de fonctions sont les suivants : Function : choisissez l’une des fonctions de calcul. Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système. Operator : choisissez l’un des opérateurs. Value : indiquez la valeur spécifique du type d’attribut en entrée qui, si elle est trouvée, va entraîner l’arrêt. Use Local Values : calcule les valeurs dans chaque sens, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de longueur de forme à laquelle le traçage s’interrompt si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4 de sorte que la recherche de parcours s’arrête. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit. Les composants Function sont les suivants : AVERAGE—Moyenne des valeurs en entrée. COUNT—Nombre d’entités. MAX—Maximum des valeurs en entrée. MIN—Minimum des valeurs en entrée. ADD—Ajoutez les valeurs. SUBTRACT—Soustrayez les valeurs. Les composants Operator sont les suivants : IS_EQUAL_TO—L’attribut est égal à la valeur. DOES_NOT_EQUAL—L’attribut est différent de la valeur. IS_GREATER_THAN—L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN—L’attribut est inférieur à la valeur. IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur. Les composants Use Local Values sont les suivants : TRUE—Utilisez les valeurs locales. FALSE—Utilisez les valeurs globales. Il s’agit de l’option par défaut.	Value Table
traversability_scope (Facultatif)	Spécifie le type de traversabilité (capacité à être traversé) à appliquer. La portée de la traversabilité détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Par exemple, dans un réseau de pistes de loisirs, si une interruption conditionnelle est définie pour arrêter la trace lorsque le type de piste est défini comme étant du gravier et que la portée de la traversabilité est définie sur les jonctions uniquement, la trace ne s’arrêtera pas, même si elle rencontre un chemin en gravier, car le type de chemin s’applique uniquement aux tronçons. BOTH_JUNCTIONS_AND_EDGES—La traversabilité s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. JUNCTIONS_ONLY—La traversabilité s’applique uniquement aux jonctions. EDGES_ONLY—La traversabilité s’applique uniquement aux tronçons.	String
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Facultatif)	Fonction(s) de calcul appliquée(s) aux résultats du traçage. Les composants des fonction sont les suivants : Function : choisissez l’une des fonctions de calcul. Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système. Filter Name : filtrez les résultats de fonction par nom d’attribut. Filter Operator : choisissez l’un des opérateurs. Filter Type : choisissez l’un des types de filtre. Filter Value : indiquez une valeur spécifique pour l’attribut de filtre en entrée. Les options des composants Function sont les suivantes : AVERAGE—Moyenne des valeurs en entrée. COUNT—Nombre d’entités. MAX—Maximum des valeurs en entrée. MIN—Minimum des valeurs en entrée. ADD—La somme des valeurs. SUBTRACT—La différence entre les valeurs. Considérons, par exemple, une entité de point de départ dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MIN, le résultat est de 20. Il est de 30 pour MAX, de 50 pour ADD, de 25 pour AVERAGE, de 2 pour COUNT et de -10 pour SUBTRACT. Les options des composants Filter Operator sont les suivantes : IS_EQUAL_TO—L’attribut est égal à la valeur. DOES_NOT_EQUAL—L’attribut est différent de la valeur. IS_GREATER_THAN—L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN—L’attribut est inférieur à la valeur. IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur. Les options des composants Filter Type sont les suivantes : SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau.	Value Table
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Facultatif)	Types des entités renvoyées selon un attribut de réseau. Par exemple, sur un tracé configuré pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle l’attribut Tap (Dérivation) n’est pas attribué n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélections résultant. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition And (Et) ou une condition Or (Ou). Les composants des Conditions de sortie sont les suivants : Name : filtrez en fonction de n’importe quel attribut de réseau défini dans le système. Operator : choisissez l’un des opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur = spécifiée dans le composant Name. Value : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur. Combine Using : définissez cette valeur si vous voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou). Les options des composants Operator sont les suivantes : IS_EQUAL_TO—L’attribut est égal à la valeur. DOES_NOT_EQUAL—L’attribut est différent de la valeur. IS_GREATER_THAN—L’attribut est supérieur à la valeur. IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur. IS_LESS_THAN—L’attribut est inférieur à la valeur. IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur. Les options des composants Type sont les suivantes : SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique. NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau. Les options des composants Combine Using sont les suivantes : AND—Combinez les conditions. OR—Utilisez ce paramètre si l’une des conditions est satisfaite.	Value Table
result_types [result_types,...] (Facultatif)	Spécifie le type de résultat renvoyé par le traçage. SELECTION—Les résultats du traçage sont renvoyés en tant qu’ensemble de sélection des entités de réseau appropriées. Il s’agit de l’option par défaut. AGGREGATED_GEOMETRY—Les résultats du traçage sont agrégés par type de géométrie et stockés dans des classes d’entités affichées dans les couches de la carte active. NETWORK_LAYERS—Les résultats du traçage sont ajoutés aux couches d’entités en tant qu’ensemble de sélection dans un groupe de couches. CONNECTIVITY—Les résultats du traçage sont renvoyés sous forme d’un graphe de connectivité dans un fichier .json en sortie spécifié. Cette option active le paramètre out_json_file. ELEMENTS—Les résultats du traçage sont renvoyés sous forme d’éléments d’entité dans un fichier .json en sortie spécifié. Cette option active le paramètre out_json_file.	String
selection_type	Spécifie la manière dont la sélection est appliquée et la marche à suivre si une sélection existe déjà. NEW_SELECTION—La sélection obtenue remplace la sélection courante. Il s’agit de l’option par défaut. ADD_TO_SELECTION—La sélection obtenue est ajoutée à la sélection courante si celle-ci existe. S’il n’existe aucune sélection, elle est identique à la nouvelle sélection. REMOVE_FROM_SELECTION—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. SUBSET_SELECTION—La sélection obtenue est associée à la sélection courante. Seuls les enregistrements communs aux deux restent sélectionnés. SWITCH_SELECTION—La sélection obtenue est inversé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.	String
clear_all_previous_trace_results (Facultatif)	Indique si le contenu sera tronqué des classes d’entités choisies ou ajouté à ces dernières pour stocker la géométrie agrégée. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée. CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Les classes d’entités qui stockent 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. DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS—La géométrie en sortie issue de l’opération de traçage actuelle sera ajoutée aux classes d’entités qui stockent la géométrie agrégée.	Boolean
trace_name (Facultatif)	Nom de l’opération de traçage. Cette valeur est stockée dans le champ TRACENAME de la classe d’entités en sortie pour contribuer à l’identification des résultats de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	String
aggregated_points (Facultatif)	Classe d’entités multi-points en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Points, qui est stockée dans la géodatabase par défaut du projet. Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités multi-points contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	Feature Class
aggregated_lines (Facultatif)	Classe d’entités polylignes en sortie qui contient la géométrie de résultat agrégée. Par défaut, ce paramètre est renseigné avec une classe d’entités générée par le système intitulée Trace_Results_Aggregated_Lines, qui est stockée dans la géodatabase par défaut du projet. Cette classe d’entités est créée automatiquement si elle n’existe pas. Il est également possible d’utiliser une classe d’entités existante pour stocker la géométrie agrégée. Si une classe d’entités autre que celle par défaut est utilisée, il doit s’agir d’une classe d’entités polylignes contenant un champ de chaîne nommé TRACENAME. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée.	Feature Class
out_network_layer (Facultatif)	Nom du groupe de couches en sortie qui contient les couches d’entités avec les ensembles de sélection d’entités renvoyés par le traçage. Cette couche permet d’accéder à la sortie d’un traçage et de l’utiliser dans ModelBuilder et Python. Ce paramètre ne s’applique qu’au type de résultat Couches de réseau.	Group Layer
use_trace_config (Facultatif)	Indique si une configuration de tracé nommée existante doit être utilisée pour renseigner les paramètres de l’outil Traçage. USE_TRACE_CONFIGURATION—Une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Tous les paramètres, excepté trace_config_name, starting_points et barriers sont ignorés. DO_NOT_USE_TRACE_CONFIGURATION—Aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés du traçage. Il s’agit de l’option par défaut. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure.	Boolean
trace_config_name (Facultatif)	Nom de la configuration de tracé à utiliser pour définir les propriétés du traçage. Ce paramètre n’est activé que lorsque le paramètre use_trace_config a pour valeur USE_TRACE_CONFIGURATION. Remarque : Ce paramètre nécessite un réseau de traces en version 2 ou version ultérieure.	String
out_json_file (Facultatif)	Nom et emplacement du fichier .json qui est généré.	File

Sortie obtenue

Nom	Explication	Type de données
updated_trace_network	Réseau de traces actualisé.	Any Value

Exemple de code

Exemple d’utilisation de l’outil Traçage (fenêtre Python)

Exécutez un traçage en aval sur un réseau de traces nommé HydroNetwork pour renvoyer les entités situées à moins de 500 mètres du point de départ. Le résultat est un groupe de couches avec une sélection utilisant le type de résultat Couches de réseau.

import arcpy

tn = r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork"
trace = arcpy.tn.Trace(
    tn, "DOWNSTREAM", r"C:\Projects\Default.gdb\TN_Temp_Starting_Points", 
    r"C:\Projects\Default.gdb\TN_Temp_Barriers", "NO_DIRECTION", "", 
    "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
    "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "IGNORE_INDETERMINATE_FLOW", 
    None, "ADD 'Shape length' IS_EQUAL_TO 500 true", "BOTH_JUNCTIONS_AND_EDGES", 
    None, None, "NETWORK_LAYERS", "NEW_SELECTION", 
    "CLEAR_ALL_PREVIOUS_TRACE_RESULTS", "", "", "", "MyTraceResult"
)

Environnements

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

Informations de licence

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