Trazado (Red de servicios)

Resumen

Devuelve entidades de red en una red de servicios públicos basándose en la conectividad o la transitabilidad desde los puntos de partida especificados.

Las capacidades de trazado de la red de servicios le permiten analizar las rutas existentes en una red. La traversabilidad se refiere al establecimiento de rutas a través de entidades conectadas asociadas que también cumplen requisitos de configuración concretos.

De forma predeterminada, los resultados del trazado se devuelven como una selección e incluyen toda la entidad de línea. Para devolver resultados de entidades parciales que respetan la ubicación de los puntos de partida y las barreras a lo largo de un eje, defina el parámetro Tipos de resultados como Geometría agregada. Las ubicaciones de trazado situadas en un punto intermedio a lo largo de un objeto de eje se pueden utilizar para devolver geometrías parciales cuando los objetos de eje están contenidos en una entidad de línea usando el parámetro Sintetizar geometrías.

Con la opción Geometría agregada, los puntos de partida colocados a lo largo de un eje devolverán el elemento de eje del cruce anterior con conectividad intermedia o de extremo. Cuando se coloca una barrera a lo largo de un eje con el parámetro Incluir entidades de barrera activado, el trazado se detendrá en el siguiente cruce encontrado con la conectividad en punto intermedio o el extremo de línea. Si se desactiva el parámetro Incluir entidades de barrera, el trazado se detendrá en el cruce anterior encontrado con la conectividad en punto intermedio o el extremo de línea previo.

A continuación, puede propagar el conjunto de selección resultante o la clase de entidad de salida generada por el trazado a otro mapa o a una vista de diagrama de la red, o bien utilizarse como entrada para otra herramienta u otro trazado.

Más información sobre el trazado en las redes de servicios

Uso

  • La topología de red debe estar habilitada. Dado que la herramienta trazado de red depende de la topología de red, los resultados de un trazado pueden no ser precisos si se incluyen áreas sin validar. La topología de red del área en la que se desea realizar el trazado debe estar validada para reflejar las ediciones o actualizaciones más recientes realizadas en la red.

  • Al trabajar con una geodatabase corporativa, la red de servicios de entrada debe proceder de un servicio de la red de servicios.

  • Cuando se ejecuta un trazado basado en subredes con la herramienta Trazado mediante Python, la configuración de trazado de subred del nivel de entrada no se aplica de forma automática y se debe especificar manualmente.

  • Al trabajar con atributos de red asignados a un campo de fecha para barreras de filtro, barreras de funciones de filtro, funciones y condiciones de salida, formatee el valor de fecha como yyyy-mm-dd hh:mm:ss, por ejemplo, 2020-10-12 18:45:31.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de servicios de entrada

La red de servicios en la que se ejecutará el trazado. Al trabajar con una geodatabase corporativa, la red de servicios de entrada debe provenir de un servicio de entidades; una red de servicios que provenga de una conexión de base de datos no es compatible.

Utility Network; Utility Network Layer
Tipo de trazado de red

Especifica el tipo de trazado que se utilizará.

  • ConectadoSe usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas. Esta es la opción predeterminada.
  • SubredSe usarán los trazados de subred que comiencen en uno o varios puntos de partida y se expandan hacia fuera para abarcar la extensión de la subred.
  • Controladores de subredSe usará un trazado de controladores de subred que localice los orígenes y sumideros de los controladores de subred asociados a una subred.
  • Aguas arribaSe usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red.
  • Aguas abajoSe usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red.
  • BuclesSe usará un trazado en bucle que se extienda hacia fuera desde el punto de partida basándose en la conectividad. Recorre en bucle las áreas de la red cuya dirección de flujo sea ambigua.
  • Ruta más cortaSe usará un trazado de ruta más corta que identifique la ruta más corta entre dos puntos de partida.
  • AislamientoSe usará un trazado de red de aislamiento que descubra las entidades que aíslan un área de una red.
String
Puntos de partida
(Opcional)

Una capa de entidades creada mediante la herramienta Puntos de partida del panel Ubicaciones de trazado, o bien una tabla o clase de entidad que contiene uno o varios registros que representan los puntos de partida del trazado. Esta clase de entidad o tabla debe incluir el campo FEATUREGLOBALID para almacenar información de la entidad de red asociada. De forma predeterminada, se utiliza la clase de entidad UN_Temp_Starting_Points de la geodatabase predeterminada del proyecto.

Feature Layer; Table View
Barreras
(Opcional)

Una capa de entidades creada con la herramienta Barreras del panel Ubicaciones de trazado, o bien una tabla o clase de entidad que contiene uno o varios registros que representan barreras que impiden que el trazado vaya más allá de ese punto. Esta clase de entidad o tabla debe incluir el campo FEATUREGLOBALID para almacenar información de la entidad de red asociada. Se utiliza de manera predeterminada la clase de entidad UN_Temp_Barriers de la geodatabase predeterminada del proyecto.

Feature Layer; Table View
Red de dominio
(Opcional)

El nombre de la red de dominio en la que se ejecutará el trazado. Este parámetro es obligatorio para ejecutar los tipos de trazado de subred, controladores de subred, aguas arriba y aguas abajo.

String
Nivel
(Opcional)

El nombre del nivel en el que empezará el trazado. Este parámetro es obligatorio para ejecutar los tipos de trazado de subred, controladores de subred, aguas arriba y aguas abajo.

String
Nivel objetivo
(Opcional)

El nombre del nivel de destino hacia el que fluirá el nivel de entrada. Si este parámetro está presente en los trazados aguas arriba y aguas abajo, estos rastreos se detienen tan pronto como alcanzan el límite de la subred de partida. Este parámetro puede usarse para permitir que estos trazados continúen, ya sea más arriba o más abajo en la jerarquía.

String
Nombre de subred
(Opcional)

El nombre de la subred en la que se ejecutará el rastreo. Este parámetro puede usarse al ejecutar un tipo de trazado de subred. Si se especifica un nombre de subred, no se requiere el parámetro Puntos de partida. Cuando la tabla de subredes contiene 10.000 o más registros para un nivel, la lista de opciones del parámetro no se rellena y se proporciona un campo vacío para el nombre de subred.

String
Nombre de atributo de red de ruta más corta
(Opcional)

El atributo de red que se utilizará para calcular la ruta más corta. Al ejecutar el tipo de trazado de ruta más corta, la ruta más corta se calcula utilizando un atributo de red numérico, por ejemplo, la longitud de forma. Es posible conseguir rutas basadas tanto en el coste como en la distancia. Este parámetro es obligatorio si se ejecuta un trazado de ruta más corta.

String
Incluir contenedores
(Opcional)

Especifica si las entidades de contenedor se incluirán en los resultados del trazado.

  • Activado: las entidades de contenedor se incluirán en los resultados del trazado. Esto habilita el parámetro Incluir hasta primer contenedor espacial.
  • Desactivado: las entidades de contenedor no se incluirán en los resultados del trazado. Esta es la opción predeterminada.

Boolean
Incluir contenido
(Opcional)

Especifica si el trazado devolverá el contenido de las entidades del contenedor en los resultados.

  • Activado: el contenido de las entidades de contenedor se incluirá en los resultados del trazado.
  • Desactivado: el contenido de las entidades de contenedor no se incluirá en los resultados del trazado. Esta es la opción predeterminada.

Boolean
Incluir estructuras
(Opcional)

Especifica si las entidades de estructura y objetos se incluirán en los resultados del trazado.

  • Activado: las entidades de estructura y objetos se incluirán en los resultados del trazado.
  • Desactivado: las entidades de estructura y objetos no se incluirán en los resultados del trazado. Esta es la opción predeterminada.

Boolean
Incluir entidades de barrera
(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. Este parámetro no se aplica a las entidades del dispositivo con terminales.

  • Activado: las entidades de barrera de transitabilidad se incluirán en los resultados del seguimiento. Esta es la opción predeterminada.
  • Desactivado: las entidades de barrera de transitabilidad no se incluirán en los resultados del seguimiento.

Boolean
Validar coherencia
(Opcional)

Especifica si se devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la única forma de garantizar que un trazado pase por las entidades que presentan un estado coherente en la red. Para eliminar áreas sin validar, valide la topología de red.

  • Activado: el trazado de red devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la opción predeterminada.
  • Desactivado: el trazado de red devuelve resultados independientemente de si se encuentran áreas sin validar en cualquiera de las entidades recorridas.

Boolean
Barreras de condición
(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 barrera de condición son los siguientes:

  • Nombre: filtre por cualquier atributo o categoría de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Tipo: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro Nombre.
  • Valor: 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.
  • Combinar usando: defina este valor si tiene varios atributos que agregar. Puede combinaros mediante una condición And u Or.

Las opciones de valor de las barreras de condición de Operador son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones del valor Tipo de las barreras de condición son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

Value Table
Barreras de función
(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:

  • Función: elija entre una variedad de funciones de cálculo.
  • Atributo: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Valor: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Usar valores locales: calcule los valores de cada dirección en lugar del valor global general, por ejemplo, una barrera de función que está calculando la suma de Shape length, en la que el seguimiento termina si el valor es mayor o igual que 4. En el caso global, después de haber hecho un seguimiento poligonal de dos ejes con un valor de 2, ya ha alcanzado una suma de Shape length de 4, de forma que el seguimiento finaliza. Si se utilizan valores locales, los valores locales a lo largo de cada ruta cambian y el seguimiento continúa.
    • Activado: se utilizarán los valores locales.
    • Desactivado: se utilizarán valores globales. Esta es la opción predeterminada.

Las opciones de valor de la barrera de función de Función son las siguientes:

  • Mínimo: el mínimo de valores de entrada.
  • Máximo: el máximo de valores de entrada.
  • Suma: la suma de los valores de entrada.
  • Promedio: el promedio de los valores de entrada.
  • Recuento: el número de entidades.
  • Resta: la diferencia entre los valores de entrada.

    Ni los controladores de subred ni los tipos de seguimiento 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 Operador son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Value Table
Aplicar transitabilidad a
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en ambos. Por ejemplo, si se define que una condición de barrera detenga el seguimiento si Estado de dispositivo equivale a Abierto y el alcance de transitabilidad se establece solo en los ejes, el seguimiento 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 si debe ignorar los cruces, ejes o ambos.

  • Tanto a los cruces como a los ejesSe aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • Solo a los crucesSolo se aplicará la transitabilidad a los cruces.
  • Solo a los ejesSolo se aplicará la transitabilidad a los ejes.
String
Barreras de filtro
(Opcional)

Define cuándo se detendrá el trazado con una categoría o un atributo de red específicos. Por ejemplo, el trazado se detiene en las entidades que presentan un atributo de estado de ciclo igual a un determinado valor. Este parámetro se utiliza para definir un terminador basado en un valor de un atributo de red que está definido en el sistema. Si está utilizando más de un atributo, puede usar la opción Combinar usando para definir una condición Y u O.

Los componentes de barrera de filtro son los siguientes:

  • Nombre: filtre por categoría o cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Tipo: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro Nombre.
  • Valor: proporciona 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.
  • Combinar usando: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Las opciones de valor de barrera de filtro de Operador son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones de valor de barrera de filtro de Tipo son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

Value Table
Barreras de función de filtro
(Opcional)

Filtra los resultados del rastreo para una categoría específica.

Los componentes de barrera de función de filtro son los siguientes:

  • Función: elija entre una variedad de funciones de cálculo.
  • Atributo: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Valor: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Usar valores locales: calcule los valores de cada dirección, en lugar de un valor global general. Por ejemplo, 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 habrá 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, o bien el trazado continúa.
    • Activado: se utilizarán los valores locales. Esta es la opción predeterminada.
    • Desactivado: se utilizarán valores globales.

Las opciones de valor de Función de las barreras de función de filtro son las siguientes:

  • Mínimo: se identificará el mínimo de valores de entrada.
  • Máximo: se identificará el máximo de valores de entrada.
  • Suma: se calculará la suma de los valores.
  • Promedio: se calculará el promedio de los valores de entrada.
  • Recuento: se identificará el número de entidades.
  • Sustraer: se calculará la diferencia entre los valores. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Por ejemplo, una entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si está usando la función 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 filtro de Operador son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Value Table
Aplicar filtro a
(Opcional)

Especifica si el filtro de una categoría específica se aplicará a los cruces, los ejes o ambos. Por ejemplo, si se define que una barrera de filtro 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 si debe ignorar los cruces, ejes o ambos.

  • Tanto a los cruces como a los ejes: se aplicará el filtro tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • Solo a los cruces: solo se aplicará el filtro a los cruces.
  • Solo a los ejes: solo se aplicará el filtro a los ejes.

  • Tanto a los cruces como a los ejesSe aplicará el filtro tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • Solo a los crucesSolo se aplicará el filtro a los cruces.
  • Solo a los ejesSolo se aplicará el filtro a los ejes.
String
Filtrar por atributo de red de conjunto de bits
(Opcional)

El nombre del atributo de red que se usará para filtrar por conjunto de bits. Este parámetro solo es aplicable a los tipos de trazado de aguas arriba, aguas abajo y bucles. Este parámetro puede usarse para agregar una lógica especial durante un trazado, de modo que el trazado refleje más fielmente las situaciones reales. Por ejemplo, en un trazado de bucles, el atributo de red Fases actuales permite determinar si el bucle es un bucle eléctrico real (se alimenta la misma fase en todo el bucle, es decir, A) y devuelve solo los bucles eléctricos reales de los resultados del trazado de red. Un ejemplo de un trazado aguas arriba es que, durante el trazado de una red de distribución eléctrica, se especifica el atributo de red Fases actuales y el resultado del trazado solo contendrá las rutas válidas que se especifiquen en el atributo de red, no todas las rutas.

String
Filtrar por más cercano
(Opcional)

Especifica si el algoritmo k-vecinos más cercanos se usará para devolver un número de entidades de un tipo concreto dentro de una distancia determinada. Es posible proporcionar un recuento, un coste y una colección de categorías, además de un tipo de activos, o ambos.

  • Activado: se utilizará el algoritmo k-vecinos más cercanos para devolver el número de entidades especificado en el parámetro Recuento, Atributo de red de coste, Categorías más cercanas o Grupos/tipos de activos más cercanos.
  • Desactivado: no se utilizará el algoritmo k-vecinos más cercanos para filtrar resultados. Esta es la opción predeterminada.

Boolean
Recuento
(Opcional)

El número de entidades que se devolverán cuando se active Filtrar por más cercano.

Long
Atributo de red de coste
(Opcional)

El atributo de red numérico que se utilizará para calcular la cercanía, el coste o la distancia cuando Filtrar por más cercano esté activado, por ejemplo, Shape length.

String
Categorías más cercanas
(Opcional)

Las categorías que se devolverán cuando Filtrar por más cercano se active, por ejemplo, Protective.

String
Grupos/tipos de activos más cercanos
(Opcional)

Los tipos y grupos de activos que se devolverán cuando Filtrar por más cercano se active, por ejemplo, ElectricDistributionDevice/Transformer/Step Down.

String
Funciones
(Opcional)

La función o funciones de cálculo que se aplicarán al resultado del trazado de red.

Los componentes de funciones son los siguientes:

  • Función: elija entre una variedad de funciones de cálculo.
  • Atributo: filtre por cualquier atributo de red definido en el sistema.
  • Nombre de filtro: filtre los resultados de la función por nombre de atributo.
  • Operador de filtro: elija entre una variedad de operadores.
  • Tipo de filtro: elija entre una variedad de tipos de filtros.
  • Valor de filtro: indique un valor específico para el atributo de filtro de entrada.

Las opciones de valor de funciones de Función son las siguientes:

  • Promedio: se calculará el promedio de los valores de entrada.
  • Recuento: se identificará el número de entidades.
  • Máximo: se identificará el máximo de valores de entrada.
  • Mínimo: se identificará el mínimo de valores de entrada.
  • Suma: se calculará la suma de los valores de entrada.
  • Resta: la diferencia entre los valores de entrada.

    Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Por ejemplo, una entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si está usando la función 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 las funciones de Operador de filtro son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones de valor de las funciones de Tipo de filtro son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

  • MediaSe calculará el promedio de los valores de entrada.
  • RecuentoSe identificará el número de entidades.
  • MáximoSe identificará el máximo de valores de entrada.
  • MínimoSe identificará el mínimo de valores de entrada.
  • AgregarSe calculará la suma de los valores.
  • SustraerSe calculará la diferencia entre los valores.Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.
Value Table
Propagadores
(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.

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

  • Es igual queEl atributo es igual que el valor.
  • No es igual queEl atributo no es igual que el valor.
  • Es mayor queEl atributo es mayor que el valor.
  • Es mayor o igual queEl atributo es mayor o igual que el valor.
  • Es menor queEl atributo es menor que el valor.
  • Es menor o igual queEl atributo es menor o igual que el valor.
  • Incluye los valores (bitwise AND es igual que el valor)Una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores (bitwise AND no es igual que el valor)Una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquiera (bitwise AND es igual que True)Una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno (bitwise AND es igual que False)Una 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 para Python.

Value Table
Tipos de activos de salida
(Opcional)

Filtra los tipos de activo de salida para su inclusión en el resultado, por ejemplo, devolver únicamente transformadores suspendidos.

String
Condiciones de salida
(Opcional)

Los tipos de entidades que se devolverán en función de una categoría o atributo de red. Por ejemplo, en un trazado configurado para excluir todo excepto las entidades Toma, las entidades procesadas por el trazado que no tengan asignada la categoría Toma no se incluyen en el resultado. Las entidades procesadas por el trazado que sí la tengan se devuelven en el conjunto de selección de resultado.

Los componentes de condiciones de salida son los siguientes:

  • Nombre: filtre por cualquier atributo de red definido en el sistema.
  • Operador: elija entre una variedad de operadores.
  • Tipo: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro Nombre.
  • Valor: proporciona 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.
  • Combinar usando: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Las opciones de valor de las condiciones de salida de Operator son las siguientes:

  • Es igual que: el atributo es igual que el valor.
  • No es igual que: el atributo no es igual que el valor.
  • Es mayor que: el atributo es mayor que el valor.
  • Es mayor o igual que: el atributo es mayor o igual que el valor.
  • Es menor que: el atributo es menor que el valor.
  • Es menor o igual que: el atributo es menor o igual que el valor.
  • Incluye los valores: una operación bitwise AND en la que todos los bits del valor están presentes en el atributo (bitwise AND == valor).
  • No incluye los valores: una operación bitwise AND en la que no todos los bits del valor están presentes en el atributo (bitwise AND != valor).
  • Incluye cualquier: una operación bitwise AND en la que al menos un bit del valor está presente en el atributo (bitwise AND == True).
  • No incluye ninguno: una operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Las opciones de valor de las condiciones de salida de Tipo son las siguientes:

  • Valor específico: filtrar por un valor específico.
  • Atributo de red: filtrar por un atributo de red.

Value Table
Incluir entidades aisladas
(Opcional)

Especifica si las entidades aisladas se incluirán en los resultados del trazado. Este parámetro solo se utiliza al ejecutar un trazado de red de aislamiento.

  • Activado: las entidades aisladas se incluirán en los resultados del trazado.
  • Desactivado: las entidades aisladas no se incluirán en los resultados del trazado. Esta es la opción predeterminada.

Boolean
Ignorar barreras en los puntos de partida
(Opcional)

Especifica si las barreras dinámicas de la configuración de trazado se ignorarán en los puntos de partida. Puede resultar útil al realizar un trazado de un dispositivo de protección aguas arriba y al utilizar los dispositivos de protección descubiertos (barreras) como puntos de partida para buscar dispositivos de protección aguas arriba posteriores.

  • Activado: las barreras de los puntos de partida se ignorarán en el trazado.
  • Desactivado: las barreras de los puntos de partida no se ignorarán en el trazado. Esta es la opción predeterminada.

Boolean
Incluir hasta primer contenedor espacial
(Opcional)

Especifica si los contenedores devueltos se limitarán a solo los encontrados hasta el primer contenedor espacial (este incluido) para cada elemento de red en los resultados de trazado. Si no se encontraran contenedores espaciales sino contenedores no espaciales para un elemento de red determinado, todos los contenedores no espaciales se incluirán en los resultados. Este parámetro solo está disponible cuando se activa Incluir contenedores.

  • Activado: en los resultados se devolverán los contenedores encontrados solamente hasta el primer contenedor espacial, incluido este, cuando se encuentran asociaciones de contención anidadas a lo largo de la ruta del trazado. Si no existen contenedores espaciales, todos los contenedores no espaciales se incluirán en los resultados para un elemento de red determinado.
  • Desactivado: todos los contenedores se devolverán en los resultados. Esta es la opción predeterminada.
Boolean
Tipos de resultados
(Opcional)

Especifica el tipo de resultados que devolverá el trazado.

  • SelecciónLos resultados del trazado se devolverán como una selección definida en las entidades de red adecuadas. Esta es la opción predeterminada.
  • Geometría agregadaLos resultados del trazado se agregarán por tipo de geometría y se almacenarán en clases de entidad multiparte que se muestran en las capas en el mapa activo.
  • ConectividadLos resultados del trazado de red se devolverán como un gráfico de conectividad en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita el parámetro JSON de salida.
  • ElementosLos resultados del trazado de red se devolverán como información basada en entidades en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita el parámetro JSON de salida.
  • EntidadesLos resultados del trazado de red se devolverán como información basada en entidades en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita los parámetros Incluir geometría, Incluir descripciones de dominio, Atributos de red de resultado, Campos de resultado y JSON de salida.
  • Asociaciones de contenido y de adjuntoLos resultados del trazado se devolverán como información de asociación para entidades de red recorridas que están asociadas mediante asociaciones de contención y adjunto estructural en un archivo .json de salida especificado. Esta opción habilita los parámetros Incluir descripciones de dominio y JSON de salida.
String
Tipo de selección

Especifica cómo se aplicará la selección y qué hacer si existe una selección actual.

  • Nueva selecciónLa selección resultante reemplazará a la selección actual. Esta es la opción predeterminada.
  • Añadir a selección actualLa selección resultante se agregará a la selección actual, si la hay. Si no existe ninguna selección, coincide con la opción de nueva selección.
  • Eliminar de la selección actualLa selección resultante se quitará de la selección actual. Si no existe ninguna selección, esta opción no tendrá efecto.
  • Seleccionar subconjunto de la selección actualLa selección resultante se combinará con la selección actual. Solo permanecen seleccionados los registros comunes a ambas selecciones.
  • Cambiar la selección actualLa selección resultante se conmutará. Los resultados seleccionados se quitan de la selección actual; los resultados no seleccionados se agregan a la selección actual. Si no existe ninguna selección, coincide con la opción de nueva selección.
String
Borrar todos los resultados anteriores del trazado
(Opcional)

Especifica si el contenido se truncará o se incorporará a las clases de entidad elegidas para almacenar geometría agregada. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • Activado: las clases de entidad que almacenan geometría agregada de trazado se truncarán. Solo se escribirá la geometría de salida de la operación de trazado actual. Esta es la opción predeterminada.
  • Desactivado: la geometría de salida de la operación de trazado actual se incorporará a las clases de entidad que almacenen geometría agregada.
Boolean
Nombre de trazado
(Opcional)

El nombre de la operación de trazado. Este valor se almacena en el campo TRACENAME de la clase de entidad de salida para ayudar a identificar los resultados del trazado de red. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

String
Puntos agregados
(Opcional)

Una clase de entidad multipunto de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad multipunto y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
Líneas agregadas
(Opcional)

Una clase de entidad de polilínea de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Lines que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polilínea y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
Polígonos agregados
(Opcional)

Una clase de entidad de polígono de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polígono y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
Permitir flujo indeterminado
(Opcional)

Especifica si se realizará un trazado de las entidades con flujo indeterminado. Este parámetro solo es aplicable al ejecutar un trazado aguas arriba, aguas abajo o de aislamiento.

  • Activado: se realizará un trazado de las entidades con flujo indeterminado. Esta es la opción predeterminada.
  • Desactivado: se detendrá la transitabilidad de las entidades con flujo indeterminado y no se realizará su trazado.

Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 5 o posterior.

Boolean
Validar capacidad de localización
(Opcional)

Especifica si se devolverá un error durante un trazado de red 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. Este parámetro 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.

  • Activado: el trazado devolverá un error 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.
  • Desactivado: el trazado de red no comprobará si hay objetos que no se pueden localizar y devolverá resultados independientemente de si se encuentran objetos que no se pueden localizar en la jerarquía de asociación de los objetos trazados. Esta es la opción predeterminada.

Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 4 o posterior.

Boolean
Utilizar configuración de trazado
(Opcional)

Especifica si se utilizará una configuración de trazado de red nominal existente para rellenar los parámetros de esta herramienta.

  • Activado: se utilizará una configuración de trazado de red nominal existente para definir las propiedades del trazado. Se ignorarán todos los parámetros excepto Nombre de configuración de trazado de red, Puntos de partida y Barreras.
  • Desactivado: no se utilizará ninguna configuración de trazado de red nominal existente para definir las propiedades del trazado. Esta es la opción predeterminada.

Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 5 o posterior.

Boolean
Nombre de configuración de trazado de red
(Opcional)

El nombre de la configuración de trazado de red nominal que se utilizará para definir las propiedades del trazado. Este parámetro solo está activado cuando el parámetro Utilizar configuración de trazado está activado.

Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 5 o posterior.

String
JSON de salida
(Opcional)

El nombre y la ubicación del archivo .json que se generarán al devolver resultados del trazado con los tipos de resultados de conectividad, elementos, entidades o asociaciones de contención y adjunto.

File
Ejecutar en modo asíncrono en el servidor
(Opcional)

Especifica si las operaciones de seguimiento se procesarán de forma asíncrona cuando se trabaje con una red de servicios públicos en una geodatabase corporativa.

  • Activada: las operaciones de seguimiento se procesarán de forma asíncrona
  • Desactivada: las operaciones de seguimiento se procesarán de forma síncrona. Esta es la opción predeterminada.

Nota:

Este parámetro requiere ArcGIS Enterprise 10.9.1 o versiones posteriores.

Boolean
Incluir geometría
(Opcional)

Especifica si se incluirá la geometría en los resultados.

  • Activado: la geometría se incluirá en los resultados.
  • Desactivado: la geometría no se incluirá en los resultados. Esta es la opción predeterminada.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Boolean
Incluir descripciones de dominio
(Opcional)

Especifica si las descripciones de dominio se incluirán en el archivo .json de salida para comunicar la asignación de dominio de controladores, featureElements, conectividad y asociaciones.

  • Activado: se incluirán descripciones de dominio en los resultados.
  • Desactivado: no se incluirán descripciones de dominio en los resultados. Esta es la opción predeterminada.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Boolean
Atributos de red de resultado
(Opcional)

Los atributos de red que se incluirán en los resultados.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

String
Campos de resultado
(Opcional)

Los campos de una clase de entidad que se devolverán como resultados. Los valores del campo se devolverán en los resultados de las entidades del trazado.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Value Table
Utilizar dirección digitalizada
(Opcional)

Especifica si las operaciones de trazado ascendentes y descendentes determinarán la dirección del flujo utilizando la dirección digitalizada de la línea, el Id. global De y A del objeto de eje en la asociación y el atributo Flow direction. Este parámetro solo está disponible y activo a partir de la versión 7 de Utility Network cuando el parámetro Tipo de trazado se configura en Ascendente o Descendente.

  • Activado: las operaciones de trazado determinarán la dirección del flujo utilizando la dirección digitalizada de la línea, el Id. global De y A del objeto de eje en la asociación y el atributo de dirección del flujo. Cuando se activa este parámetro, los parámetros Red de dominio, Nivel y Nivel objetivo se ocultan e ignoran.
  • Desactivado: las opciones de trazado determinarán la dirección del flujo en función de la ubicación de los controladores de subred. Esta es la opción predeterminada.

Nota:

Este parámetro requiere ArcGIS Enterprise 11.3 o posterior si se utiliza una geodatabase corporativa.

Boolean
Sintetizar geometrías
(Opcional)

Especifica si se inferirán y crearán (sintetizarán) geometrías para asociaciones y objetos de eje de trazado poligonal como parte de una operación de trazado. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • Activado: se inferirán y crearán geometrías para las asociaciones de trazado poligonal y los objetos de eje en la clase de entidad de salida Trace_Results_Aggregated_Lines.
  • Desactivado: las geometrías no se sintetizarán para las asociaciones de trazado poligonal y los objetos de eje. Esta es la opción predeterminada.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de servicios de salida

La red de servicios actualizada.

Utility Network

arcpy.un.Trace(in_utility_network, trace_type, {starting_points}, {barriers}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {aggregated_polygons}, {allow_indeterminate_flow}, {validate_locatability}, {use_trace_config}, {trace_config_name}, {out_json_file}, {run_async}, {include_geometry}, {include_domain_descriptions}, {result_network_attributes}, {result_fields}, {use_digitized_direction}, {synthesize_geometries})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios en la que se ejecutará el trazado. Al trabajar con una geodatabase corporativa, la red de servicios de entrada debe provenir de un servicio de entidades; una red de servicios que provenga de una conexión de base de datos no es compatible.

Utility Network; Utility Network Layer
trace_type

Especifica el tipo de trazado que se utilizará.

  • CONNECTEDSe usará un trazado conectado que comienza en uno o varios puntos de partida y se expande hacia fuera a lo largo de entidades conectadas. Esta es la opción predeterminada.
  • SUBNETWORKSe usarán los trazados de subred que comiencen en uno o varios puntos de partida y se expandan hacia fuera para abarcar la extensión de la subred.
  • SUBNETWORK_CONTROLLERSSe usará un trazado de controladores de subred que localice los orígenes y sumideros de los controladores de subred asociados a una subred.
  • UPSTREAMSe usará un trazado aguas arriba que descubra entidades aguas arriba desde una ubicación de la red.
  • DOWNSTREAMSe usará un trazado aguas abajo que descubra entidades aguas abajo desde una ubicación de la red.
  • LOOPSSe usará un trazado en bucle que se extienda hacia fuera desde el punto de partida basándose en la conectividad. Recorre en bucle las áreas de la red cuya dirección de flujo sea ambigua.
  • SHORTEST_PATHSe usará un trazado de ruta más corta que identifique la ruta más corta entre dos puntos de partida.
  • ISOLATIONSe usará un trazado de red de aislamiento que descubra las entidades que aíslan un área de una red.
String
starting_points
(Opcional)

Una tabla o clase de entidad que contiene uno o varios registros que representan los puntos de partida del trazado. Esta clase de entidad o tabla debe incluir el campo FEATUREGLOBALID para almacenar información de la entidad de red asociada. Para ver el formato específico, cree puntos de partida con la herramienta Puntos de partida del panel Ubicaciones de trazado y visualice el esquema de la clase de entidad UN_Temp_Starting_Points almacenada en la geodatabase predeterminada.

Feature Layer; Table View
barriers
(Opcional)

Una tabla o clase de entidad que contiene una o varias entidades que representan las barreras del trazado que impiden que el trazado vaya más allá de ese punto. Esta clase de entidad o tabla debe incluir el campo FEATUREGLOBALID para almacenar información de la entidad de red asociada. Para ver el formato específico, cree barreras con la herramienta Barreras del panel Ubicaciones de trazado y visualice el esquema de la clase de entidad UN_Temp_Barriers almacenada en la geodatabase predeterminada.

Feature Layer; Table View
domain_network
(Opcional)

El nombre de la red de dominio en la que se ejecutará el trazado. Este parámetro es obligatorio para ejecutar los tipos de trazado de subred, controladores de subred, aguas arriba y aguas abajo.

String
tier
(Opcional)

El nombre del nivel en el que empezará el trazado. Este parámetro es obligatorio para ejecutar los tipos de trazado de subred, controladores de subred, aguas arriba y aguas abajo.

String
target_tier
(Opcional)

El nombre del nivel de destino hacia el que fluirá el nivel de entrada. Si este parámetro está presente en los trazados aguas arriba y aguas abajo, estos rastreos se detienen tan pronto como alcanzan el límite de la subred de partida. Este parámetro puede usarse para permitir que estos trazados continúen, ya sea más arriba o más abajo en la jerarquía.

String
subnetwork_name
(Opcional)

El nombre de la subred en la que se ejecutará el rastreo. Este parámetro puede usarse al ejecutar un tipo de trazado de subred. Si se especifica un nombre de subred, no se requiere el parámetro starting_points.

String
shortest_path_network_attribute_name
(Opcional)

El atributo de red que se utilizará para calcular la ruta más corta. Al ejecutar el tipo de trazado de ruta más corta, la ruta más corta se calcula utilizando un atributo de red numérico, por ejemplo, la longitud de forma. Es posible conseguir rutas basadas tanto en el coste como en la distancia. Este parámetro es obligatorio si se ejecuta un trazado de ruta más corta.

String
include_containers
(Opcional)

Especifica si las entidades de contenedor se incluirán en los resultados del trazado.

  • INCLUDE_CONTAINERSLas entidades de contenedor se incluirán en los resultados del trazado.
  • EXCLUDE_CONTAINERSLas entidades de contenedor no se incluirán en los resultados del trazado. Esta es la opción predeterminada.
Boolean
include_content
(Opcional)

Especifica si el trazado devolverá el contenido de las entidades del contenedor en los resultados.

  • INCLUDE_CONTENTEl contenido de las entidades de contenedor se incluirá en los resultados del trazado.
  • EXCLUDE_CONTENTEl contenido de las entidades de contenedor no se incluirá en los resultados del trazado. Esta es la opción predeterminada.
Boolean
include_structures
(Opcional)

Especifica si las entidades de estructura y objetos se incluirán en los resultados del trazado.

  • INCLUDE_STRUCTURESLas entidades de estructura y objetos se incluirán en los resultados del trazado.
  • EXCLUDE_STRUCTURESLas entidades de estructura y objetos no se incluirán en los resultados del trazado. Esta es la opción predeterminada.
Boolean
include_barriers
(Opcional)

Especifica si las entidades de barrera de transitabilidad se incluirán en los resultados del trazado. Las barreras de transitabilidad son opcionales incluso si se han predefinido en la definición de subred. Este parámetro no se aplica a las entidades del dispositivo con terminales.

  • INCLUDE_BARRIERSLas entidades de barrera de transitabilidad se incluirán en los resultados del trazado. Esta es la opción predeterminada.
  • EXCLUDE_BARRIERSLas entidades de barrera de transitabilidad no se incluirán en los resultados del trazado.
Boolean
validate_consistency
(Opcional)

Especifica si se devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la única forma de garantizar que un trazado pase por las entidades que presentan un estado coherente en la red. Para eliminar áreas sin validar, valide la topología de red.

  • VALIDATE_CONSISTENCYEl trazado de red devuelve un error si se encuentran áreas sin validar en cualquiera de las entidades recorridas. Esta es la opción predeterminada.
  • DO_NOT_VALIDATE_CONSISTENCYEl trazado de red devuelve resultados independientemente de si se encuentran áreas sin validar en cualquiera de las entidades recorridas.
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: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores.
  • Type: elija un valor o un atributo de red específicos del valor que se especifica en el parámetro name.
  • 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.
  • Combine Using: defina este valor si tiene varios atributos que agregar. Puede combinarlos utilizando una condición Y u O.

Las opciones del valor Operator de las barreras de condición 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).

Más información sobre los operadores bitwise

Las opciones del valor Type de las barreras de condición son las siguientes:

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

Las opciones del valor Combine Using de las barreras de condición son las siguientes:

  • ANDCombinar las barreras de condición.
  • ORUsar si se cumple alguna de las barreras de condición.

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.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores.
  • Value: indique un valor específico para el 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, se configura una función barrera que detiene el trazado una vez que la suma de Shape length es mayor o igual a 4. Con el valor global, después de haber hecho un trazado poligonal de dos ejes con un valor de 2, habrá alcanzado una suma Shape length de 4, lo que detiene el trazado. Si se utilizan valores locales, cuando el trazado poligonal encuentra una bifurcación, los valores calculados para cada ruta a lo largo de la rama se mantienen por separado. En este caso, si el punto de partida se coloca en la bifurcación, los valores locales a lo largo de cada ruta se calculan por separado y el trazado continuará hasta alcanzar una suma de 4 a lo largo de cada ruta.

Las opciones de valor de barrera de función de Function son las siguientes:

  • AVERAGESe calculará el promedio de los valores de entrada.
  • COUNTSe identificará el número de entidades.
  • MAXSe identificará el máximo de valores de entrada.
  • MINSe identificará el mínimo de valores de entrada.
  • ADDSe calculará la suma de los valores.
  • SUBTRACTSe calculará la diferencia entre los valores. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Las opciones de valor de barrera de función de Operator son las siguientes:

  • IS_EQUAL_TOEl resultado de la función es igual que el valor.
  • DOES_NOT_EQUALEl resultado de la función no es igual que el valor.
  • IS_GREATER_THANEl resultado de la función es mayor que el valor.
  • IS_GREATER_THAN_OR_EQUAL_TOEl resultado de la función es mayor o igual que el valor.
  • IS_LESS_THANEl resultado de la función es menor que el valor.
  • IS_LESS_THAN_OR_EQUAL_TOEl resultado de la función 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).

Más información sobre los operadores bitwise

Las opciones de barrera de función de Use Local Values son las siguientes:

  • TRUESe utilizarán valores locales. Esta es la opción predeterminada.
  • FALSESe utilizarán valores globales.
Value Table
traversability_scope
(Opcional)

Especifica el tipo de transitabilidad que se aplicará. El alcance de la transitabilidad determina si esta se aplica a los cruces, los ejes o en ambos. Por ejemplo, si se define que una condición de barrera detenga el seguimiento si Estado de dispositivo equivale a Abierto y el alcance de transitabilidad se establece solo en los ejes, el seguimiento 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 si debe ignorar los cruces, ejes o ambos.

  • BOTH_JUNCTIONS_AND_EDGESSe aplicará la transitabilidad tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • JUNCTIONS_ONLYSolo se aplicará la transitabilidad a los cruces.
  • EDGES_ONLYSolo se aplicará la transitabilidad a los ejes.
String
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Opcional)

Define cuándo se detendrá un trazado con una categoría o un atributo de red específicos. Por ejemplo, el trazado se detiene en las entidades que presentan un atributo de estado de ciclo igual a un determinado valor. Este parámetro se utiliza para definir un terminador basado en un valor de un atributo de red que está definido en el sistema. Si utiliza más de un atributo, puede usar la opción Combine Using para definir una condición Y u O.

Los componentes de barrera de filtro son los siguientes:

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

Las opciones de valor de barrera de filtro 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_INLCUDE_ANYUna operación bitwise AND en la que ninguno de los bits del valor está presente en el atributo (bitwise AND == False).

Más información sobre los operadores bitwise

Las opciones de valor de barrera de filtro de Type son las siguientes:

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

Las opciones de valor de barrera de filtro de Combine Using son las siguientes:

  • ANDCombinar las barreras de condición.
  • ORUsar si se cumple alguna de las barreras de condición.

Más información sobre el uso de varias expresiones condicionales

Value Table
filter_function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Opcional)

Filtra los resultados del rastreo para una categoría específica.

Los componentes de barrera de función de filtro son los siguientes:

  • Function: elija entre una variedad de funciones de cálculo.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Operator: elija entre una variedad de operadores.
  • Value: indique un valor específico para el tipo de atributo de entrada que, si se descubre, causará la finalización.
  • Use Local Values: calcule valores en todas las direcciones, en lugar de un valor global general. Por ejemplo, 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 habrá 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, o bien el trazado continúa.

Las opciones de valor Function de las funciones de barreras de filtro son las siguientes:

  • AVERAGESe calculará el promedio de los valores de entrada.
  • COUNTSe identificará el número de entidades.
  • MAXSe identificará el máximo de valores de entrada.
  • MINSe identificará el mínimo de valores de entrada.
  • ADDSe calculará la suma de los valores.
  • SUBTRACTSe calculará la diferencia entre los valores. Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Las opciones de valor Operator de las funciones de barreras de filtro 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).

Más información sobre los operadores bitwise

Las opciones Use Local Values de las funciones de barreras de filtro son las siguientes:

  • TRUESe utilizarán valores locales. Esta es la opción predeterminada.
  • FALSESe utilizarán valores globales.
Value Table
filter_scope
(Opcional)

Especifica si el filtro de una categoría específica se aplicará a los cruces, los ejes o ambos. Por ejemplo, si se define que una barrera de filtro 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 si debe ignorar los cruces, ejes o ambos.

  • BOTH_JUNCTIONS_AND_EDGESSe aplicará el filtro tanto a los cruces como a los ejes. Esta es la opción predeterminada.
  • JUNCTIONS_ONLYSolo se aplicará el filtro a los cruces.
  • EDGES_ONLYSolo se aplicará el filtro a los ejes.
String
filter_bitset_network_attribute_name
(Opcional)

El nombre del atributo de red que se usará para filtrar por conjunto de bits. Este parámetro solo es aplicable a los tipos de trazado de aguas arriba, aguas abajo y bucles. Este parámetro puede usarse para agregar una lógica especial durante un trazado, de modo que el trazado refleje más fielmente las situaciones reales. Por ejemplo, en un trazado de bucles, el atributo de red Fases actuales permite determinar si el bucle es un bucle eléctrico real (se alimenta la misma fase en todo el bucle, es decir, A) y devuelve solo los bucles eléctricos reales de los resultados del trazado de red. Un ejemplo de un trazado aguas arriba es que, durante el trazado de una red de distribución eléctrica, se especifica el atributo de red Fases actuales y el resultado del trazado solo contendrá las rutas válidas que se especifiquen en el atributo de red, no todas las rutas.

String
filter_nearest
(Opcional)

Especifica si el algoritmo k-vecinos más cercanos se usará para devolver un número de entidades de un tipo concreto dentro de una distancia determinada. Es posible proporcionar un recuento, un coste y una colección de categorías, además de un tipo de activos, o ambos.

  • FILTER_BY_NEARESTEl algoritmo k-vecinos más cercanos se utilizará para devolver el número de entidades especificado en el parámetro nearest_count, nearest_cost_network_attribute, nearest_categories o nearest_assets.
  • DO_NOT_FILTERNo se utilizará el algoritmo k-vecinos más cercanos para filtrar resultados. Esta es la opción predeterminada.
Boolean
nearest_count
(Opcional)

El número de entidades que se devolverán cuando filter_nearest se defina como FILTER_BY_NEAREST.

Long
nearest_cost_network_attribute
(Opcional)

El atributo de red numérico que se utilizará para calcular la cercanía, el coste o la distancia cuando filter_nearest esté definido como FILTER_BY_NEAREST, por ejemplo, shape length.

String
nearest_categories
[nearest_categories,...]
(Opcional)

Las categorías que se devolverán cuando filter_nearest esté definido como FILTER_BY_NEAREST, por ejemplo, protective.

String
nearest_assets
[nearest_assets,...]
(Opcional)

Los tipos y grupos de activos que se devolverán cuando filter_nearest esté definido como FILTER_BY_NEAREST, por ejemplo, ElectricDistributionDevice/Transformer/Step Down.

String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(Opcional)

La función o funciones de cálculo que se aplicarán al resultado del trazado de red.

Los componentes de funciones son los siguientes:

  • Function: elija entre una variedad de funciones de cálculo.
  • Attribute: filtre por cualquier atributo de red definido en el sistema.
  • Filter Name: filtre los resultados de la función por nombre de atributo.
  • Filter Operator: elija entre una variedad de operadores.
  • Filter Type: elija entre una variedad de tipos de filtros.
  • Filter Value: indique un valor específico para el atributo de filtro de entrada.

Las opciones de valor de funciones de Function son las siguientes:

  • AVERAGESe calculará el promedio de los valores de entrada.
  • COUNTSe identificará el número de entidades.
  • MAXSe identificará el máximo de valores de entrada.
  • MINSe identificará el mínimo de valores de entrada.
  • ADDSe calculará la suma de los valores.
  • SUBTRACTSe calculará la diferencia entre los valores.Ni los controladores de subred ni los tipos de trazado en bucle admiten la función de resta.

Por ejemplo, una entidad de punto de partida tiene un valor de 20. La siguiente entidad tiene el valor 30. Si está utilizando la función MINIMUM, el resultado es 20, MAXIMUM es 30, ADD es 50, AVERAGE es 25, COUNT es 2 y SUBTRACT es -10.

Las opciones de valor de Filter 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).

Más información sobre los operadores bitwise

Las opciones de valor de funciones de Filter Type son las siguientes:

  • SPECIFIC_VALUEFiltrar por un valor específico.
  • NETWORK_ATTRIBUTEFiltrar por un atributo de red.
Value Table
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.

Las opciones de valor de propagadores de Function son las siguientes:

  • PROPAGATED_BITWISE_ANDSe compararán los valores de una entidad con la siguiente.
  • PROPAGATED_MINSe identificará el valor mínimo.
  • PROPAGATED_MAXSe identificará el valor máximo.

