Tracer (Réseau de traces)

Résumé

Renvoie les entités sélectionnées d’un réseau de traces selon la connectivité ou la capacité à être traversé à partir des points de départ spécifiés.

Les fonctions de traçage du réseau de traces vous permettent d’analyser les chemins sur votre réseau. La capacité à être traversé se réfère aux 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ébut ou une interruption est placé sur une jonction avec une connectivité à mi-portée, les résultats du traçage renverront des éléments partiels de l’entité tronçon. Lorsqu’une interruption est placée le long d’un segment, les résultats du traçage peuvent être arrêtés à la jonction la plus proche avec la connectivité à mi-portée. Le jeu sélectionné ou la classe d’entités en sortie obtenu par traçage peut ensuite se propager vers une autre carte, une fenêtre 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 d’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.

• Puisque l’outil Trace (Traçage) repose sur la topologie du réseau, la précision des résultats de la trace 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.

• Lors de l’utilisation d’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.

Syntaxe

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})

Paramètre	Explication	Type de données
in_trace_network	Réseau de traces pour lequel le traçage sera effectué. Lorsque vous utilisez une géodatabase d’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 trace à exécuter. CONNECTED —Une trace connectée qui commence à un ou plusieurs points de début et s’étend le long des entités connectées est utilisé. UPSTREAM —Une trace en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini. DOWNSTREAM —Une trace en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé. Ce type de trace nécessite que le sens de circulation soit défini. SHORTEST_PATH —Une trace qui recherche le chemin le plus court entre deux points de début sur le réseau, quel que soit le sens de circulation, est utilisé. Le coût du parcours 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 à l’aide de l’outil Points de départ dans la fenêtre Trace Locations (Emplacements de trace), ou classe d’entités ponctuelles contenant une ou plusieurs entités 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 est générée dans la géodatabase par défaut du projet lors de la création des points de début à l’aide de l’outil Starting Points (Points de début) dans la fenêtre Trace Locations (Emplacement des traces).	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 la trace d’aller au-delà de ce point. La classe d’entités TN_Temp_Barriers est utilisée par défaut et est générée dans la géodatabase par défaut du projet lors de la création des interruptions à l’aide de l’outil Barriers (Interruptions) dans la fenêtre Trace Locations (Emplacement des traces).	Feature Layer; Table View
path_direction (Facultatif)	Indique la direction du chemin de la trace. Le coût du parcours 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ébut, quel que soit le sens de circulation, est utilisé. Il s’agit de l’option par défaut. PATH_UPSTREAM —Le chemin en amont entre les deux points de début est utilisé. PATH_DOWNSTREAM —Le chemin en aval entre les deux points de début 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’une trace de type Chemin le plus court.	String
include_barriers (Facultatif)	Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la trace. 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 retournée lorsqu’une zone à valider figure dans les entités traversé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 parcours retourne une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut. DO_NOT_VALIDATE_CONSISTENCY —Le parcours retourne des résultats qu’une zone à valider figure ou non dans les entités traversées.	Boolean
ignore_barriers_at_starting_points (Facultatif)	Spécifie si les interruptions dans la configuration de trace sont ignorées pour les points de début. 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 non initialisé ou indéterminé sont tracées. IGNORE_INDETERMINATE_FLOW —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
condition_barriers [Name, Operator, Type, Value, Combine Using,...] (Facultatif)	Définit une interruption conditionnelle de 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 une trace 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 Or (Ou). Les composants d’interruptions conditionnelles sont les suivants : Name : filtrez par n’importe quel attribut de réseau défini dans le système. Operator : Choisissez un nombre de différents opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau depuis 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 avez plusieurs attributs à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou d’une condition Ou. Les composants du type 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 du type 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 du type Combine Using sont les suivants : AND —Combinez les interruptions conditionnelles. OR —Utilisez le paramètre Or (Ou) 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 fonctionnelles peuvent être utilisées, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de début, ou 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 une des fonctions de calcul. Attribute : filtrez par un attribut de réseau défini dans le système. Operator : choisissez un des opérateurs. Value—Fournit une valeur spécifique du type d'attribut en entrée qui, si découverte, entraîne l'arrêt. Use Local Values : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Shape length (Longueur de forme) à laquelle la trace 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 du type 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 du type 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 —L’attribut est inférieur à la valeur. Les composants du type 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é à appliquer. La portée de la capacité à être traversé 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 capacité à être traversé 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. En d’autres termes, ce paramètre indique à la trace d’ignorer ou non les jonctions, les tronçons, ou d’inclure à la fois les jonctions et les tronçons. BOTH_JUNCTIONS_AND_EDGES —La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. JUNCTIONS_ONLY —La capacité à être traversé s’applique uniquement aux jonctions. EDGES_ONLY —La capacité à être traversé s’applique uniquement aux tronçons.	String
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Facultatif)	Applique une fonction de calcul aux résultats de la trace. Les composants des fonction sont les suivants : Function : choisissez une des fonctions de calcul. Attribute : filtrez par 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 un des opérateurs. Filter Type : choisissez un nombre de types de filtre. Filter Value—Fournit une valeur spécifique de l’attribut de filtrage en entrée. Les options du composant 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. Par exemple, vous avez une entité de points de début avec une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MIN, le résultat est 20. MAX est égal à 30, ADD est 50, AVERAGE est égal à 25, COUNT est 2, et SUBTRACT est -10. Les options du composant 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 —L’attribut est inférieur à la valeur. Les options du composant 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 une trace configurée 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 Et ou Ou. Les composants des Conditions de sortie sont les suivants : Name : filtrez par n’importe quel attribut de réseau défini dans le système. Operator : choisissez un des opérateurs. Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur = spécifiée dans le composant Name. Value—Fournit une 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 avez plusieurs attributs à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou d’une condition Ou. Les options du composant 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 —L’attribut est inférieur à la valeur. Les options du composant 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 du composant Combine Using sont les suivantes : AND —Combinez les conditions. OR —Utilisez le paramètre Or (Ou) si l’une des conditions est satisfaite.	Value Table
result_types [result_types,...] (Facultatif)	Spécifie le type de résultat renvoyé par la trace. SELECTION — Les résultats de la trace 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 — Les résultats de la trace sont agrégés par type de géométrie et stockés dans les classes d’entités affichées sur les couches de la carte active. NETWORK_LAYERS —Les résultats de la trace sont ajoutés aux couches d’entités en tant que jeu de sélection au sein d’une couche de groupe.	String
selection_type	Spécifie la manière dont la sélection doit être exécutée et ce qu’il faut faire 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. 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 permutée. Les résultats qui étaient sélectionnés sont supprimés de la sélection courante, tandis que les résultats qui n’étaient pas sélectionnés sont ajoutés à la sélection courante. 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 pour stocker la géométrie agrégée ou ajouté à celles-ci. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée. CLEAR_ALL_PREVIOUS_TRACE_RESULTS — Les classes d’entités dans lesquelles est stockée la géométrie agrégée de la trace seront 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 ne s’applique qu’au type de résultat de la 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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités multi-points qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la 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 complété avec une classe d’entités généré 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 automatiquement créée 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 vous utilisez une classe d’entités autre que la classe d’entités par défaut, il doit s’agir d’une classe d’entités polylignes qui contient un champ de chaîne nommé TRACENAME. Ce paramètre ne s’applique qu’au type de résultat de la géométrie agrégée.	Feature Class
out_network_layer (Facultatif)	Nom de la couche de groupe en sortie qui contient les couches d’entités avec les jeux de sélection retournés par la trace. Cette couche permet d’accéder à la sortie d’une trace dans ModelBuilder et Python. Ce paramètre ne s’applique qu’au type de résultat des couches de réseau.	Group Layer
use_trace_config (Facultatif)	Indique si une configuration de trace existante doit être utilisée pour renseigner les paramètres de l’outil Trace. USE_TRACE_CONFIGURATION —La trace utilise une configuration de trace existante pour définir ses propriétés. Tous les paramètres, sauf trace_config_name, starting_points et barriers, sont ignorés. DO_NOT_USE_TRACE_CONFIGURATION —La trace n’utilise pas de configuration de trace existante pour définir ses propriétés. Il s’agit de l’option par défaut. Remarque : Ce paramètre nécessite un réseau de traces version 2 ou ultérieure.	Boolean
trace_config_name (Facultatif)	Spécifie le nom de la configuration de trace à utiliser pour définir les propriétés de la trace. Ce paramètre n’est activé que lorsque le paramètre use_trace_config est défini sur USE_TRACE_CONFIGURATION. Remarque : Ce paramètre nécessite un réseau de traces version 2 ou ultérieure.	String

Sortie dérivée

Nom	Explication	Type de données
updated_trace_network	Réseau de traces actualisé.	Toute valeur

Exemple de code

Exemple d’utilisation de l’outil Trace (fenêtre Python)

Exécutez une trace en aval sur un réseau de traces nommé HydroNetwork à l’aide de la fonction Trace.

import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork", 
               "DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")

Environnements

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

Informations de licence

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