Ajouter des emplacements de trace (Utility Network)

Synthèse

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.

Paramètres

ÉtiquetteExplicationType de données
Réseau de distribution en entrée

Réseau de distribution en entrée dans lequel les emplacements de trace sont ajoutés.

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.

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
Charger les entités sélectionnées
(Facultatif)

Spécifie si les entités sélectionnées dans la carte active sont chargées en tant qu’emplacements de trace.

  • Activé : les emplacements de trace seront chargés en fonction de la sélection effectuée sur la carte.
  • Désactivé : 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 (Emplacements de trace).

Boolean
Effacer les emplacements de trace
(Facultatif)

Indique si les emplacements de trace sont effacés dans la classe d’entités en sortie.

  • Activé : les emplacements de trace sont effacés.
  • Désactivé : les emplacements de trace ne sont pas effacés, mais sont conservés. 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 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 (Nom de la couche) : couche 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.
  • Global ID (ID global) : identifiant global de l'entité de la couche correspondant à l'emplacement à ajouter.
  • Terminal ID (ID de borne) : identifiant de borne de l'entité de la couche correspondant à l'emplacement à ajouter.
  • Percent Along (Pourcentage tout au long) : valeur du pourcentage tout au long de l'entité de la couche. Pour les entités linéaires, la valeur par défaut est 0,5.

Value Table
Filter Barrier (Filtre d’interruption)

Indique le comportement des interruptions des localisations de trace.

  • Activé : 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.
  • Désactivé : 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.9 ou version ultérieure.

Boolean

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
NomExplicationType 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_FEATURESLes emplacements de trace sont chargés en fonction de la sélection effectuée sur la carte.
  • DO_NOT_LOAD_SELECTED_FEATURESLes 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_LOCATIONSLes emplacements de trace sont effacés.
  • KEEP_LOCATIONSLes 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_BARRIERL’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_BARRIERL’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.9 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

Cas particuliers

Informations de licence

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

Rubriques connexes