Consolidar puntos (Geoanálisis)

Resumen

Consolida puntos en entidades poligonales o bins. Se devuelve un polígono con un recuento de puntos, así como estadísticas opcionales, en todas las ubicaciones en las que existan puntos.

Más información sobre cómo funcionan los periodos de tiempo

Ilustración

Herramienta Consolidar puntos
Se muestran ejemplos de consolidar puntos en polígonos (primera fila), puntos con el tiempo habilitado en polígonos con periodos de tiempo (segunda fila), puntos en bins (tercera fila) y puntos en bins con periodos de tiempo (cuarta fila).

Uso

  • Estas son dos posibles formas de especificar las áreas en las que se consolidarán los puntos:

    • Usar una capa de polígonos.
    • Usar un bin cuadrado o hexagonal de un tamaño especificado que se genere al ejecutar el análisis.

    Puede proporcionar la capa de área que se va a utilizar para el análisis o puede generar bins de un tamaño y una forma (hexágono o cuadrado) especificados a los que se van a agregar. El tamaño del bin especifica lo grandes que son los bins. Si va a agregar en hexágonos, el tamaño será la altura de cada hexágono y el ancho del hexágono resultante será el doble de la altura dividido entre la raíz cuadrada de 3. Si va a agregar a cuadros, el tamaño de bin es la altura del cuadrado, que es igual al ancho.

    Bins hexagonales y cuadrados
  • Consolidar puntos requiere que la Capa de puntos se haya proyectado o que el sistema de coordenadas de salida se haya definido como un sistema de coordenadas proyectadas. Si sus datos no se encuentran en un sistema de coordenadas proyectadas y no desea establecer un sistema de coordenadas de procesamiento proyectadas, se asignará una proyección en función de la extensión de los datos que está analizando.

  • La capa de entidades de salida siempre es una capa de polígonos. Solo se devolverán los polígonos que contengan puntos; los polígonos resultantes se eliminarán por completo de la capa de resultados.

    Polígonos devueltos con entidades de puntos
    Se muestran el punto de entrada y las entidades poligonales (izquierda) y las entidades de área resultantes (derecha) de Consolidar puntos.

  • Las agregaciones más básicas calcularán un recuento del número de puntos de cada polígono. Las estadísticas (recuento, suma, mínimo, máximo, rango, valor medio, desviación estándar y varianza) también se pueden calcular en campos numéricos y las estadísticas (recuento, cualquiera) se pueden calcular en campos de cadena de caracteres. Las estadísticas se calcularán por separado para cada área. Si especifica una estadística que no es válida (valor medio de un campo de cadena de caracteres), se omitirá.

    Nota:

    Cuando se aplica el recuento a un campo, devuelve un recuento de los valores no nulos presentes en el campo. Cuando se aplica cualquiera a un campo de cadena de caracteres, devuelve una sola cadena de caracteres presente en el campo.

  • Si el tiempo está habilitado en la entrada, puede aplicar los periodos de tiempo al análisis. Cada periodo de tiempo se analiza con independencia de las entidades que quedan fuera de él. Para usar intervalos de tiempo, los datos de entrada deben tener la función de tiempo habilitada y representar un instante en el tiempo. Cuando se aplican intervalos de tiempo, las entidades de salida serán intervalos de tiempo representados por los campos START_DATETIME y END_DATETIME.

    Más información sobre los periodos de tiempo

  • Si especifica un intervalo de periodo de tiempo, una repetición de periodo de tiempo o un tiempo de referencia y el tiempo no está habilitado en los datos, la herramienta generará un error.

  • El parámetro Referencia de periodo de tiempo puede ser un valor de fecha y hora o simplemente un valor de fecha; no puede ser solo un valor de hora.

  • En las entidades de salida se incluyen los siguientes campos:

    Nombre de campoDescription

    count

    El recuento de entidades dentro de cada polígono.

    statistic_fieldname

    Cada estadística especificada creará un campo de atributo, cuyo nombre tendrá el siguiente formato: estadística_nombredecampo. Por ejemplo, la desviación máxima y estándar del campo id son MAX_id y SD_id, respectivamente.

    start_date

    Cuando se especifican periodos de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de inicio.

    end_date

    Cuando se especifican periodos de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de finalización.

  • Es posible mejorar el rendimiento de la herramienta Consolidar puntos gracias a una o varias de estas sugerencias:

    • Defina el entorno de extensión para analizar únicamente datos de interés.
    • Los bins mayores funcionarán mejor que los pequeños. Si no sabe qué tamaño utilizar, comience con un bin mayor como prototipo.
    • De forma similar a los bins, los periodos de tiempo mayores funcionan mejor que los menores.
    • 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. Por lo tanto, 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

  • Es posible realizar análisis similares con la herramienta Consolidar puntos de la caja de herramientas Análisis de entidades estándar.

Sintaxis

arcpy.geoanalytics.AggregatePoints(point_layer, output_name, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {data_store})
ParámetroExplicaciónTipo de datos
point_layer

Las entidades de puntos que se van a consolidar en polígonos o bins.

Feature Set
output_name

El nombre del servicio de entidades de salida.

String
polygon_or_bin

Especifica cómo se consolidará point_layer.

  • POLYGONLa capa de puntos se consolidará en un dataset de polígonos.
  • BINLa capa de puntos se consolidará en bins cuadrados o hexagonales que se generan cuando se ejecuta la herramienta.
String
polygon_layer
(Opcional)

Las entidades poligonales en las que se consolidarán los puntos de entrada.

Feature Set
bin_type
(Opcional)

Especifica la forma de bin que se generará para albergar los puntos consolidados.

  • SQUARESe generarán bins cuadrados, en los que el bin_size representa la altura de un cuadrado. Esta es la opción predeterminada.
  • HEXAGONSe generarán bins hexagonales, en los que el bin_size representa la altura entre dos lados paralelos.
String
bin_size
(Opcional)

El intervalo de distancia que representa el tamaño de bin y las unidades en las que se consolidará la point_layer. El intervalo de distancia debe tener una unidad lineal.

Linear Unit
time_step_interval
(Opcional)

Un valor que especifica la duración del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo.

Los periodos de tiempo solo se pueden aplicar si el tiempo está habilitado en la entrada.

Time Unit
time_step_repeat
(Opcional)

Un valor que especifica la frecuencia con la que se produce el intervalo del periodo de tiempo. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo.

Time Unit
time_step_reference
(Opcional)

Una fecha que especifica el tiempo de referencia con el que se alinearán los períodos de tiempo. El valor predeterminado es el 1 de enero de 1970 a las 12:00 AM. Este parámetro solo está disponible si los puntos de entrada tienen el tiempo habilitado y representan un instante en el tiempo.

Date
summary_fields
[summary_fields,...]
(Opcional)

Las estadísticas que se calcularán en campos concretos.

  • COUNT: el número de valores no nulos. Se puede usar en campos numéricos o de cadenas de caracteres. El recuento de [null, 0, 2] es 2.
  • SUM: la suma de valores numéricos en un campo. La suma de [null, null, 3] es 3.
  • MEAN: el valor medio de los valores numéricos. La media de [0,2, null] es 1.
  • MIN: el valor mínimo de un campo numérico. El mínimo de [0, 2, null] es 0.
  • MAX: el valor máximo de un campo numérico. El valor máximo de [0, 2, null] es 2.
  • STDDEV: la desviación estándar de un campo numérico. La desviación estándar de [1] es null. La desviación estándar de [null, 1,1,1] es null.
  • VAR: la varianza de un campo numérico en un recorrido. La varianza de [1] es null. La varianza de [null, 1,1,1] es null.
  • RANGE: el rango de un campo numérico. Se calcula como el valor mínimo restado del valor máximo. El rango de [0, null, 1] es 1. El rango de [null, 4] es 0.
  • ANY: una cadena de caracteres de un campo de tipo cadena de caracteres.

Value Table
data_store
(Opcional)

Especifica el ArcGIS Data Store en el que se guardará la salida. La predeterminada 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

Salida derivada

NombreExplicaciónTipo de datos
output

Las entidades poligonales o bins agregados.

Conjunto de entidades

Muestra de código

AggregatePoints (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta AggregatePoints.

#-------------------------------------------------------------------------------
# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
outFS = "AggregateWildfires"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   dataStore)

Entornos

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