Ajouter des emplacements de trace (Utility Network)

Résumé

Cet outil crée une classe d’entités à utiliser comme points de début et interruptions en entrée de l’outil Traçage.

Utilisation

• La classe d’entités en sortie possède la même structure que les interruptions et les points de début requis en entrée pour l’outil Traçage. Vous pouvez ainsi spécifier des emplacements de trace différents pour les opérations de traçage dans ModelBuilder ou dans un environnement de scripts.

• Il est impossible de définir simultanément des valeurs pour les paramètres Load Selected Features (Charger les entités sélectionnées) et Trace Locations (Emplacements de trace), car ces paramètres s'excluent mutuellement.

Syntaxe

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)

Paramètre	Explication	Type de données
in_utility_network	Réseau de distribution en entrée dans lequel les emplacements de trace sont ajoutés.	Utility Network; Utility Network Layer
out_feature_class	Classe d'entités en sortie contenant les emplacements de trace. Si vous indiquez un nouveau nom de classe d’entités, une nouvelle classe d’entités en sortie est créée. Pour utiliser une classe d’entités précédemment créée par cet outil pour y ajouter des emplacements ou remplacer les emplacements existants, indiquez le nom de la classe d’entités existante.	Feature Class
load_selected_features (Facultatif)	Spécifie si les entités sélectionnées dans la carte active sont chargées en tant qu’emplacements de trace. LOAD_SELECTED_FEATURES —Les emplacements de trace sont chargés en fonction de la sélection effectuée sur la carte. DO_NOT_LOAD_SELECTED_FEATURES —Les emplacements de trace ne seront pas chargés en fonction de la sélection effectuée sur la carte. Il s’agit de l’option par défaut. Toutefois, les emplacements de trace peuvent être chargés à l’aide du paramètre trace_locations.	Boolean
clear_trace_locations (Facultatif)	Indique si les emplacements de trace sont effacés dans la classe d’entités en sortie. CLEAR_LOCATIONS —Les emplacements de trace sont effacés. KEEP_LOCATIONS —Les emplacements de trace ne sont pas effacés, mais sont conservés. Il s’agit de l’option par défaut.	Boolean
trace_locations [[Layer Name, Global ID, Terminal ID, Percent Along],...] (Facultatif)	Emplacements de trace qui seront ajoutés à la classe d'entités en sortie. Si vous n’utilisez pas le paramètre load_selected_features dans une carte active, vous pouvez spécifier les entités de réseau de distribution à ajouter en tant qu'emplacements de trace à l’aide de ce paramètre, en fournissant les valeurs requises dans la table des valeurs. Les propriétés des emplacements de trace sont les suivantes : Layer Name : couche ou classe d'entité faisant partie du réseau de distribution et qui contient un point de début ou une interruption à ajouter. Si une carte est active, seules les couches provenant de la carte sont autorisées. Si tel n’est pas le cas, le nom de la classe d'entités est utilisé. Global ID : identifiant global de l'entité correspondant à l'emplacement à ajouter. Terminal ID : identifiant de borne de l'entité correspondant à l'emplacement à ajouter. Percent Along : valeur du pourcentage tout au long de l'entité. Pour les entités linéaires, la valeur par défaut est 0,5.	Value Table
filter_barrier	Indique le comportement des interruptions des localisations de trace. Pour en savoir plus sur les interruptions FILTER_BARRIER —L’interruption se comporte comme un filtre d’interruption. Cela s’avère utile pour les traces basées sur un sous-réseau dans lesquelles l’interruption autorise le sous-réseau à être évalué en premier, puis s’applique sur un second cheminement des entités de réseau, agissant principalement comme un filtre d’interruption. TRAVERSABILITY_BARRIER —L’interruption se comporte comme une interruption de la capacité à être traversé. Les interruptions de la capacité à être traversé définissent l’étendue des sous-réseaux et sont évaluées au premier passage. Il s’agit de l’option par défaut. Remarque : Ce paramètre requiert ArcGIS Enterprise 10.8.1 ou version ultérieure.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil AddTraceLocations (fenêtre Python)

Ajoutez des emplacements de trace dans une nouvelle classe d'entités en sortie nommée TraceLocations en chargeant les entités sélectionnées dans la carte active.

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")

Exemple 2 d'utilisation de l'outil AddTraceLocations (script autonome)

Ajoutez des emplacements de trace dans une classe d'entités existante nommée TraceLocations sans carte active.

import arcpy
# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"
# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )

Environnements

Espace de travail courant, Valeurs Z en sortie

Informations de licence

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