Calculer les clés de cluster (Utility Network)

Synthèse

Renseigne le champ attributaire CLUSTERKEY sur toutes les classes du réseau de distribution à l’aide d’une valeur entière pour faciliter le regroupement d’entités et d’objets dans la topologie du réseau.

Les clés de cluster permettent d’effectuer les opérations d’analyse plus efficacement dans le réseau de distribution lors de l’utilisation d’objets jonction et tronçon non spatiaux. Les clés de cluster sont utilisées par la topologie de réseau lors de l’activation et peuvent être utiles lors d’opérations qui interrogent la topologie de réseau, par exemple le traçage.

Utilisation

• La topologie du réseau doit être désactivée. Activez la topologie de réseau pour mettre à jour et utiliser les valeurs de clé de cluster dans la topologie de réseau.

• La structure du réseau de distribution doit contenir l’attribut CLUSTERKEY sur toutes les classes. Utilisez l’outil Activer les clés de cluster pour ajouter le champ attributaire aux classes dans les versions de réseau de distribution 4 à 7.

• Licence :

  Une licence doit être affectée au compte de portail actif avec l’extension de type d’utilisateur ArcGIS Advanced Editing pour que cet outil puisse être utilisé dans un déploiement d’entreprise.

  En savoir plus sur l’utilisation des clés de cluster

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Réseau de distribution en entrée	Réseau de distribution dans lequel les clés de cluster seront ajoutées.	Utility Network; Utility Network Layer
Remplacer (Facultatif)	Indique si les valeurs de clé de cluster existantes seront remplacées par de nouvelles valeurs. Option activée : les valeurs de clé de cluster existantes seront remplacées pour toutes les classes dans l’étendue spécifiée. Option désactivée : les valeurs de clé de cluster existantes ne seront pas remplacées pour les classes dans l’étendue spécifiée. Il s’agit de l’option par défaut.	Boolean
Étendue (Facultatif)	Étendue géographique à utiliser pour générer les clés de cluster. Lorsqu’aucune étendue n’est fournie, l’outil utilise l’étendue complète du réseau de distribution. Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités. Entités sélectionnées  : étendue de toutes les entités sélectionnées. Entités visibles  : étendue de toutes les entités visibles. Parcourir  : l’étendue repose sur un jeu de données. Intersection des entrées  : l’étendue est l’étendue d’intersection de toutes les entrées. Union des entrées  : l’étendue est l’étendue combinée de toutes les entrées. Presse-papiers  : l’étendue peut être copiée depuis et vers le Presse-papiers. Copier l’étendue  : copie l’étendue et le système de coordonnées dans le Presse-papiers. Coller l’étendue  : colle l’étendue et le système de coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie.	Extent

Sortie obtenue

Étiquette	Explication	Type de données
Réseau de distribution en sortie	Réseau de distribution mis à jour.	Utility Network

Python

arcpy.un.CalculateClusterKeys(in_utility_network, {in_overwrite_values}, {in_extent})

Nom	Explication	Type de données
in_utility_network	Réseau de distribution dans lequel les clés de cluster seront ajoutées.	Utility Network; Utility Network Layer
in_overwrite_values (Facultatif)	Indique si les valeurs de clé de cluster existantes seront remplacées par de nouvelles valeurs pour l’étendue spécifiée. OVERWRITE_VALUES—Les valeurs de clé de cluster existantes seront remplacées pour toutes les classes dans l’étendue spécifiée. DO_NOT_OVERWRITE_VALUES—Les valeurs de clé de cluster existantes ne seront pas remplacées pour les classes dans l’étendue spécifiée. Il s’agit de l’option par défaut.	Boolean
in_extent (Facultatif)	Étendue géographique à utiliser pour générer des clés de cluster. Lorsqu’aucune étendue n’est fournie, l’outil utilise l’étendue complète du réseau de distribution. MAXOF : l’étendue maximale de toutes les entrées est utilisée. MINOF : l’étendue minimale commune à toutes les entrées est utilisée. DISPLAY : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. Objet Extent : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent

Sortie obtenue

Nom	Explication	Type de données
out_utility_network	Réseau de distribution mis à jour.	Utility Network

Exemple de code

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

Calculez les clés de cluster pour la totalité de l’étendue d’un réseau de distribution nommé Mon réseau de distribution.

import arcpy 
arcpy.un.CalculateClusterKeys('My Utility Network', 'DO_NOT_OVERWRITE_VALUES',
                              '-10210419.36935838 2192709.92528272 -1010791.46945935 2462417.33676915')

Environnements

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

Informations de licence

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