Agrupar por proximidad (Geoanálisis)

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

Ilustración de la herramienta Agrupar por proximidad

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.IntersecaTocaCercanía geodésicaCercanía planar

    Punto

    Marca de verificaciónMarca de verificaciónMarca de verificación

    Polilínea

    Marca de verificaciónMarca de verificaciónMarca de verificaciónMarca de verificación

    Polígono

    Marca de verificaciónMarca de verificaciónMarca de verificaciónMarca de verificación

    Método de superposiciónDescripció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 entradaIntersecaCerca

    Ninguna

    Instante

    Marca de verificaciónMarca de verificación

    Intervalo

    Marca de verificaciónMarca de verificación

    Método de relación temporalDescripció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 su 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 su 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

EtiquetaExplicaciónTipo 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.

El nombre del servicio de entidades de salida con entidades agrupadas representadas por un nuevo campo denominado group_id

String
Relación espacial

Especifica el tipo de relación por la que se agruparán las entidades.

  • IntersecaLas entidades se agruparán cuando las entidades o partes de las mismas se superpongan. Esta es la opción predeterminada.
  • TocaLas entidades se agruparán con otra entidad si tienen un vértice que se interseca, pero las entidades no se superponen.
  • Cercanía planarLas entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia planar determinada de otra entidad.
  • Cercanía geodésicaLas 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.

  • IntersecaLas entidades se agruparán cuando cualquier parte del tiempo de una entidad se superponga a otra entidad. Esta es la opción predeterminada.
  • CercaLas entidades se agruparán cuando el tiempo de la entidad esté dentro de un rango de tiempo de otra entidad.
  • NingunaEl 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 en el que se guardará la salida. Por defecto es big data store espaciotemporal. 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 espaciotemporalLa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • Data store relacionalLa 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

EtiquetaExplicaciónTipo 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

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store}, {attribute_relationship})
NombreExplicaciónTipo 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.

El nombre del servicio de entidades de salida con entidades agrupadas representadas por un nuevo campo denominado group_id

String
spatial_relationship

Especifica el tipo de relación por la que se agruparán las entidades.

  • INTERSECTSLas entidades se agruparán cuando las entidades o partes de las mismas se superpongan. Esta es la opción predeterminada.
  • TOUCHESLas entidades se agruparán con otra entidad si tienen un vértice que se interseca, pero las entidades no se superponen.
  • NEAR_PLANARLas entidades se agruparán cuando un vértice o eje se encuentre dentro de una distancia planar determinada de otra entidad.
  • NEAR_GEODESICLas 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.

  • INTERSECTSLas entidades se agruparán cuando cualquier parte del tiempo de una entidad se superponga a otra entidad. Esta es la opción predeterminada.
  • NEARLas entidades se agruparán cuando el tiempo de la entidad esté dentro de un rango de tiempo de otra entidad.
  • NONEEl 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 en el que se guardará la salida. El valor predeterminado es SPATIOTEMPORAL_DATA_STORE. 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_STORELa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • RELATIONAL_DATA_STORELa 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

NombreExplicaciónTipo 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

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

Temas relacionados