Résumé
Définit les propriétés d’un tier de classes de réseau pour un sous-réseau dans un réseau de distribution.
Les types d’entités participant à un tier peuvent être limités en définissant les types de ressources valides à partir du périphérique, de la ligne, de la jonction, de l’objet de tronçon et des classes d’objets jonction. La définition des types de ressources valides contribue à l’application de l’exactitude des données en limitant les types d’entités pouvant participer à un sous-réseau pour un niveau spécifique.
Les paramètres de configuration permettent de définir des propriétés lors de l’exécution d’un traçage sur le sous-réseau.
En savoir plus sur la définition d’un sous-réseau
En savoir plus sur la gestion d’un sous-réseau
En savoir plus sur la recherche de parcours du réseau de distribution
Utilisation
Cet outil permet de définir et de modifier la définition du sous-réseau du tier. Pour corriger les valeurs de la définition du sous-réseau du tier, modifiez les valeurs de paramètre et exécutez une nouvelle fois l’outil.
La topologie du réseau doit être désactivée.
- Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :
- Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique.
- La valeur du paramètre Input Utility Network (Réseau de distribution en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau de distribution de la base de données.
- Lors de son exécution, cet outil doit être connecté à la version par défaut.
Syntaxe
arcpy.un.SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, {valid_devices}, {valid_subnetwork_controller}, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects}, {manage_subnetwork_isdirty}, {include_containers}, {include_content}, {include_structures}, {validate_locatability})
Paramètre | Explication | Type de données |
in_utility_network | Réseau de distribution en entrée contenant le sous-réseau du tier. | Utility Network; Utility Network Layer |
domain_network | Classes de réseau contenant le tier. | String |
tier_name | Nom du niveau qui contient le sous-réseau. | String |
support_disjoint_subnetwork | Détermine si le tier en entrée prend en charge les sous-réseaux disjoints. Les sous-réseaux disjoints sont plusieurs sous-réseaux appartenant au même tier et possèdent le même nom de sous-réseau, mais ne sont pas traversables. Cette option est disponible uniquement pour les niveaux des réseaux de domaine avec une définition de niveau partitionné. Les tiers dans des classes de réseau avec une définition de tier hiérarchique ont toujours cette propriété de tier définie sur SUPPORT_DISJOINT pour prendre en charge les sous-réseaux disjoints.
| Boolean |
valid_devices [valid_devices,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des périphériques valides pour le sous-réseau. | String |
valid_subnetwork_controller [valid_subnetwork_controller,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des contrôleurs de sous-réseaux de périphériques valides dans le sous-réseau. | String |
valid_lines [valid_lines,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des lignes valides pour le sous-réseau. | String |
aggregated_line [aggregated_line,...] (Facultatif) | Lignes valides dont la géométrie sera agrégée pour générer les entités SubnetLine. Cette liste est un sous-ensemble des valeurs spécifiées dans le paramètre valid_lines (Lignes valides). | String |
diagram_template [diagram_template,...] (Facultatif) | Les modèles servent à générer des diagrammes système de sous-réseaux pour chaque sous-réseau. | String |
summaries [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...] (Facultatif) | Ce paramètre définit le champ de synthèse pour stocker les résultats de fonction lors de l’insertion ou de la mise à jour des entités SubnetLine. Les composants de synthèse sont les suivants :
Les options de la valeur Function de synthèse sont les suivantes :
Les options de la valeur Filter Operator de synthèse sont les suivantes :
Les options de la valeur Filter Type de synthèse sont les suivantes :
| Value Table |
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 valeurs d’interruptions conditionnelles operator sont les suivantes :
En savoir plus sur les opérateurs bit à bit Les options des valeurs Type d’interruptions conditionnelles sont les suivantes :
Les valeurs Combine Using 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 de la valeur Use Local Values d’interruptions de fonctions sont les suivantes :
| Value Table |
include_barriers (Facultatif) | Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau.
| Boolean |
traversability_scope (Facultatif) | 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 traçage 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 traçage ne s’interrompt pas même s’il détecte un périphérique 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 |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...] (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 |
update_structure_features (Facultatif) | Spécifie si la mise à jour du sous-réseau met à jour l’attribut de nom de sous-réseau pris en charge pour les conteneurs de réseau physique.
Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | Boolean |
update_container_features (Facultatif) | Spécifie si la mise à jour du sous-réseau met à jour le nom de sous-réseau pris en charge pour les conteneurs de réseau de domaine.
Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | Boolean |
edit_mode_for_default_version (Facultatif) | Définit le mode de mise à jour pour les mises à jour de sous-réseau sur la version par défaut et avec les géodatabases fichier.
Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | String |
edit_mode_for_named_version (Facultatif) | Définit le mode de mise à jour pour les mises à jour de sous-réseau sur une version nommée.
Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure et ne s’applique qu’aux géodatabases d’entreprise. | String |
valid_junctions [valid_junctions,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des jonctions valides pour le sous-réseau. Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | String |
valid_junction_objects [valid_junction_objects,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des objets de jonction valides pour le sous-réseau. Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | String |
valid_junction_object_subnetwork_controller [valid_junction_object_subnetwork_controller,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des contrôleurs de sous-réseaux d’objets de jonction valides pour le sous-réseau. Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | String |
valid_edge_objects [valid_edge_objects,...] (Facultatif) | Paires de groupe/types d’actifs considérés comme des objets de tronçon valides pour le sous-réseau. Remarque :Ce paramètre nécessite un réseau de distribution version 4 ou ultérieure. | String |
manage_subnetwork_isdirty (Facultatif) | Indique si l’attribut Is dirty dans la table de sous-réseaux est géré par l’opération de mise à jour du sous-réseau. Si aucun contrôleur de sous-réseau n’est défini pour le tier, ce paramètre utilise l’option par défaut NOT_MANAGE.
Remarque :Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure. | Boolean |
include_containers (Facultatif) | Indique si les objets et les entités de conteneur sont inclus dans les résultats de traçage.
Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure. | Boolean |
include_content (Facultatif) | Indique si le traçage renvoie le contenu des conteneurs dans les résultats.
Ce paramètre nécessite un réseau de distribution version 5 ou ultérieure. | Boolean |
include_structures (Facultatif) | Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.
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’un traçage ou d’une opération de mise à jour du sous-réseau 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. Cette option garantit que les objets non spatiaux renvoyés par un traçage 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 5 ou ultérieure. | Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_utility_network | Réseau technique en entrée actualisé. | Utility Network |
Exemple de code
Cet exemple établit la définition du sous-réseau dans un domaine nommé ElectricDistribution.
'''****************************************************************************
Name: SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by: Esri
****************************************************************************'''
# Import required modules
import arcpy
# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""
# Run the SetSubnetworkDefinition tool
arcpy.SetSubnetworkDefinition_un(in_utility_network,
domain_network,
tier_name,
support_disjoint_subnetwork,
valid_devices,
valid_subnetwork_controller,
valid_lines,
aggregated_line,
diagram_template,
summaries,
condition_barriers,
function_barriers,
include_barriers,
traversability_scope,
propagators)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?