Las opciones de valor de propagadores 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).

Más información sobre los operadores bitwise

Nota:

Este parámetro está disponible solo a para Python.

Value Table
output_assettypes
[output_assettypes,...]
(Opcional)

Filtra los tipos de activo de salida para su inclusión en el resultado, por ejemplo, devolver únicamente transformadores suspendidos.

String
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(Opcional)

Los tipos de entidades que se devolverán en función de una categoría o atributo de red. Por ejemplo, en un trazado configurado para excluir todo excepto las entidades Toma, las entidades procesadas por el trazado que no tengan asignada la categoría Toma no se incluyen en el resultado. Las entidades procesadas por el trazado que sí la tengan se devuelven en el conjunto de selección de resultado. Si utiliza más de un atributo, puede usar la opción Combine Using para definir una condición Y u O.

Los componentes de condiciones de salida son los siguientes:

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

Las opciones de valor de las condiciones de salida 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).

Más información sobre los operadores bitwise

Las opciones de valor de las condiciones de salida de Type son las siguientes:

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

Las opciones de valor de las condiciones de salida de Combine Using son las siguientes:

  • ANDCombinar las condiciones.
  • ORUsar si se cumple alguna de las condiciones.

Más información sobre el uso de varias expresiones condicionales

Value Table
include_isolated_features
(Opcional)

Especifica si las entidades aisladas se incluirán en los resultados del trazado. Este parámetro solo se utiliza al ejecutar un trazado de red de aislamiento.

  • INCLUDE_ISOLATED_FEATURESLas entidades aisladas se incluirán en los resultados del trazado.
  • EXCLUDE_ISOLATED_FEATURESLas entidades aisladas no se incluirán en los resultados del trazado. Esta es la opción predeterminada.
Nota:

El tipo de trazado de aislamiento requiere ArcGIS Enterprise 10.7 o posterior si se utiliza una geodatabase corporativa.

Boolean
ignore_barriers_at_starting_points
(Opcional)

Especifica si las barreras dinámicas de la configuración de trazado se ignorarán en los puntos de partida. Puede resultar útil al realizar un trazado de un dispositivo de protección aguas arriba y al utilizar los dispositivos de protección descubiertos (barreras) como puntos de partida para buscar dispositivos de protección aguas arriba posteriores.

  • IGNORE_BARRIERS_AT_STARTING_POINTSLas barreras de los puntos de partida se ignorarán en el trazado.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTSLas barreras de los puntos de partida no se ignorarán en el trazado. Esta es la opción predeterminada.
Boolean
include_up_to_first_spatial_container
(Opcional)

Especifica si los contenedores devueltos se limitarán a solo los encontrados hasta el primer contenedor espacial (este incluido) para cada elemento de red en los resultados de trazado. Si no se encontraran contenedores espaciales sino contenedores no espaciales para un elemento de red determinado, todos los contenedores no espaciales se incluirán en los resultados. Este parámetro solo es aplicable si include_containers está definido como INCLUDE_CONTAINERS.

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINEREn los resultados se incluirán los contenedores encontrados solamente hasta el primer contenedor espacial, incluido este, cuando se encuentran asociaciones de contención anidadas a lo largo de la ruta del trazado. Si no existen contenedores espaciales, todos los contenedores no espaciales se incluirán en los resultados para un elemento de red determinado.
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERTodos los contenedores se devolverán en los resultados. Esta es la opción predeterminada.
Boolean
result_types
[result_types,...]
(Opcional)

Especifica el tipo de resultados que devolverá el trazado.

  • SELECTIONLos resultados del trazado se devolverán como una selección definida en las entidades de red adecuadas. Esta es la opción predeterminada.
  • AGGREGATED_GEOMETRYLos resultados del trazado se agregarán por tipo de geometría y se almacenarán en clases de entidad multiparte que se muestran en las capas en el mapa activo.
  • CONNECTIVITYLos resultados del trazado de red se devolverán como un gráfico de conectividad en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita el parámetro out_json_file.
  • ELEMENTSLos resultados del trazado de red se devolverán como información basada en entidades en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita el parámetro out_json_file.
  • FEATURESLos resultados del trazado de red se devuelven como información basada en entidades en un archivo .json de salida especificado para las entidades de red recorridas. Esta opción habilita los parámetros include_geometry, include_domain_description, result_network_attributes, result_fields y out_json_file.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSLos resultados del trazado devuelven información de asociación para las entidades de red recorridas que están asociadas mediante asociaciones de contención y adjunto estructural en un archivo .json de salida especificado. Esta opción habilita los parámetros include_domain_description y out_json_file.
String
selection_type

Especifica cómo se aplicará la selección y qué hacer si existe una selección actual.

  • NEW_SELECTIONLa selección resultante reemplazará a la selección actual. Esta es la opción predeterminada.
  • ADD_TO_SELECTIONLa selección resultante se agregará a la selección actual, si la hay. Si no existe ninguna selección, coincide con la opción de nueva selección.
  • REMOVE_FROM_SELECTIONLa selección resultante se quitará de la selección actual. Si no existe ninguna selección, esta opción no tendrá efecto.
  • SUBSET_SELECTIONLa selección resultante se combinará con la selección actual. Solo permanecen seleccionados los registros comunes a ambas selecciones.
  • SWITCH_SELECTIONLa selección resultante se conmutará. Los resultados seleccionados se quitan de la selección actual; los resultados no seleccionados se agregan a la selección actual. Si no existe ninguna selección, coincide con la opción de nueva selección.
String
clear_all_previous_trace_results
(Opcional)

Especifica si el contenido se truncará o se incorporará a las clases de entidad elegidas para almacenar geometría agregada. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • CLEAR_ALL_PREVIOUS_TRACE_RESULTSLas clases de entidad que almacenan geometría agregada de trazado se truncarán. Solo se escribirá la geometría de salida de la operación de trazado actual. Esta es la opción predeterminada.
  • DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTSLa geometría de salida de la operación de trazado actual se incorporará a las clases de entidad que almacenen geometría agregada.
Boolean
trace_name
(Opcional)

El nombre de la operación de trazado. Este valor se almacena en el campo TRACENAME de la clase de entidad de salida para ayudar a identificar los resultados del trazado de red. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

String
aggregated_points
(Opcional)

Una clase de entidad multipunto de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad multipunto y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
aggregated_lines
(Opcional)

Una clase de entidad de polilínea de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Lines que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polilínea y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
aggregated_polygons
(Opcional)

Una clase de entidad de polígono de salida que contiene la geometría de resultados agregada. De forma predeterminada, el parámetro se rellena con una clase de entidad generada por el sistema denominada Trace_Results_Aggregated_Points que se almacenará en la geodatabase predeterminada del proyecto.

Esta clase de entidad se creará automáticamente si no existe ya. También es posible utilizar una clase de entidad existente para almacenar geometría agregada. Si se utiliza otra clase de entidad que no es la predeterminada, debe ser una clase de entidad de polígono y contener un campo de cadena de caracteres llamado TRACENAME. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

Feature Class
allow_indeterminate_flow
(Opcional)

Especifica si se realizará un trazado de las entidades con flujo indeterminado. Este parámetro solo es aplicable al ejecutar un trazado aguas arriba, aguas abajo o de aislamiento.

  • TRACE_INDETERMINATE_FLOWSe realizará un trazado de las entidades con flujo indeterminado. Esta es la opción predeterminada.
  • IGNORE_INDETERMINATE_FLOWSe detendrá la transitabilidad de las entidades con flujo indeterminado y no se realizará su trazado.
Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 5 o posterior.

Boolean
validate_locatability
(Opcional)

Especifica si se devolverá un error durante un trazado de red 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. Este parámetro 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.

  • VALIDATE_LOCATABILITYEl trazado devolverá un error 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.
  • DO_NOT_VALIDATE_LOCATABILITYEl trazado de red no comprobará si hay objetos que no se pueden localizar y devolverá resultados independientemente de si se encuentran objetos que no se pueden localizar en la jerarquía de asociación de los objetos trazados. Esta es la opción predeterminada.
Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 4 o posterior.

Boolean
use_trace_config
(Opcional)

Especifica si se utilizará una configuración de trazado de red nominal existente para rellenar los parámetros de esta herramienta.

  • USE_TRACE_CONFIGURATIONSe utilizará una configuración de trazado de red nominal existente para definir las propiedades del trazado. Se ignorarán todos los parámetros excepto trace_config_name, starting_points y barriers.
  • DO_NOT_USE_TRACE_CONFIGURATIONNo se utilizará ninguna configuración de trazado de red nominal existente para definir las propiedades del trazado. Esta es la opción predeterminada.
Nota:

Este parámetro requiere que el valor de Versión de red de servicios sea 5 o posterior.

Boolean
trace_config_name
(Opcional)

El nombre de la configuración de trazado de red nominal que se utilizará para definir las propiedades del trazado. Este parámetro solo está habilitado cuando el parámetro use_trace_config tiene el valor USE_TRACE_CONFIGURATION.

String
out_json_file
(Opcional)

El nombre y la ubicación del archivo .json que se generarán al devolver resultados del trazado con los tipos de resultados de conectividad, elementos, entidades o asociaciones de contención y adjunto.

File
run_async
(Opcional)

Especifica si las operaciones de seguimiento se procesarán de forma asíncrona cuando se trabaje con una red de servicios públicos en una geodatabase corporativa.

  • RUN_ASYNCHRONOUSLYLas operaciones de seguimiento se procesarán de forma asíncrona
  • RUN_SYNCHRONOUSLYLas operaciones de seguimiento se procesarán de forma síncrona Esta es la opción predeterminada.
Nota:
Este parámetro requiere ArcGIS Enterprise 10.9.1 o versiones posteriores.
Boolean
include_geometry
(Opcional)

Especifica si se incluirá la geometría en los resultados.

  • INCLUDE_GEOMETRYLa geometría se incluirá en los resultados.
  • EXCLUDE_GEOMETRYLa geometría no se incluirá en los resultados. Esta es la opción predeterminada.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Boolean
include_domain_descriptions
(Opcional)

Especifica si las descripciones de dominio se incluirán en el archivo .json para comunicar la asignación de dominio de controladores, featureElements, conectividad y asociaciones.

  • INCLUDE_DOMAIN_DESCRIPTIONSLas descripciones de domino se incluirán en los resultados.
  • EXCLUDE_DOMAIN_DESCRIPTIONSLas descripciones de domino no se incluirán en los resultados. Esta es la opción predeterminada.
Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Boolean
result_network_attributes
[result_network_attributes,...]
(Opcional)

Los atributos de red que se incluirán en los resultados.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

String
result_fields
[[Feature Class, Field Name],...]
(Opcional)

Los campos de una clase de entidad que se devolverán como resultados. Los valores del campo se devolverán en los resultados de las entidades del trazado.

Nota:

Para geodatabases corporativas, este parámetro requiere ArcGIS Enterprise 11.1 o posterior.

Value Table
use_digitized_direction
(Opcional)

Especifica si las operaciones de trazado ascendentes y descendentes determinarán la dirección del flujo utilizando la dirección digitalizada de la línea, el Id. global De y A del objeto de eje en la asociación y el atributo Flow direction. Este parámetro solo está disponible y activo a partir de la versión 7 de Utility Network cuando el parámetro trace_type se configura en UPSTREAM o DOWNSTREAM.

  • USE_DIGITIZED_DIRECTIONLas operaciones de trazado determinarán la dirección del flujo utilizando la dirección digitalizada de la línea, el Id. global De y A del objeto de eje en la asociación y el atributo de dirección del flujo. Con esta opción, los parámetros domain_network, tier y target_tier se ignoran.
  • IGNORE_DIGITIZED_DIRECTIONLas opciones de trazado determinarán la dirección del flujo en función de la ubicación de los controladores de subred. Esta es la opción predeterminada.
Nota:
Este parámetro requiere ArcGIS Enterprise 11.3 o posterior si se utiliza una geodatabase corporativa.
Boolean
synthesize_geometries
(Opcional)

Especifica si se inferirán y crearán (sintetizarán) geometrías para asociaciones y objetos de eje de trazado poligonal como parte de una operación de trazado. Este parámetro solo se aplica al tipo de resultado de geometría agregada.

  • DO_NOT_SYNTHESIZE_GEOMETRIESLas geometrías no se sintetizarán para las asociaciones de trazado poligonal y los objetos de eje. Esta es la opción predeterminada.
  • SYNTHESIZE_GEOMETRIESSe inferirán y crearán geometrías para las asociaciones de trazado poligonal y los objetos de eje en la clase de entidad de salida Trace_Results_Aggregated_Lines.

Nota:
Este parámetro requiere ArcGIS Enterprise 11.3 o posterior si se utiliza una geodatabase corporativa.

Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

La red de servicios actualizada.

Utility Network

Muestra de código

Ejemplo de Trace (script independiente)

Ejecuta un rastreo aguas abajo en una red de distribución eléctrica en el nivel de media tensión, lo que suma la carga del transformador de las fases A, B y C.

'''****************************************************************************
Name:        DownstreamTrace.py
Description: This script executes a downstream trace on the Medium Voltage tier 
             that adds up the transformer load on phases A, B, and C.
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "NapervilleElectric Utility Network"
trace_type = "DOWNSTREAM"
starting_points = "C:\\MyProject\\Bissell.gdb\UN_Temp_Starting_Points"
barriers = "C:\\MyProject\\Bissell.gdb\UN_Temp_Barriers"
domain_network = "ElectricDistribution"
tier = "Medium Voltage Radial"
include_containers = "INCLUDE_CONTAINERS"
include_content ="INCLUDE_CONTENT"
include_structures = "INCLUDE_STRUCTURES"
include_barriers ="INCLUDE_BARRIERS"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
propagators = "'Phases Current' phasessub PROPAGATED_BITWISE_AND INCLUDES_ANY 15"
functions = "ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 4;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 2;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 1"
synthesize_geometries = "SYNTHESIZE_GEOMETRIES"

# Run Trace with specified parameters and leave the rest default
arcpy.un.Trace(in_utility_network, 
               trace_type, 
               starting_points, 
               barriers, 
               domain_network, 
               tier,
               include_containers=include_containers,
               include_content=include_content,
               include_structures=include_structures,
               condition_barriers=condition_barriers,
               propagators=propagators,
               functions=functions,
               synthesize_geometries=synthesize_geometries)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados