Agregar regla de consulta espacial (Diagrama de red)

Resumen

Agrega una regla de diagrama que incorpora automáticamente nuevas entidades de red a los diagramas en función de su ubicación relativa a las entidades de red representadas actualmente en el diagrama.

Más información sobre el uso de reglas de consulta espacial para crear diagramas de red

Precaución:

Esta herramienta es una herramienta de configuración y administración.

Nota:

Esta herramienta afecta a la coherencia de cualquier diagrama existente basado en la plantilla de diagrama de entrada. Todos los diagramas existentes se vuelven incoherentes y permanecen abiertos con un icono de advertencia de coherencia Diagrama para actualizar hasta que se actualicen.

Uso

  • Esta herramienta no se admite al trabajar con un servicio de red de servicios o red de trazado. Debe utilizar una red de servicios o red de trazado de una geodatabase de archivos o móvil o una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa. Al trabajar con una geodatabase corporativa, existen estos requisitos:

  • La regla Consulta espacial se utiliza para detectar nuevas entidades de red en función de su ubicación relativa a entidades de red que existen actualmente en el diagrama e incorpora las entidades recién detectadas al diagrama de red.

  • Las entidades de red con las que funciona la regla se basan en la misma clase de entidad y esas entidades se pueden filtrar mediante el uso de una expresión de consulta SQL.

  • Las entidades de red incorporadas se basan en la misma clase de entidad y esas entidades se pueden filtrar mediante el uso de una expresión de consulta SQL.

Parámetros

EtiquetaExplicaciónTipo de datos
Red de entrada

La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.

Utility Network; Trace Network
Plantilla de diagrama de entrada

El nombre de la plantilla de diagrama que se modificará.

String
Activo

Especifica si la regla estará activa al generar y actualizar diagramas basándose en la plantilla especificada.

  • Activado: la regla agregada estará activa durante la generación y la actualización de cualquier diagrama basado en la plantilla de entrada. Esta es la opción predeterminada.
  • Desactivado: la regla agregada no estará activa durante la generación ni la actualización de cualquier diagrama basado en la plantilla de entrada.

Boolean
Añadir entidades

Clase de entidad de origen a la que se agregarán las entidades.

Feature Class
Relación
(Opcional)

Especifica la relación espacial entre las entidades.

  • IntersecarLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si se intersecan con una de las Entidades existentes. Esta es la opción predeterminada.
  • Dentro de una distanciaLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si se encuentran dentro de la distancia especificada (usando la distancia euclidiana) de una de las Entidades existentes. Use el parámetro Distancia de búsqueda para especificar la distancia.
  • Contiene | Está contenida enLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si contienen entidades de origen o están contenidas en Entidades existentes.
  • Dentro deLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si están dentro de las Entidades existentes.
  • Toca el límiteLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si tienen un límite que toca una de las Entidades existentes. Si las Entidades existentes son líneas o polígonos, el límite de la entidad de entrada Agregar entidades solo puede tocar el límite de una de las Entidades existentes, y ninguna parte de la entidad de entrada puede cruzar el límite de ninguna de las Entidades existentes.
  • Comparten un segmento de línea conLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si comparten un segmento de línea con una de las Entidades existentes. Las entidades agregadas y existentes deben ser de línea o polígono.
  • Cruzado por el contorno deLas entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si las cruza el contorno de una de las Entidades existentes. Las entidades agregadas y existentes deben ser líneas o polígonos. Si se utilizan polígonos para las Entidades existentes, se usará el límite (línea) del polígono. Se incorporarán las líneas que se crucen en un punto, pero no las que compartan un segmento de línea.
String
Entidades existentes

La clase de entidad de origen en la que se ejecutará la consulta espacial.

Feature Class
Distancia de búsqueda
(Opcional)

La distancia entre entidades se indica en el parámetro Entidades existentes y las entidades en el parámetro Agregar entidades. Este parámetro solo es válido si el parámetro Relación está establecido en Intersecar, Dentro de una distancia, Contiene o Dentro de.

Linear Unit
Definición de consulta de entidades agregadas
(Opcional)

La consulta SQL que se utilizará para filtrar las entidades que se agregarán al diagrama. Sin una consulta SQL, las entidades basadas en la clase de fuente especificada que están relacionadas espacialmente con las entidades existentes especificadas se incorporarán al diagrama.

SQL Expression
Definición de consulta de entidades existentes
(Opcional)

