Resumen
Establece las propiedades del nivel de la red de dominio para una subred de una red de servicios.
Los tipos de entidades que participan en un nivel pueden restringirse definiendo tipos de activos válidos de las clases de dispositivo, línea, cruce, objeto de eje y objeto de cruce. La definición de tipos de activos válidos ayuda a imponer la corrección de los datos al limitar los tipos de entidades que pueden participar en una subred para un nivel específico.
Se usan parámetros de configuración para establecer propiedades cuando se ejecuta un trazado en la subred.
Más información sobre la configuración de la definición de subred
Uso
Esta herramienta también le permite establecer y modificar la definición de la subred de nivel. Para modificar los valores de la definición de la subred de nivel, modifique los valores de los parámetros y ejecute de nuevo la herramienta.
La topología de red debe estar desactivada.
- Se deben cumplir los siguientes requisitos al trabajar con una geodatabase corporativa:
- La cuenta del portal de ArcGIS Enterprise conectado debe ser el propietario de la red de servicios del portal.
- El valor del parámetro Red de servicios de entrada debe provenir de una conexión de base de datos establecida como propietaria de la red de servicios de la base de datos.
- Esta herramienta debe conectarse a la versión predeterminada cuando se ejecute.
Sintaxis
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})
Parámetro | Explicación | Tipo de datos |
in_utility_network | La red de servicios de entrada que contiene la subred de nivel. | Utility Network; Utility Network Layer |
domain_network | La red de dominio que contiene el nivel. | String |
tier_name | El nombre del nivel que contiene la subred. | String |
support_disjoint_subnetwork | Especifica si el nivel de entrada admite las subredes inconexas. Como subredes inconexas se entienden dos o más subredes que pertenecen al mismo nivel y tienen el mismo nombre de subred, pero no son transitables. Esta opción solo está disponible para los niveles de redes de dominio con una definición de niveles divididos. Los niveles de una red de dominio con una definición de niveles jerárquicos siempre tendrán esta propiedad de nivel establecida en SUPPORT_DISJOINT para admitir subredes inconexas.
| Boolean |
valid_devices [valid_devices,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como dispositivos válidos para la subred. | String |
valid_subnetwork_controller [valid_subnetwork_controller,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como controladores de subred de dispositivos válidos para la subred. | String |
valid_lines [valid_lines,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como líneas válidas para la subred. | String |
aggregated_line [aggregated_line,...] (Opcional) | Las líneas válidas cuya geometría se agregará para generar las entidades SubnetLine. Esta lista es un subconjunto de los valores especificados en el parámetro valid_lines. | String |
diagram_template [diagram_template,...] (Opcional) | Las plantillas que se utilizarán para generar diagramas de sistema de subred para cada subred. | String |
summaries [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...] (Opcional) | Define el campo de resumen que debe almacenar los resultados de la función al insertar o actualizar entidades SubnetLine. Los componentes de resúmenes son los siguientes:
Las opciones de valor de los resúmenes de Function son las siguientes:
Las opciones de valor de los resúmenes de Filter Operator son las siguientes:
Las opciones de valor de los resúmenes de Filter Type son las siguientes:
| Value Table |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Opcional) | Define una condición de barrera de transitabilidad en entidades basadas en una comparación con un atributo de red o busque una cadena de categoría. Una barrera de condición utiliza un atributo de red, un operador y un tipo, y un valor de atributo. Por ejemplo, el trazado se detiene cuando una entidad tiene el atributo Device Status igual que el valor específico de Open. Cuando una entidad cumple esta condición, el seguimiento se detiene. Si está utilizando más de un atributo, puede usar el parámetro Combinar usando para definir una condición Y u O. Los componentes de condición de barrera son los siguientes:
Los valores de barrera de condición de operator son los siguientes:
Más información sobre los operadores bitwise Las opciones del valor Type de las barreras de condición son las siguientes:
Los valores de Combine Using son los siguientes:
Más información sobre el uso de varias expresiones condicionales | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Opcional) | Define una barrera de transitabilidad en entidades basadas en una función. Las barreras de función se pueden utilizar para hacer cosas como restringir cuánto se desplaza el seguimiento desde el punto de partida o definir un valor máximo en el que se detiene un seguimiento. Por ejemplo, la longitud de cada línea recorrida se suma a la distancia total recorrida hasta ese momento. Cuando la longitud total recorrida alcanza el valor especificado, el seguimiento se detiene. Los componentes de barrera de función son los siguientes:
Las opciones de valor de barrera de función de function son las siguientes:
Las opciones de valor de barrera de función de operator son las siguientes:
Más información sobre los operadores bitwise Las opciones de valor de barrera de función de Use Local Values son las siguientes:
| Value Table |
include_barriers (Opcional) | Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del seguimiento. Las barreras de transitabilidad son opcionales incluso si se han predefinido en la definición de subred.
| Boolean |
traversability_scope (Opcional) | El tipo de traversabilidad que se va a aplicar. El alcance de la transitabilidad dicta si esta se aplica en los cruces, los ejes o en ambos. Por ejemplo, si se define que una condición de barrera detenga el trazado si Estado de dispositivo equivale a Abierto y el alcance de transitabilidad se establece solo en los ejes, el trazado no se detendrá, aunque se encuentre con un dispositivo abierto, porque Estado de dispositivo solo se aplica a los cruces. Es decir, este parámetro indica al trazado debe ignorar los cruces, ejes o ambos.
| String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...] (Opcional) | Especifica qué atributos de red propagar y cómo se producirá dicha propagación durante un seguimiento. Los atributos de clase propagados indican los valores clave en controladores de subred que se difunden al resto de las entidades de la subred. Por ejemplo, en un modelo de distribución eléctrica, puede propagar el valor de fase. Los componentes propagadores son los siguientes:
Las opciones de valor de propagadores de function son las siguientes:
Las opciones de valor de propagadores de operator son las siguientes:
Más información sobre los operadores bitwise Nota:Este parámetro está disponible solo a través de Python. | Value Table |
update_structure_features (Opcional) | Especifica si el proceso de actualización de la subred actualizará el atributo de nombre de subred admitido para los contenedores de red de estructura.
Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | Boolean |
update_container_features (Opcional) | Especifica si el proceso de actualización de la subred actualizará el nombre de subred admitido para los contenedores de red de dominio.
Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | Boolean |
edit_mode_for_default_version (Opcional) | Especifica el modo de edición de las actualizaciones de subred en la versión predeterminada y con la geodatabases de archivos.
Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | String |
edit_mode_for_named_version (Opcional) | Especifica el modo de edición de las actualizaciones de subred en una versión nominal.
Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior y solo se aplica a geodatabases corporativas. | String |
valid_junctions [valid_junctions,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como cruces válidos para la subred. Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | String |
valid_junction_objects [valid_junction_objects,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como objetos de cruce válidos para la subred. Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | String |
valid_junction_object_subnetwork_controller [valid_junction_object_subnetwork_controller,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como controladores de subred de objetos de cruce válidos para la subred. Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | String |
valid_edge_objects [valid_edge_objects,...] (Opcional) | Los pares de grupo de activos/tipo de activos identificados como objetos de eje válidos para la subred. Nota:Este parámetro requiere una Versión de red de servicios 4 o posterior. | String |
manage_subnetwork_isdirty (Opcional) | Especifica si la operación de actualización de subred administrará el atributo Is dirty de la tabla de subredes. Si no se definen controladores de subred para el nivel, este parámetro utiliza la opción predeterminada NOT_MANAGE.
Nota:Este parámetro requiere una Versión de red de servicios 5 o posterior. | Boolean |
include_containers (Opcional) | Especifica si los objetos y entidades de contenedor se incluirán en los resultados del trazado.
Este parámetro requiere una Versión de red de servicios 5 o posterior. | Boolean |
include_content (Opcional) | Especifica si el trazado devolverá el contenido de los contenedores como parte de los resultados.
Este parámetro requiere una Versión de red de servicios 5 o posterior. | Boolean |
include_structures (Opcional) | Especifica si las entidades de estructura y objetos se incluirán en los resultados del trazado.
Este parámetro requiere una Versión de red de servicios 5 o posterior. | Boolean |
validate_locatability (Opcional) | Especifica si se devolverá un error durante una operación de trazado de red o actualización de subred si se encuentran objetos de cruce o eje no espaciales sin la necesaria asociación de contención, adjunto o conectividad en su jerarquía de asociación de los objetos trazados. Esta opción garantiza que los objetos no espaciales que devuelve una operación de trazado de red o actualización de subred se puedan localizar mediante una asociación con entidades u otros objetos localizables.
Nota:Este parámetro requiere una Versión de red de servicios 5 o posterior. | Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_utility_network | La red de servicios de entrada actualizada. | Red de servicios |
Muestra de código
En este ejemplo se establece la definición de subred de un dominio denominado 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)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí