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

Ilustración de la herramienta Agrupar por proximidad

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

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

  • 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

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

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

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

  • 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
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 (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: 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)