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.
- Le 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.
- Cet outil doit être exécuté lorsque vous êtes connecté à la version par défaut.
Syntaxe
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})
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 au sein des réseaux de domaine avec une définition de niveau partitionnée. Pour les niveaux au sein d’un réseau de domaine avec une définition de réseau hiérarchique, cette propriété de niveau est toujours définie sur True pour assurer la prise en charge des sous-réseaux disjoints.
| Boolean |
valid_devices [valid_devices,...] | 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,...] | 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) | Indique les attributs de réseau à propager ainsi que le mode de propagation de ces attributs pendant un parcours. 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 le processus de mise à jour du sous-réseau met à jour l’attribut de nom du sous-réseau pris en charge pour les structures.
Remarque :Ce paramètre nécessite une version du réseau de distribution de 4 ou supérieure. | Boolean |
update_container_features (Facultatif) | Spécifie si le processus de mise à jour du sous-réseau met à jour le nom du sous-réseau pris en charge pour les conteneurs.
Remarque :Ce paramètre nécessite une version du réseau de distribution de 4 ou supé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.
Remarque :Ce paramètre nécessite une version du réseau de distribution de 4 ou supérieure et s’applique uniquement aux géodatabases d’entreprise. | 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 une version du réseau de distribution de 4 ou supérieure et s’applique uniquement 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 une version du réseau de distribution de 4 ou supé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 une version du réseau de distribution de 4 ou supé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 une version du réseau de distribution de 4 ou supé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 une version du réseau de distribution de 4 ou supérieure. | String |
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 ?