Agrupar por proximidad (GeoAnalytics Desktop)

Resumen

Agrupa entidades que se encuentran en proximidad espacial o espaciotemporal entre sí.

Los siguientes son ejemplos de preguntas que pueden ser respondidas por los flujos de trabajo de Agrupar por proximidad:

• ¿Qué vías están conectadas?
• ¿Dónde hay grupos de delitos ocurridos a una distancia y tiempo cercanos entre sí?
• ¿Hay grupos de polígonos que se superponen entre sí?

Ilustración

Uso

• El resultado de salida es una copia de la entrada con un nuevo campo llamado group_id. El campo group_id representa la agrupación de entidades. Las entidades con el mismo valor de group_id están en el mismo grupo. Los números de grupo representan la pertenencia a un grupo en particular y no implican valor. Es posible que los números de grupo no sean secuenciales o el mismo número en el uso repetido de la herramienta. Los resultados se simbolizarán con ocho grupos. Si hay más de ocho grupos en el resultado, todos los grupos se simbolizarán con ocho colores de forma predeterminada. Puede modificar la simbología para mostrar cada grupo único simbolizando con símbolos únicos en el campo group_id.

• La herramienta admite las siguientes combinaciones de relaciones:

  • Una relación espacial
  • Una relación espacial y una relación temporal
  • Una relación espacial y una relación de atributos
  • Una relación espacial, una relación temporal y una relación de atributos
  Las entidades se agrupan cuando se cumplen todas las relaciones especificadas.

• Las relaciones espaciales y las geometrías de entrada compatibles se describen en la siguiente tabla:

  Tipo de geometría de entrada.	Interseca	Toca	Cercanía geodésica	Cercanía planar
  Punto
  Polilínea
  Polígono

  Método de superposición	Descripción
  Interseca	Las entidades intersecan cuando las entidades o partes de las mismas se superponen. Esta es la opción predeterminada.
  Toca	Las entidades tocan otra entidad si tienen un vértice que se interseca, pero las entidades no se superponen.
  Cercanía geodésica	Las entidades están cerca si un vértice o eje se encuentra dentro de una distancia geodésica determinada de otra entidad.
  Cercanía planar	Las entidades están cerca si un vértice o eje se encuentra dentro de una distancia planar determinada de otra entidad.

• Para utilizar la opción Planar cercano del parámetro Relación espacial, el valor del parámetro Capa de entrada debe proyectarse o el sistema de coordenadas de salida se establece como un sistema de coordenadas proyectadas.

• Los tipos de tiempo y las relaciones temporales admitidas se describen en la siguiente tabla:

  Tipo temporal de entrada	Interseca	Cerca
  Ninguna
  Instante
  Intervalo

  Método de relación temporal	Descripción
  Interseca	Las entidades intersecan cuando cualquier parte del tiempo de una entidad se superpone a otra.
  Cerca	Las entidades están cerca unas de otras si el tiempo de una entidad está dentro de una distancia temporal determinada de otra entidad.

• Para utilizar una relación temporal, debe habilitar el tiempo en la entrada. Puede habilitar el tiempo haciendo lo siguiente:

  • Habilite el tiempo en una entrada de conexión de entidades multiarchivo (MFC).
  • Habilite el tiempo en una capa del mapa. Si lo desea, puede guardar la capa con la función de tiempo habilitada como un archivo .lyrx.

• Las expresiones de atributos son una operación simétrica. La herramienta toma una sola capa de entrada que se compara con ella misma durante la agrupación. Por ello, la capa de entrada se indica como a y b en la expresión ArcGIS Arcade, y todas las expresiones deben incluir a y b. Por ejemplo, para agrupar todos los registros cuando el campo Amount tenga el mismo valor, utilice la siguiente expresión: $a["Amount"] == $b["Amount"].

• Puede mejorar el rendimiento de la herramienta Agrupar por proximidad realizando una o varias de las siguientes acciones:

  • Defina el entorno de extensión para analizar únicamente datos de interés.
  • Cuando utilice la opción Cercanía planar o Cercanía geodésica del parámetro Relación espacial, utilice un valor más pequeño para el parámetro de Distancia de cercanía espacial.
  • Cuando utilice el parámetro Relación espacial, la opción Cercanía planar es más rápida que la opción Cercanía geodésica.
  • Cuando utilice la opción Cerca del parámetro Relación espacial, utilice un valor más pequeño para el parámetro Distancia de cercanía temporal.
  • Utilice datos locales en los que se ejecute el análisis.

• Esta herramienta de geoprocesamiento se basa en Spark. El análisis se completa en su equipo de escritorio utilizando varios núcleos en paralelo. Consulte Consideraciones acerca de las herramientas de GeoAnalytics Desktop para obtener más información acerca de la ejecución de análisis.

• Al ejecutar herramientas de GeoAnalytics Desktop, el análisis se completa en su equipo de escritorio. Para un rendimiento óptimo, los datos deben estar disponibles en su escritorio. Si utiliza una capa de entidades alojada, se recomienda utilizar ArcGIS GeoAnalytics Server. Si sus datos no están almacenados localmente, se tardará más tiempo en ejecutar una herramienta. Para utilizar su ArcGIS GeoAnalytics Server para realizar un análisis, consulte GeoAnalytics Tools.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Capa de entrada	Las entidades de punto, línea o polígono que se agruparán.	Feature Layer
Salida	La clase de entidad de salida con entidades agrupadas representadas por un nuevo campo denominado group_id.	Feature Class
Relación espacial	Especifica el tipo de relación por la que se agruparán las entidades. Interseca—Las entidades se agruparán cuando las entidades o partes de las mismas se superpongan. Esta es la opción predeterminada. Toca—Las entidades se agruparán con otra entidad si tienen un vértice que se interseca, pero las entidades no se superponen. Cercanía planar—Las entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia planar determinada de otra entidad. Cercanía geodésica—Las entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia geodésica determinada de otra entidad.	String
Distancia de cercanía espacial (Opcional)	La distancia que se utilizará para agrupar entidades cercanas. Este parámetro solo se utiliza cuando el valor del parámetro Relación espacial es Cercanía planar o Cercanía geodésica.	Linear Unit
Relación temporal (Opcional)	Especifica los criterios de hora que se utilizarán para hacer coincidir las entidades. Cuando el parámetro se establece en Interseca o Cerca, las entidades se agrupan cuando se cumplen los criterios espaciales y temporales. El tiempo debe estar habilitado en la entrada para admitir esta opción. Interseca—Las entidades se agruparán cuando cualquier parte del tiempo de una entidad se superponga a otra entidad. Esta es la opción predeterminada. Cerca—Las entidades se agruparán cuando el tiempo de la entidad esté dentro de un rango de tiempo de otra entidad. Ninguna—El tiempo no se utilizará para agrupar entidades.	String
Distancia de cercanía temporal (Opcional)	La distancia temporal que se utilizará para agrupar entidades cercanas. Este parámetro solo se utiliza cuando el valor del parámetro Relación temporal es Cerca.	Time Unit
Relación de atributos (Opcional)	Una expresión de ArcGIS Arcade que se usará para agrupar entidades. Por ejemplo, $a["Amount"] == $b["Amount"] agrupa las entidades cuando el campo Amount tiene el mismo valor.	String

Python

arcpy.gapro.GroupByProximity(input_layer, output, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship})

Nombre	Explicación	Tipo de datos
input_layer	Las entidades de punto, línea o polígono que se agruparán.	Feature Layer
output	La clase de entidad de salida con entidades agrupadas representadas por un nuevo campo denominado group_id.	Feature Class
spatial_relationship	Especifica el tipo de relación por la que se agruparán las entidades. INTERSECTS—Las entidades se agruparán cuando las entidades o partes de las mismas se superpongan. Esta es la opción predeterminada. TOUCHES—Las entidades se agruparán con otra entidad si tienen un vértice que se interseca, pero las entidades no se superponen. NEAR_PLANAR—Las entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia planar determinada de otra entidad. NEAR_GEODESIC—Las entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia geodésica determinada de otra entidad.	String
spatial_near_distance (Opcional)	La distancia que se utilizará para agrupar entidades cercanas. Este parámetro solo se utiliza cuando el valor del parámetro spatial_relationship es NEAR_PLANAR o NEAR_GEODESIC.	Linear Unit
temporal_relationship (Opcional)	Especifica los criterios de hora que se utilizarán para hacer coincidir las entidades. Cuando el parámetro se establece en INTERSECTS o NEAR, las entidades se agrupan cuando se cumplen los criterios espaciales y temporales. El tiempo debe estar habilitado en la entrada para admitir esta opción. INTERSECTS—Las entidades se agruparán cuando cualquier parte del tiempo de una entidad se superponga a otra entidad. Esta es la opción predeterminada. NEAR—Las entidades se agruparán cuando el tiempo de la entidad esté dentro de un rango de tiempo de otra entidad. NONE—El tiempo no se utilizará para agrupar entidades.	String
temporal_near_distance (Opcional)	La distancia temporal que se utilizará para agrupar entidades cercanas. Este parámetro solo se utiliza cuando el valor del parámetro temporal_relationship es Near.	Time Unit
attribute_relationship (Opcional)	Una expresión de ArcGIS Arcade que se usará para agrupar entidades. Por ejemplo, $a["Amount"] == $b["Amount"] agrupa las entidades cuando el campo Amount tiene el mismo valor.	String

Muestra de código

Ejemplo de GroupByProximity (secuencia de comandos independiente)

El siguiente script de la ventana de Python muestra cómo utilizar la función GroupByProximity.

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: An advanced license

# Import system modules
import arcpy

# Set local variables
inFeatures = "C:\myData\cities.gdb\roads"
outname = "groupedRoads"
overlayType = "TOUCHES"

# Run Group By Proximity
result = arcpy.gapro.GroupByProximity(inFeatures, outname, overlayType)

Entornos

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual, Factor de procesamiento en paralelo

Información de licenciamiento

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