Actualizar subred (Red de servicios)

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.

Más información sobre cómo actualizar subredes

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ámetroExplicaciónTipo 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.

  • ALL_SUBNETWORKS_IN_TIERActualiza todas las subredes del nivel. Esta opción utiliza el procesamiento asíncrono para actualizar las subredes mediante el servicio de geoprocesamiento UtilityNetworkTools del sistema. El servicio está reservado a tareas de geoprocesamiento de red de servicios y su configuración predeterminada de tiempo en espera es más larga. Esta es la opción predeterminada.
  • SPECIFIC_SUBNETWORKActualiza únicamente las subredes especificadas en 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.

  • CONTINUE_ON_FAILUREContinúa con la actualización de las subredes en caso de error.
  • STOP_ON_FAILUREDetiene la actualización de las subredes en caso de error. Esta es la opción predeterminada.
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:

  • Name: elija para filtrar por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores diferentes.
  • Type: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro name.
  • Value: establezca un valor específico del tipo de atributo de entrada que causaría la finalización en función del valor del operador.
  • Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando las condiciones Y u O.

Los valores de barrera de condición de Operator son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES_NOT_INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones de barrera de condición de type son los siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.

Los valores de Combine Using son los siguientes:

  • ANDCombinar las barreras de condición.
  • ORUsar si se cumple alguna de las barreras de condición.
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:

  • Function: elija entre una variedad de funciones de cálculo diferentes.
  • Attribute: elija para filtrar por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores diferentes.
  • Value: establezca un valor específico del tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Use Local Values: calcule los valores de cada dirección en lugar del valor global general, por ejemplo, para una barrera de función que está calculando la suma de Shape length, en la que el trazado termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, ya ha alcanzado una longitud de forma cuya suma sea 4, de forma que el trazado finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian, de forma que el seguimiento va más lejos.

  • TRUEUsar valores locales.
  • FALSEUsar valores globales. Esta es la opción predeterminada.

Los valores posibles para las opciones de barrera de función de function son las siguientes:

  • AVERAGEEl promedio de los valores de entrada.
  • COUNTEl número de entidades.
  • MAXEl máximo de valores de entrada.
  • MINEl mínimo de valores de entrada.
  • ADDSumar los valores.
  • SUBTRACTRestar los valores. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

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:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES_NOT_INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).
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.

  • INCLUDE_BARRIERSLas barreras de transitabilidad están incluidas en los resultados de trazado. Esta es la opción predeterminada.
  • EXCLUDE_BARRIERSLas barreras de transitabilidad no se incluyen en los resultados del trazado.
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.

  • BOTH_JUNCTIONS_AND_EDGESAplicar transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • JUNCTIONS_ONLYAplicar transitabilidad solo a los cruces.
  • EDGES_ONLYAplicar transitabilidad solo a los ejes.
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:

  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Substitution Attribute: utilice un valor sustituido en lugar de valores de atributo de red de conjunto de bits. Las sustituciones se codifican a partir del número de bits del atributo de red propagado. Una sustitución es una correlación de cada bit de la fase con otro bit. Por ejemplo, para la Fase AC, una sustitución podría correlacionar el bit A al B y el bit C a nulo. En este ejemplo, la sustitución para 1010 (Fase AC) es 0000-0010-0000-0000 (512). La sustitución captura la correlación de forma que usted sabe que la Fase A se correlacionó con B y la Fase C se correlacionó con nulo y no al contrario (es decir, no se correlacionó la Fase A a nulo ni se correlacionó la Fase C a B).
  • Function: elija entre una variedad de funciones de cálculo.
  • Operator: elija entre una variedad de operadores.
  • Value: proporcione un valor específico para un tipo de atributo de entrada que causaría la finalización en función de un valor del operador.

Los valores posibles para los propagadores de function son los siguientes:

  • PROPAGATED_BITWISE_ANDComparar los valores de una entidad con los de la siguiente.
  • PROPAGATED_MINObtener el valor mínimo.
  • PROPAGATED_MAXObtener el valor máximo.

Los valores de propagador de operator son los siguientes:

  • IS_EQUAL_TOEl atributo es igual que el valor.
  • DOES_NOT_EQUALEl atributo no es igual que el valor.
  • IS_GREATER_THANEl atributo es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl atributo es mayor o igual que el valor.
  • IS_LESS_THANEl atributo es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl atributo es menor o igual que el valor.
  • INCLUDES_THE_VALUESUna operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • DOES_NOT_INCLUDE_THE_VALUESUna operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • INCLUDES_ANYUna operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).
Nota:

Este parámetro está disponible solo a través de Python y ModelBuilder.

Value Table

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Red de servicios

Muestra de código

Ejemplo 1 de UpdateSubnetwork (ventana de Python)

Actualizar una subred específica denominada RMT004.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
Ejemplo 2 de UpdateSubnetwork (ventana de Python)

Actualizar todas las subredes del nivel Media tensión.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados