Consolidar puntos (GeoAnalytics Desktop)

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

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.

  

• El análisis con agrupamiento en bins requiere que su entrada esté proyectada o que el sistema de coordenadas de salida esté establecido como un sistema de coordenadas proyectadas. Si sus datos no se encuentran en un sistema de coordenadas proyectadas y no desea establecer ninguno, se usará 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.

  

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

• 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

• 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 campo	Description
  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 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 ArcGIS GeoAnalytics Server con el fin de realizar un análisis, consulte GeoAnalytics Tools.

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

Sintaxis

arcpy.gapro.AggregatePoints(point_layer, out_feature_class, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields})

Parámetro	Explicación	Tipo de datos
point_layer	Las entidades de puntos que se van a consolidar en polígonos o bins.	Feature Layer
out_feature_class	Una clase de entidad nueva con los resultados de los polígonos consolidados.	Feature Class
polygon_or_bin	Especifica cómo se consolidará point_layer. POLYGON —La capa de puntos se consolidará en un dataset de polígonos. BIN —La 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 Layer
bin_type (Opcional)	Especifica la forma de bin que se generará para albergar los puntos consolidados. SQUARE —Se generarán bins cuadrados, en los que el bin_size representa la altura de un cuadrado. Esta es la opción predeterminada. HEXAGON —Se 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

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.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/CityData.gdb"
# Set local variables
inFeatures = "SF311"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
out = "AggregateWildfires"
# Execute Aggregate Points
arcpy.gapro.AggregatePoints(inFeatures, out, "BIN", None, "HEXAGON", 
                            "1 Kilometers")

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í