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

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.

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

• Puede especificar las áreas donde se agregarán los puntos de cualquiera de las siguientes maneras:

  • Usar una capa de polígonos.
  • Usar un bin cuadrado, hexagonal o H3 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, cuadrado o H3) especificados a los que se van a agregar los puntos. El tamaño de bin especifica el tamaño de los bins cuadrados y hexagonales.

  • Si va a agregar a 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.
  • Si está agregando en bins H3, el tamaño del bin viene determinado por la resolución del bin H3 especificada. La resolución del bin H3 puede ser un valor entre 0 y 15, donde 0 produce los bins más grandes y 15 los más pequeños.

  

• Agregar puntos requiere que el valor del parámetro Capa de puntos sea proyectado o que el sistema de coordenadas de salida sea un sistema de coordenadas proyectadas cuando se agrega en bins hexagonales o cuadrados. Si los datos no están en un sistema de coordenadas proyectadas al agregarlos en bins hexagonales o cuadrados y no establece un sistema de coordenadas de procesamiento proyectado, se asignará una proyección basada en la extensión de los datos que esté analizando. Cuando se agrega en intervalos H3, el valor del parámetro Capa de puntos debe ser un Sistema geodésico mundial 1984 (WKID 4326) y se transformará a este sistema de coordenadas si es necesario.

• La capa de entidad de salida siempre es una capa de polígonos. Solo se devolverán los polígonos que contengan puntos, y los polígonos resultantes se eliminarán completamente de la capa resultante.

  

  Las entidades de punto y polígono de entrada se muestran en la primera imagen y las entidades de área resultantes de la herramienta Agregar puntos se muestran en la segunda imagen.

• Las agregaciones más básicas calcularán un recuento del número de puntos en 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 (la media de un campo de cadena, por ejemplo), 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 any 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 periodos de tiempo, los datos de entrada deben tener la función de tiempo habilitada y representar un instante en el tiempo. Al aplicar periodos 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 tiempo o un tiempo de referencia, y el tiempo no está activado en los datos, se producirá 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	Descripción
  count	Recuento de entidades de cada polígono.
  statistic_fieldname	Cada una de las estadísticas especificadas creará un campo de atributo con el siguiente formato: nombre_ampo_estadística. Por ejemplo, la desviación máxima y estándar del campo id es MAX_id y SD_id, respectivamente.
  start_date	Cuando se especifica el periodo de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de inicio.
  end_date	Cuando se especifica el periodo de tiempo, los polígonos de salida tendrán un intervalo de tiempo. Este campo representa la hora de finalización.
  bin_id	Id. numérico del bin H3. Este campo solo se incluye al agregar en bins H3.

• Puede mejorar el rendimiento de la herramienta Consolidar puntos aplicando uno o varios de los consejos siguientes:

  • Defina el entorno de extensión para analizar únicamente datos de interés.
  • Los bins más grandes funcionarán mejor que los más pequeños. Si no está seguro de qué tamaño utilizar, empiece con un bin más grande para hacer un prototipo.
  • Al igual que en el caso de los intervalos, los periodos de tiempo más largos dan mejores resultados que los más cortos.
  • 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

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

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Capa de puntos	Entidades de punto que se van a consolidar en polígonos o bins.	Feature Set
Nombre de salida	El nombre del servicio de entidades de salida.	String
Polígono o bin	Especifica cómo se consolidará el valor del parámetro Capa de puntos. Polígono—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
Capa de polígono (Opcional)	Las entidades poligonales en las que se consolidarán los puntos de entrada.	Feature Set
Tipo de bin (Opcional)	Especifica la forma de bin que se generará para albergar los puntos consolidados. Cuadrado—Se generarán bins cuadrados en los que el valor Tamaño de bin representa la altura de un cuadrado. Esta es la opción predeterminada. Hexágono—Se generarán bins hexagonales en los que el valor Tamaño de bin representa la altura entre dos lados paralelos. H3—Se generarán bins H3. El tamaño del bin viene determinado por el valor del parámetro Resolución del bin.	String
Tamaño de bin (Opcional)	El intervalo de distancia que representa el tamaño de bin y las unidades en las que se consolidará el valor de Capa de puntos. El intervalo de distancia debe tener una unidad lineal.	Linear Unit
Intervalo de periodo de tiempo (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
Repetición de periodo de tiempo (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
Referencia de periodo de tiempo (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
Campos de resumen (Opcional)	Las estadísticas que se calcularán en campos concretos.	Value Table
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
Resolución de bin (Opcional)	Resolución de los bins H3. Se trata de un valor entre 0 y 15 en el que 0 producirá los bins H3 más grandes y 15 producirá los bins H3 más pequeños.	Long

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capa de entidades de salida	Las entidades poligonales o bins agregados.	Feature Set

Python

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}, {bin_resolution})

Nombre	Explicación	Tipo de datos
point_layer	Entidades de punto 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á el valor del parámetro 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 Set
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 valor bin_size representa la altura de un cuadrado. Esta es la opción predeterminada. HEXAGON—Se generarán bins hexagonales en los que el valor bin_size representa la altura entre dos lados paralelos. H3—Se generarán bins H3. El tamaño del bin viene determinado por el valor del parámetro bin_resolution.	String
bin_size (Opcional)	El intervalo de distancia que representa el tamaño de bin y las unidades en las que se consolidará el valor de 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. El valor medio 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ínimos 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 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
bin_resolution (Opcional)	Resolución de los bins H3. Se trata de un valor entre 0 y 15 en el que 0 producirá los bins H3 más grandes y 15 producirá los bins H3 más pequeños.	Long

Salida derivada

Nombre	Explicación	Tipo de datos
output	Las entidades poligonales o bins agregados.	Feature Set

Muestra de código

AggregatePoints (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función 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"

# Run Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   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