La consulta SQL que se utilizará para filtrar las entidades presentes en el diagrama. Sin una consulta SQL, se tendrán en cuenta las entidades basadas en la clase de fuente especificada que está presente en el diagrama.

SQL Expression
Descripción
(Opcional)

La descripción de la regla.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Red de salida

Red de servicios o red de trazado actualizada.

Utility Network; Trace Network
Plantilla de diagrama de salida

El nombre de la plantilla de diagrama.

String

arcpy.nd.AddSpatialQueryRule(in_utility_network, template_name, is_active, added_features, {overlap_type}, existing_features, {search_distance}, {added_where_clause}, {existing_where_clause}, {description})
NombreExplicaciónTipo de datos
in_utility_network

La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.

Utility Network; Trace Network
template_name

El nombre de la plantilla de diagrama que se modificará.

String
is_active

Especifica si la regla estará habilitada al generar y actualizar diagramas basándose en la plantilla especificada.

  • ACTIVELa regla agregada se habilitará durante la generación y la actualización de cualquier diagrama basado en la plantilla de entrada. Esta es la opción predeterminada.
  • INACTIVELa regla agregada no estará habilitada durante la generación ni la actualización de cualquier diagrama basado en la plantilla de entrada.
Boolean
added_features

Clase de entidad de origen a la que se agregarán las entidades.

Feature Class
overlap_type
(Opcional)

Especifica la relación espacial que se evaluará.

  • INTERSECTLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se intersecan con una de las existing_features. Esta es la opción predeterminada.
  • WITHIN_A_DISTANCELas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se encuentran dentro de la distancia especificada (usando la distancia euclidiana) de una de las existing_features. Utilice el parámetro search_distance para especificar la distancia.
  • CONTAINSLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si contienen entidades de existing_features o están contenidas en ellas.
  • WITHINLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se encuentran dentro de las existing_features.
  • BOUNDARY_TOUCHESLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si tienen un límite que toca una de las existing_features. Si las existing_features son líneas o polígonos, el límite de las added_features solo puede tocar el límite de una de las existing_features, y ninguna parte de la entidad de entrada puede cruzar el límite de ninguna de las existing_features.
  • SHARE_A_LINE_SEGMENT_WITHLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si comparten un segmento de línea con una de las existing_features. Las entidades agregadas y existentes deben ser de línea o polígono.
  • CROSSED_BY_THE_OUTLINE_OFLas entidades de la clase de entidad de origen added_features se incorporarán al diagrama si las cruza el contorno de una de las existing_features. Las entidades agregadas y existentes deben ser líneas o polígonos. Si se utilizan polígonos para las existing_features, se usará el límite (línea) del polígono. Se incorporarán las líneas que se crucen en un punto, pero no las que compartan un segmento de línea.
String
existing_features

La clase de entidad de origen en la que se ejecutará la consulta espacial.

Feature Class
search_distance
(Opcional)

La distancia entre entidades del parámetro existing_features y las entidades del parámetro added_features. Este parámetro solo es válido si el parámetro overlap_type está establecido en INTERSECT, WITHIN_A_DISTANCE, CONTAINS o WITHIN.

Linear Unit
added_where_clause
(Opcional)

La consulta SQL que se utilizará para filtrar las entidades que se agregarán al diagrama. Sin una consulta SQL, las entidades basadas en la clase de fuente especificada que están relacionadas espacialmente con las entidades existentes especificadas se incorporarán al diagrama.

SQL Expression
existing_where_clause
(Opcional)

La consulta SQL que se utilizará para filtrar las entidades presentes en el diagrama. Sin una consulta SQL, se tendrán en cuenta las entidades basadas en la clase de fuente especificada que está presente en el diagrama.

SQL Expression
description
(Opcional)

La descripción de la regla.

String

Salida derivada

NombreExplicaciónTipo de datos
out_utility_network

Red de servicios o red de trazado actualizada.

Utility Network; Trace Network
out_template_name

El nombre de la plantilla de diagrama.

String

Muestra de código

Ejemplo de AddSpatialQueryRule (script independiente)

Agregar una regla de consulta espacial a la plantilla MyTemplate1 para agregar sistemáticamente todas las líneas de subtransporte que intersecan subestaciones en los diagramas generados.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionLine = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionLine"
input_StructureBoundary = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricStructureBoundary"

input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddSpatialQueryRule(input_Network, input_DiagramTemplate, 
                             'ACTIVE', input_DistributionLine, 'INTERSECT',
                             input_StructureBoundary, None, 'ASSETGROUP=6', 
                             'ASSETGROUP=3')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Temas relacionados