Etiqueta | Explicación | Tipo de datos |
Capa de puntos | Entidades de punto que se van a consolidar en polígonos o bins. | Feature Layer |
Clase de entidad de salida | Una clase de entidad nueva con los resultados de los polígonos consolidados. | Feature Class |
Polígono o bin | Especifica cómo se consolidará el valor del parámetro Capa de puntos.
| String |
Capa de polígono (Opcional) | Las entidades poligonales en las que se consolidarán los puntos de entrada. | Feature Layer |
Tipo de bin (Opcional) | Especifica la forma de bin que se generará para albergar los puntos consolidados.
| 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 |
Resolución del 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 |
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.
Ilustración
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.
El análisis con agrupamiento en bins requiere que la entrada esté proyectada o que el sistema de coordenadas de salida esté establecido como un sistema de coordenadas proyectadas. Si los 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 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.
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.
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.
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 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.
Es posible realizar análisis similares con la herramienta Consolidar puntos de la caja de herramientas Análisis de entidades estándar.
Parámetros
arcpy.geoanalytics.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}, {bin_resolution})
Nombre | Explicación | Tipo de datos |
point_layer | Entidades de punto 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á el valor del parámetro point_layer.
| 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.
| 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.
| Value Table |
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 |
Muestra de código
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.
# 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"
# Run Aggregate Points
arcpy.gapro.AggregatePoints(inFeatures, out, "BIN", None, "HEXAGON",
"1 Kilometers")