Agrupar por proximidad (Geoanálisis)

Resumen

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

Heredado:

La extensión de ArcGIS GeoAnalytics Server quedará obsoleta en ArcGIS Enterprise. La versión final de GeoAnalytics Server se incluyó con ArcGIS Enterprise 11.3. Esta herramienta de geoprocesamiento está disponible a través de ArcGIS Enterprise 11.3 y versiones anteriores.

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

• Esta herramienta de geoprocesamiento está disponible con ArcGIS Enterprise 10.9.1 o posterior.

• 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.

• 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 ArcGIS GeoAnalytics Server. El análisis se completa en GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

• Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

  Más información acerca del uso compartido de datos en el portal

  Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

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 Set
Nombre de salida	El nombre del servicio de entidades de salida con entidades agrupadas representadas por un nuevo campo group_id.	String
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
Data store (Opcional)	Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas. Big data store espaciotemporal—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada. Data store relacional—La salida se almacenará en un data store relacional.	String
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

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capa de entidades de salida	Una nueva clase de entidad con entidades agrupadas representadas por un nuevo campo denominado group_id.	Feature Set

Python

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store}, {attribute_relationship})

Nombre	Explicación	Tipo de datos
input_layer	Las entidades de punto, línea o polígono que se agruparán.	Feature Set
output_name	El nombre del servicio de entidades de salida con entidades agrupadas representadas por un nuevo campo group_id.	String
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
data_store (Opcional)	Especifica el ArcGIS Data Store donde se almacenará la salida. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas. SPATIOTEMPORAL_DATA_STORE—La salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada. RELATIONAL_DATA_STORE—La salida se almacenará en un data store relacional.	String
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

Salida derivada

Nombre	Explicación	Tipo de datos
output	Una nueva clase de entidad con entidades agrupadas representadas por un nuevo campo denominado group_id.	Feature Set

Muestra de código

Ejemplo de GroupByProximity (script 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: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/roads"
outFS = "groupedRoads"
overlayType = "TOUCHES"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Group By Proximity
result = arcpy.geoanalytics.GroupByProximity(inFeatures, outFS, 
                                 overlayType, data_store=dataStore)

Entornos

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual

Casos especiales

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. En GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

• Basic: Requiere ArcGIS GeoAnalytics Server
• Standard: Requiere ArcGIS GeoAnalytics Server
• Advanced: Requiere ArcGIS GeoAnalytics Server