Añadir Regla (Red de servicios)

Resumen

Agrega una regla a una red de servicios.

Todas las reglas creadas dentro de una red de servicios se basan en la clase de red de los niveles de grupo de activos y tipo de activo, y pueden usarse para controlar ciertos comportamientos de la red de servicios.

Uso

Sintaxis

arcpy.un.AddRule(in_utility_network, rule_type, from_class, from_assetgroup, from_assettype, to_class, to_assetgroup, to_assettype, {from_terminal}, {to_terminal}, {via_class}, {via_assetgroup}, {via_assettype}, {via_terminal})
ParámetroExplicaciónTipo de datos
in_utility_network

La red de servicios a la que se agregará la regla.

Utility Network; Utility Network Layer
rule_type

El tipo de regla que se creará.

  • JUNCTION_JUNCTION_CONNECTIVITYCrea una regla de conectividad de cruce-cruce que permite conectar dos entidades de punto mediante una asociación de conectividad (las entidades se desplazan geométricamente).
  • CONTAINMENTCrea una regla de contención en la cual los parámetros de origen son el contenedor y los parámetros de destino son el contenido de una asociación de contención.
  • STRUCTURAL_ATTACHMENTCrea una regla de adjunto estructural en la cual los parámetros de origen son las entidades de estructura y los parámetros de destino son las entidades de adjunto de una asociación de adjuntos estructurales.
  • JUNCTION_EDGE_CONNECTIVITYCrea una regla de conectividad de eje-cruce que permite la conexión de entidades de eje y cruce mediante coincidencia geométrica (las entidades se encuentran en la misma ubicación x, y, z).
  • EDGE_JUNCTION_EDGE_CONNECTIVITYCrea una regla de conectividad eje-cruce-eje que permite conectar un eje a cualquier lado de una entidad de cruce.
String
from_class

Tabla o clase de entidad de red de servicios de origen que se incluirá en la regla.

Las reglas de asociación de contención y adjunto estructural requieren que la entidad de contenedor o estructura se encuentre en este parámetro.

El orden es irrelevante en las reglas de conectividad cruce-cruce, cruce-eje y eje-cruce-eje.

String
from_assetgroup

Grupo de activos correspondiente a from_class al que se aplicará la regla.

String
from_assettype

Tipo de activo correspondiente a from_class al que se aplicará la regla.

String
to_class

Tabla o clase de entidad de red de servicios de destino que se incluirá en la regla.

Las reglas de asociación de contención y adjunto estructural requieren que la entidad de contenido o de adjuntos se encuentre en este parámetro.

El orden es irrelevante en las reglas de conectividad cruce-cruce, cruce-eje y eje-cruce-eje.

String
to_assetgroup

Un grupo de activos para to_class, la clase a la que se aplicará la regla.

String
to_assettype

Especifica un tipo de activo para to_class, la clase a la que se aplicará la regla.

String
from_terminal
(Opcional)

El terminal de origen al que se aplicará la regla. Será un terminal de la clase indicada en from_class. Al crear una regla de conectividad para la entidad con terminales para que se conecte con otra entidad, es necesario especificar el lado del terminal al que conectarse, por ejemplo, el terminal del lado de alta de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Se ignora para los tipos de regla de adjunto estructural o de contención.

String
to_terminal
(Opcional)

El terminal de destino al que se aplicará la regla. Será un terminal de la clase indicada en to_class. Al crear una regla de conectividad para que una entidad se conecte con otra entidad con terminales, es necesario especificar el lado del terminal al que conectarse, por ejemplo, el terminal del lado de baja de un transformador.

Este parámetro es obligatorio si el tipo de activo tiene terminales. Se ignora para los tipos de regla de adjunto estructural o de contención.

String
via_class
(Opcional)

Tabla o clase de entidad de red de servicios de cruce a la que se aplicará la regla. Este parámetro solo se puede especificar con el EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type, dado que se necesitan las tres tablas o clases de entidad para participar en una conectividad de eje-cruce-eje.

String
via_assetgroup
(Opcional)

Un grupo de activos de via_class, la clase a la que se aplicará la regla. Este parámetro solo se puede especificar para el valor de parámetro EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.

String
via_assettype
(Opcional)

Un tipo de activo de via_class, la clase a la que se aplicará la regla. Este parámetro solo se puede especificar para el valor de parámetro EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.

String
via_terminal
(Opcional)

El terminal de via_class, la clase a la que se aplicará la regla. Este parámetro solo se puede especificar para el valor de parámetro EDGE_JUNCTION_EDGE_CONNECTIVITY rule_type.

String

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Red de servicios

Muestra de código

Ejemplo 1 de AddRule (ventana de Python)

Este ejemplo crea una regla de asociación de conectividad de cruce-cruce para permitir que el lado de carga de los interruptores de circuito se conecte al lado de alta de los transformadores de una red de distribución eléctrica.

import arcpy
arcpy.AddRule_un("Distribution Network", "JUNCTION_JUNCTION_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Transformer", "High")
Ejemplo 2 de AddRule (ventana de Python)

Este ejemplo crea una regla de conectividad de cruce-eje para permitir que el lado de carga de los interruptores de circuito se conecte a líneas de media tensión de una red de distribución eléctrica.

import arcpy
arcpy.AddRule_un("Utility Network", "JUNCTION_EDGE_CONNECTIVITY", 
                 "ElectricDistributionDevice", "CircuitBreaker", "Air powered", 
                 "ElectricDistributionLine", "Medium Voltage", 
                 "Single Phase Overhead")
Ejemplo 3 de AddRule (ventana de Python)

Este script de ejemplo crea una regla de asociación de contención para permitir que una caja de conexiones contenga un codo.

import arcpy
arcpy.AddRule_un("Electric Network", "CONTAINMENT", "StructureJunction", 
                 "JunctionBox", "Junction Box", "ElectricDistributionDevice", 
                 "Fuse", "Underground Single Phase Load Break Elbow")
Ejemplo 4 de AddRule (ventana de Python)

Este script de ejemplo crea una regla de asociación de adjunto estructural para permitir la conexión estructural de un interruptor a un poste.

import arcpy
arcpy.AddRule_un("Electric Network", "STRUCTURAL_ATTACHMENT", 
                 "StructureJunction", "Pole", "Wood", 
                 "ElectricDistributionDevice", "Switch", 
                 "Overhead Low Voltage Single Phase Disconnect")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados