Résumé
Indique en retour les entités sélectionnées selon la connectivité ou la traversabilité depuis les points de départ spécifiés.
Les capacités de traçage du réseau de distribution vous permettent d'analyser les chemins dans votre réseau. Cet outil exécute un traçage qui renvoie les entités selon la connectivité ou la traversabilité depuis les points de début spécifiés. La traversabilité se réfère aux chemins établis par les entités connectées ou associé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. L’option du paramètre Result Types (Types de résultat) Aggregated Geometry (Géométrie agrégée) peut être spécifiée pour retourner des résultats d’entité partiels.
Avec l’option Aggregated Geometry (Géométrie agrégée), les points de départ placés le long d’un tronçon retournent l’élément de tronçon de la jonction précédente avec une extrémité ou une connectivité à mi-portée. Lorsqu’une interruption est placée le long d’un tronçon avec le paramètre Include Barrier Features (Inclure les entités d’interruption) coché, le traçage s’arrête à la jonction suivante rencontrée avec une connectivité à mi-portée ou la ligne se termine. Si le paramètre Include Barrier Features (Inclure les entités d’interruption) est décoché, le traçage s’arrête à la jonction précédente rencontrée avec une connectivité à mi-portée ou la ligne précédente se termine.
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 la recherche de parcours du réseau de distribution
Utilisation
La topologie du réseau doit être activée. Puisque l’outil Trace (Traçage) repose sur la topologie du réseau, la précision des résultats d’un traçage n'est pas garantie si des zones à valider sont tracées. 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.
Si une géodatabase d’entreprise est utilisée, le réseau technique en entrée doit correspondre à un service du réseau technique.
Lors de l’exécution d'un traçage basé sur un sous-réseau à l’aide de l'outil Traçage via Python, la Subnetwork Trace Configuration (Configuration de traçage du sous-réseau) de la définition de sous-réseau n’est pas utilisée pour le Tier en entrée et doit être spécifiée.
Lors de l’utilisation d’attributs de réseau affectés à un champ de date pour les interruptions de filtre, les interruptions de fonctions de filtre, 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.un.Trace(in_utility_network, trace_type, {starting_points}, {barriers}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {aggregated_polygons}, {allow_indeterminate_flow}, {validate_locatability}, {use_trace_config}, {trace_config_name})| Paramètre | Explication | Type de données |
in_utility_network | Réseau technique pour lequel le traçage sera effectué. Lorsque vous utilisez une géodatabase d’entreprise, le réseau technique doit provenir d’un service d’entités ; les réseaux techniques issus d’une connexion à une base de données ne sont pas pris en charge. | Utility Network; Utility Network Layer |
trace_type | Spécifie le type de traçage à exécuter.
| String |
starting_points (Facultatif) | Table ou classe d’entités ponctuelles contenant un ou plusieurs enregistrements qui représentent les points de départ du traçage. Cette classe ou table d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. Pour afficher le format spécifique, créez les points de départ à l’aide de l’outil Starting Points (Points de départ) dans la fenêtre Trace Locations (Emplacements de trace) et affichez le schéma de la classe d’entités UN_Temp_Starting_Points stockée dans votre géodatabase par défaut. | 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. Cette classe ou table d’entités doit inclure le champ FEATUREGLOBALID pour stocker les informations relatives à l’entité de réseau associée. Pour afficher le format spécifique, créez les interruptions à l’aide de l’outil Barriers (Interruptions) dans la fenêtre Trace Locations (Emplacements de trace) et affichez le schéma de la classe d’entité UN_Temp_Barriers stockée dans votre géodatabase par défaut. | Feature Layer; Table View |
domain_network (Facultatif) | Le nom du réseau du domaine sur lequel la trace sera exécutée. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval. | String |
tier (Facultatif) | Nom du niveau qui débute le traçage. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval. | String |
target_tier (Facultatif) | Le nom du niveau cible vers lequel le niveau en entrée s'écoule. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie. | String |
subnetwork_name (Facultatif) | Le nom du sous-réseau où le traçage sera exécutée. Ce paramètre peut être utilisé lors de l’exécution d’un type de traçage de sous-réseau. Si un nom de sous-réseau est indiqué, le paramètre Starting Points (Points de début) (paramètre starting_points dans Python) n’est pas requis. | String |
shortest_path_network_attribute_name (Facultatif) | Attribut de réseau utilisé pour calculer le chemin le plus court. 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_containers (Facultatif) | Indique si les entités de conteneur sont incluses dans les résultats de traçage.
| Boolean |
include_content (Facultatif) | Indique si le traçage renvoie le contenu dans les conteneurs, avec les résultats.
| Boolean |
include_structures (Facultatif) | Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.
| Boolean |
include_barriers (Facultatif) | Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.
| 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.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. 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 Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant). Les composants d’interruptions conditionnelles sont les suivants :
Les options des valeurs operator d’interruptions conditionnelles sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options des valeurs Type d’interruptions conditionnelles sont les suivantes :
Les options des valeurs Combine Using d’interruptions conditionnelles sont les suivantes :
En savoir plus sur l’utilisation de plusieurs expressions conditionnelles | 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 pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. 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 :
Les valeurs des options function d’interruptions de fonctions sont les suivantes :
Les valeurs des options operator d’interruptions de fonctions sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options d’interruption de fonctions de Use Local Values sont les suivantes :
| Value Table |
traversability_scope (Facultatif) | Le type de traversabilité à appliquer. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le parcours lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, le parcours ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux.
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Spécifie si un traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition And (Et) ou Or (Ou). Les composants du Filtre d'interruption sont les suivants :
Les options des valeurs operator des filtres par interruptions sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options des valeurs Type des filtres par interruptions sont les suivantes :
Les options des valeurs Combine Using des filtres par interruptions sont les suivantes :
En savoir plus sur l’utilisation de plusieurs expressions conditionnelles | Value Table |
filter_function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Facultatif) | Filtre les résultats du traçage pour une catégorie spécifique. Les composants du Filtre par fonctions d'interruption sont les suivants :
Les options de la valeur function du filtre des interruptions de fonction sont les suivantes :
Les options de la valeur operator du filtre des interruptions de fonction sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options d’interruption de fonctions de Use Local Values sont les suivantes :
| Value Table |
filter_scope (Facultatif) | Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux.
| String |
filter_bitset_network_attribute_name (Facultatif) | Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins. | String |
filter_nearest (Facultatif) | Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Lorsque ce paramètre est utilisé, vous pouvez préciser un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.
| Boolean |
nearest_count (Facultatif) | Nombre d’entités à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST. | Long |
nearest_cost_network_attribute (Facultatif) | Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, Shape length (Longueur de forme). | String |
nearest_categories [nearest_categories,...] (Facultatif) | Catégories à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, Protective (Protection). | String |
nearest_assets [nearest_assets,...] (Facultatif) | Groupes d’actifs et types d’actifs à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST—par exemple, ElectricDistributionDevice/Transformer/Step Down. | 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 :
Les options de la valeur Function des fonctions sont les suivantes :
Par exemple, une entité de point de départ a une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MINIMUM, le résultat est 20. MAXIMUM est égal à 30, ADD est 50, AVERAGE est égal à 25, COUNT est 2, et SUBTRACT est -10. Les options de la valeur Filter Operator sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options de la valeur Filter Type des fonctions sont les suivantes :
| Value Table |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Facultatif) | Spécifie les attributs de réseau à propager ainsi que la façon dont cette propagation devra être effectuée pendant un traçage. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase. Les composants de propagateurs sont les suivants :
Les options de la valeur function des propagateurs sont les suivantes :
Les options de la valeur operator des propagateurs sont les suivantes :
En savoir plus sur les opérateurs bit à bit Remarque :Ce paramètre est uniquement disponible via Python. | Value Table |
output_assettypes [output_assettypes,...] (Facultatif) | Filtre les types de ressources en sortie à inclure dans les résultats (par exemple, retourner uniquement les transformateurs aériens). | String |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Spécifie les types des entités renvoyées selon un attribut de réseau ou une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Dérivation, toute entité tracée à laquelle la catégorie Dérivation n’est pas attribuée, 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 Or (Ou). Les composants des Conditions de sortie sont les suivants :
Les options de la valeur operator sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options de la valeur Type des Conditions de sortie sont les suivantes :
Les options de la valeur Combine Using des Conditions de sortie sont les suivantes :
En savoir plus sur l’utilisation de plusieurs expressions conditionnelles | Value Table |
include_isolated_features (Facultatif) | Indique si les entités isolées sont incluses dans les résultats de traçage. Ce paramètre est utilisé uniquement lors de l’exécution d’un traçage d’isolement.
Remarque :Ce type de traçage d’isolement requiert ArcGIS Enterprise 10.7 ou version ultérieure si vous utilisez une géodatabase d’entreprise. | Boolean |
ignore_barriers_at_starting_points (Facultatif) | Spécifie si les interruptions dynamiques dans la configuration de traçage sont ignorées pour les points de départ. Cela peut être utile lorsque vous effectuez un parcours de dispositifs de protection en amont et que vous utilisez les dispositifs de protection (interruptions) détectés comme points de début pour rechercher les dispositifs de protection en amont suivants.
| Boolean |
include_up_to_first_spatial_container (Facultatif) | Indique de limiter ou non les conteneurs retournés pour n’inclure que ceux rencontrés jusqu’au premier conteneur spatial, et l’incluant, pour chaque élément de réseau dans les résultats de traçage. Si aucun conteneur spatial n’est rencontré mais que des conteneurs non spatiaux sont présents pour un élément de réseau donné, tous les conteneurs non spatiaux sont inclus dans les résultats. Ce paramètre n’est applicable que si Include Containers est activé.
| Boolean |
result_types [result_types,...] (Facultatif) | Spécifie le type de résultat renvoyé par la trace.
| 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à.
| String |
clear_all_previous_trace_results (Facultatif) | Indique si le contenu sera tronqué à partir des classes d’entités choisies, ou ajouté à celles-ci, pour stocker la géométrie agrégée. Ce paramètre ne s’applique qu’au type de résultat de 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 |
aggregated_polygons (Facultatif) | Classe d’entités surfaciques 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 nommée Trace_Results_Aggregated_Polygons, 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 surfaciques 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 |
allow_indeterminate_flow (Facultatif) | Indique si les entités dont le flux est indéterminé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval.
Remarque :Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure. | Boolean |
validate_locatability (Facultatif) | Indique si une erreur est renvoyée lors d’une trace si une jonction non spatiale ou des objets de tronçon sont rencontrés sans l’association de contenu, de dépendances ou de connectivité nécessaire dans leur hiérarchie d’associations des objets traversés. Ce paramètre garantit que les objets non spatiaux renvoyés par une trace ou une opération de mise à jour de sous-réseau peuvent être localisés via une association avec des entités ou d’autres objets pouvant être localisés.
Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | Boolean |
use_trace_config (Facultatif) | Indique si une configuration de trace existante doit être utilisée pour renseigner les paramètres de l’outil Trace.
Remarque :Ce paramètre nécessite un réseau de distribution version 5 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. | String |
Sortie dérivée
| Nom | Explication | Type de données |
| out_utility_network | Réseau technique actualisé. | Utility Network |
Exemple de code
Exécutez une recherche de traçage en aval sur un réseau de distribution électrique sur le tier moyenne de tension qui ajoute la charge du transformateur aux phases A, B et C.
'''****************************************************************************
Name: DownstreamTrace.py
Description: This script executes a downstream trace on the Medium Voltage tier
that adds up the transformer load on phases A, B, and C.
Created by: Esri
****************************************************************************'''
# Import required modules
import arcpy
# Set local variables
in_utility_network = "NapervilleElectric Utility Network"
trace_type = "DOWNSTREAM"
starting_points = "C:\\MyProject\\Bissell.gdb\UN_Temp_Starting_Points"
barriers = "C:\\MyProject\\Bissell.gdb\UN_Temp_Barriers"
domain_network = "ElectricDistribution"
tier = "Medium Voltage Radial"
include_containers = "INCLUDE_CONTAINERS"
include_structures = "INCLUDE_STRUCTURES"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
functions = "ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 4;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 2;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 1"
# Run Trace with specified parameters and leave the rest default
arcpy.Trace_un(in_utility_network,
trace_type,
starting_points,
barriers,
domain_network,
tier,
include_containers=include_containers,
include_structures=include_structures,
condition_barriers=condition_barriers,
functions=functions)Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?