Resumen
Actualiza la información de subred en la tabla Subredes, la clase de entidad SubnetLine y los diagramas de sistema de subred de las subredes especificadas. También se crean o actualizan determinados atributos de las entidades de subred. Se genera un registro para las subredes nuevas, se borran los registros de las subredes eliminadas y se actualizan la forma y la información de las subredes modificadas.
Uso
Se deben cumplir los siguientes requisitos al trabajar con una geodatabase corporativa:
- La red de servicios debe estar registrada como versionada en rama.
- La red de utilidades de entrada debe proceder de un servicio de la red de servicios.
- Si esta herramienta se ejecuta en la versión predeterminada, se actualizan la geometría, el atributo de nombre de subred y los campos propagados de la clase de entidad SubnetLine en su lugar. Si se ejecuta en una versión con nombre, el comportamiento predeterminado (sin eventos) limita las actualizaciones a las entidades y los objetos editados en la versión. El modo de edición se puede modificar para que utilice eventos (con eventos). Esta opción ejecuta el comportamiento de la geodatabase y se puede establecer en la definición de subred tanto para la versión predeterminada como para la versión con nombre. Más información sobre el modo de edición utilizado por la herramienta Actualizar subred
Esta herramienta crea o actualiza los diagramas de red de las redes actualizadas si se especificó una plantilla de diagrama al configurar la definición de subred.
Todas las ediciones se deben guardar antes de ejecutar esta herramienta.
La topología de red debe estar habilitada.
No existen áreas sin validar que se intersequen con entidades de subred.
Sintaxis
arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
Parámetro | Explicación | Tipo de datos |
in_utility_network | La red de servicios que contiene la subred. | Utility Network; Utility Network Layer |
domain_network | La red de dominio que contiene la subred. | String |
tier | El nivel que contiene la subred. | String |
all_subnetworks_in_tier (Opcional) | Especifica si todas las subredes del nivel están actualizadas. Para actualizar un subconjunto de subredes del nivel, utilice el parámetro subnetwork_name.
| Boolean |
subnetwork_name (Opcional) | El nombre de las subredes que se van a actualizar. Si todas las subredes se actualizarán con el parámetro all_subnetworks_in_tier, este parámetro se ignora. | String |
continue_on_failure (Opcional) | Especifica si se ha de detener el proceso de actualización en caso de que una subred falle cuando actualice varias subredes.
| Boolean |
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:
Las opciones de barrera de condición de type son los siguientes:
Los valores de Combine Using son los siguientes:
Nota:Este parámetro está disponible solo a través de Python. 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:
Los valores posibles para las opciones de barrera de función de function son las siguientes:
Por ejemplo, la entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si utiliza la función de mínimo, el resultado es 20; máximo es 30; suma es 50; promedio es 25; recuento es 2; y resta es -10. Las opciones de valor de barrera de función de operator son las siguientes:
Nota:Este parámetro está disponible solo a través de Python. | Value Table |
include_barriers (Opcional) | Especifica si las entidades de barrera de transitabilidad se incluyen o no en los resultados del trazado. Las barreras de transitabilidad son opcionales incluso si se han predefinido en la definición de subred.
Nota:Este parámetro está disponible solo a través de Python y ModelBuilder. | Boolean |
traversability_scope (Opcional) | Especifica el tipo de transitabilidad 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 barrera de condición detenga el trazado si DEVICESTATUS es igual que Open y el alcance de transitabilidad se establece solo en los ejes, el trazado no se detendrá, aunque se encuentre con un dispositivo abierto, porque DEVICESTATUS solo se aplica a los cruces. Es decir, este parámetro indica al seguimiento si debe ignorar los cruces, ejes o ambos.
Nota:Este parámetro está disponible solo a través de Python y ModelBuilder. | String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (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:
Los valores posibles para los propagadores de function son los siguientes:
Los valores de propagador de operator son los siguientes:
Nota:Este parámetro está disponible solo a través de Python y ModelBuilder. | Value Table |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_utility_network | La red de servicios actualizada. | Red de servicios |
Muestra de código
Actualizar una subred específica denominada RMT004.
import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004",
"CONTINUE_ON_FAILURE")
Actualizar todas las subredes del nivel Media tensión.
import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "ALL")
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí