Ajouter des emplacements de trace (Outils Réseau de distribution)
Résumé
Cet outil crée une classe d’entités à utiliser comme points de départ, points d’arrêt 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 points de départ, points d’arrêt et interruptions requis en entrée pour l’outil Traçage. Vous pouvez ainsi spécifier des localisations de traçage différentes pour les opérations de traçage ModelBuilder ou Python.
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 (Localisations de traçage), car ces paramètres s’excluent mutuellement.
Réseau de distribution en entrée dans lequel les emplacements de trace sont ajoutés.
Important :
Lorsque le réseau de distribution indiqué pour le paramètre Input Utility Network (Réseau de distribution en entrée) contient un réseau de domaine de télécommunications, les localisations de traçage en sortie incluent trois champs supplémentaires : FIRSTUNIT, LASTUNIT et COLORSCHEME. Ces champs doivent être modifiés manuellement dans la classe d’entités en sortie afin de spécifier les identifiants d’unité dans les objets groupés auxquels la localisation de traçage s’applique.
Utility Network; Utility Network Layer
Classe d’entités en sortie
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. Vous pouvez indiquer le nom d’une classe d’entités existante et choisir d’ajouter des localisations de traçage à celles qui existent dans la classe d’entités ou remplacer les localisations à l’aide du paramètre Clear Trace Locations (Effacer les localisations de traçage).
Remarque :
Lors de l’utilisation du réseau de distribution en version 7 ou ultérieure, la classe d’entités en sortie peut être créée dans une géodatabase mobile, fichier ou d’entreprise.
Feature Class
Charger les entités sélectionnées
(Facultatif)
Spécifie si les entités sélectionnées dans la carte active seront chargées en tant qu’emplacements de trace.
Activé—Les emplacements de trace sont chargés en fonction de la sélection effectuée sur la carte.
Décoché—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 localisations de traçage peuvent être chargées à l’aide du paramètre Trace Locations (Localisations de traçage).
Boolean
Effacer les emplacements de trace
(Facultatif)
Indique si les emplacements de trace existants seront effacés dans la classe d’entités en sortie.
Activé—Les emplacements de trace sont effacés.
Décoché—Les localisations de traçage existantes ne sont pas effacées ; elles sont conservées et ajoutées. Il s’agit de l’option par défaut.
Boolean
Emplacements de trace
(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 (Charger les entités sélectionnées) dans une carte active, vous pouvez spécifier les entités de réseau de distribution à ajouter en tant que localisations de traçage à l’aide de ce paramètre, en fournissant les valeurs requises dans la table des valeurs.
Colonnes de la table de valeurs :
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
Filter Barrier (Filtre d’interruption)
Indique si les localisations de traçage se comportent comme des filtres d’interruption lorsqu’elles sont utilisées en tant qu’interruptions.
Activé—Les interruptions se comportent comme des filtres d’interruption. Elles présentent un intérêt pour les traçages basés sur un sous-réseau dans lesquels l’interruption autorise le sous-réseau à être évalué en premier, puis s’applique lors de la deuxième traversée des entités de réseau.
Décoché—Les interruptions se comportent comme des interruptions de traversabilité qui définissent l’étendue des sous-réseaux et sont évaluées au premier passage. Il s’agit de l’option par défaut.
Réseau de distribution en entrée dans lequel les emplacements de trace sont ajoutés.
Important :
Lorsque le réseau de distribution indiqué pour le paramètre in_utility_network contient un réseau de domaine de télécommunications, les localisations de traçage en sortie incluent trois champs supplémentaires : FIRSTUNIT, LASTUNIT et COLORSCHEME. Ces champs doivent être modifiés manuellement dans la classe d’entités en sortie afin de spécifier les identifiants d’unité dans les objets groupés auxquels la localisation de traçage s’applique.
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. Vous pouvez indiquer le nom d’une classe d’entités existante et choisir d’ajouter des localisations de traçage à celles qui existent dans la classe d’entités ou remplacer les localisations à l’aide du paramètre clear_trace_locations.
Remarque :
Lors de l’utilisation du réseau de distribution en version 7 ou ultérieure, la classe d’entités en sortie peut être créée dans une géodatabase mobile, fichier ou d’entreprise.
Feature Class
load_selected_features
(Facultatif)
Spécifie si les entités sélectionnées dans la carte active seront 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 localisations de traçage peuvent être chargées à l’aide du paramètre trace_locations.
Boolean
clear_trace_locations
(Facultatif)
Indique si les emplacements de trace existants seront effacés dans la classe d’entités en sortie.
CLEAR_LOCATIONS—Les emplacements de trace sont effacés.
KEEP_LOCATIONS—Les localisations de traçage existantes ne sont pas effacées ; elles sont conservées et ajoutées. 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 que localisations de traçage à l’aide de ce paramètre, en fournissant les valeurs requises dans la table des valeurs.
Colonnes de la table de valeurs :
Layer Name—The layer that contains the locations to add.
Global ID—The Global ID of the feature for the location to add.
Terminal—The terminal ID of the feature for the location to add.
Percent Along—The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
filter_barrier
Indique si les localisations de traçage se comportent comme des filtres d’interruption lorsqu’elles sont utilisées en tant qu’interruptions.
FILTER_BARRIER—Les interruptions se comportent comme des filtres d’interruption. Elles présentent un intérêt pour les traçages basés sur un sous-réseau dans lesquels l’interruption autorise le sous-réseau à être évalué en premier, puis s’applique lors de la deuxième traversée des entités de réseau.
TRAVERSABILITY_BARRIER—Les interruptions se comportent comme des interruptions de traversabilité qui définissent l’étendue des sous-réseaux et sont évaluées au premier passage. Il s’agit de l’option par défaut.
Boolean
Exemple de code
Exemple 1 d’utilisation de la fonction 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.un.AddTraceLocations("Naperville Electric UN",
r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
"LOAD_SELECTED_FEATURES")
Exemple 2 d’utilisation de la fonction 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.un.AddTraceLocations(r"http://landbase.mydomain.com/server/rest/services/NapervilleElectric/FeatureServer/9",
r"C:\Project\MyUNProject.gdb\TraceLocations",
"DO_NOT_LOAD_SELECTED_FEATURES",
"KEEP_LOCATIONS",
"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' #;'ElecDist Line' {67C0534B-A80D-4E5F-8926-5FB5F887A5F2} # 0.25",
"TRAVERSABILITY_BARRIER")