Agregar puntos (Standard Feature Analysis)

Resumen

Usa una capa de entidades de punto y una capa de entidades poligonales para identificar los puntos que se encuentran dentro del área de cada polígono. Después de identificar la relación espacial de punto en polígono, se calculan las estadísticas sobre todos los puntos del polígono y se asignan al área.

La estadística más básica es el recuento del número de puntos dentro del polígono, pero se pueden obtener también otras estadísticas. Por ejemplo, si los puntos representan cafeterías y cada punto tiene un atributo TOTAL_SALES, puede obtener estadísticas como la suma de todos los valores TOTAL_SALES de dentro del polígono, el valor mínimo o máximo de TOTAL_SALES o la desviación estándar de todas las ventas dentro del polígono.

Ilustración

Ilustración de la herramienta Agregar puntos

Uso

  • Esta herramienta captura y resume entidades de punto dentro de un conjunto de límites. Los parámetros de entrada deben incluir los puntos que se vayan a agregar, así como las áreas de agregación.

  • El parámetro Conservar límites sin puntos está activado por defecto. Cuando el parámetro está activado, todas las áreas utilizadas en el análisis se incluyen en el resultado, con independencia de la ubicación de los puntos. Las áreas sin puntos estarán vacías y tendrán un recuento de 0. Cuando el parámetro está desactivado, las áreas sin puntos se eliminan de la capa de resultados. Desactivar este parámetro puede tener un efecto visible en las áreas de resultados.

    Conservar áreas sin uso de puntos
    Se muestra la diferencia en las capas de resultados cuando los límites sin puntos se conservan (primera imagen) o no se conservan (segunda imagen).

  • Las agregaciones más básicas calcularán un recuento del número de puntos en cada límite. También se pueden calcular las estadísticas básicas (suma, mínimo, máximo, media y desviación estándar) en los campos numéricos. Las estadísticas se calcularán por separado para cada área.

  • Los cálculos estadísticos también se pueden agrupar usando un campo con valores de categorías. Cuando las estadísticas se agrupan por un campo, se calculan tanto para el área en su conjunto como para cada grupo. Las dos estadísticas se pueden visualizar en la ventana emergente de la capa de resultados. Las estadísticas totales se proporcionan de forma numérica y las estadísticas agrupadas se muestran en un gráfico en la ventana emergente. También se creará una tabla de resumen que muestra cada entidad y estadística por valor de campo del grupo. Activar el parámetro Agregar atributos de minoría y mayoría devolverá los grupos con los recuentos más bajos y más altos, y activar el parámetro Agregar porcentaje devolverá el porcentaje de puntos en los grupos minoritario y mayoritario.

  • Las capas de puntos se resumen usando únicamente las entidades de punto contenidas en el límite de entrada. Los resultados se mostrarán usando símbolos graduados.

    La figura y la tabla siguientes explican los cálculos estadísticos de una capa de puntos dentro de un límite hipotético. El campo Population se utilizó para calcular las estadísticas (Suma, Mínimo, Máximo, Media y Desviación estándar) de la capa.

    Resumir una capa de puntos
    Las capas de puntos se resumen usando únicamente los puntos situados dentro de la capa de límite. Se muestra una tabla de atributos de ejemplo con los valores que se van a usar en los cálculos estadísticos hipotéticos.

    EstadísticaResultados del distrito A

    Suma

    280 + 408 + 356 + 361 + 450 + 713 = 2.568

    Mínimo

    Mínimo de

    [280, 408, 356, 361, 450, 713] = 280

    Máximo

    Máximo de

    [280, 408, 356, 361, 450, 713] = 713

    Media

    2.568/6 = 428

    Desviación estándar

    Desviación estándar de puntos

    = 150,79

Parámetros

EtiquetaExplicaciónTipo de datos
Puntos de entrada

Las entidades de puntos que se agregarán en polígonos en la capa de polígonos.

Feature Set
Agregar polígonos

Las entidades poligonales (áreas) a las que se agregarán puntos de entrada.

Feature Set
Nombre de salida

El nombre de la capa de salida que se creará en su portal.

String
Conservar límites sin puntos
(Opcional)

Especifica si los polígonos que no tienen puntos en ellos se devolverán en la salida.

  • Activado: los polígonos sin puntos se devolverán en la salida. Esta es la opción predeterminada.
  • Desactivado: los polígonos sin puntos no se devolverán en la salida.

Boolean
Campos de resumen
(Opcional)

Una lista de los nombres de campo y del tipo de resumen estadístico que se calcularán para todos los puntos de cada polígono. Siempre se devuelve el recuento de puntos de cada polígono. Se admiten los siguientes tipos de estadísticas:

  • Suma: el valor total
  • Mínimo: el valor más bajo
  • Máximo: el valor más alto
  • Valor medio: la media o valor medio
  • Desviación estándar: la desviación estándar

Value Table
Agrupar por campo
(Opcional)

Un nombre de campo de la pointLayer. Los puntos que tienen el mismo valor para el campo de agrupación tendrán sus propios recuentos y estadísticas del campo de resumen.

Puedes crear grupos estadísticos mediante un atributo en la capa de análisis. Por ejemplo, si ha agregado delitos en los límites del vecindario, es posible que tenga un atributo Crime_type con cinco tipos de delitos. Cada tipo de delito único constituye un grupo y las estadísticas que elijas se calcularán para cada valor único de Crime_type. Cuando elige un atributo de agrupación, se crean dos resultados: la capa de resultados y una tabla relacionada que contiene las estadísticas.

Field
Agregar atributos de minoría y mayoría
(Opcional)

Especifica si los campos de minoría y mayoría se agregarán a la salida. Este parámetro solo se aplica cuando se proporciona un valor para Agrupar por campo. Si está activado, se calcularán los valores de atributo de minoría (menos dominantes) o los de mayoría (más dominantes) para cada campo de grupo dentro de cada límite. Se agregarán dos nuevos campos con el prefijo Majority_ y Minority_ a la capa de salida.

  • Desactivado: los campos de minoría y mayoría no se agregarán. Esta es la opción predeterminada.
  • Activado: los campos de minoría y mayoría se agregarán.

Boolean
Agregar porcentaje
(Opcional)

Especifica si los campos de porcentaje se agregarán a la salida. Este parámetro solo se aplica cuando se proporciona un valor para Agrupar por campo. Si está activado, se calculará el recuento porcentual de puntos para cada valor único de Agrupar por campo. Se agregará a la tabla de resumen de grupo de salida un nuevo campo que contiene los porcentajes de cada valor de atributo en cada grupo. Si Agregar atributos de minoría y mayoría está activado, se agregarán a la salida dos campos adicionales que contienen los porcentajes de los valores de atributos de minoría y mayoría en cada grupo.

  • Desactivado: no se agregarán campos de porcentaje. Esta es la opción predeterminada.
  • Activado: se agregarán campos de porcentaje.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Capa de salida

La capa de salida.

Feature Set
Capa de grupo de salida

La tabla de salida que resume los grupos a partir del campo de agrupación.

Record Set

arcpy.sfa.AggregatePoints(pointLayer, polygonLayer, outputName, {keepBoundariesWithNoPoints}, {summaryFields}, {groupByField}, {minorityMajority}, {percentPoints})
NombreExplicaciónTipo de datos
pointLayer

Las entidades de puntos que se agregarán en polígonos en la capa de polígonos.

Feature Set
polygonLayer

Las entidades poligonales (áreas) a las que se agregarán puntos de entrada.

Feature Set
outputName

El nombre de la capa de salida que se creará en su portal.

String
keepBoundariesWithNoPoints
(Opcional)

Especifica si los polígonos que no tienen puntos en ellos se devolverán en la salida.

  • KEEP_EMPTYLos polígonos sin puntos se devolverán en la salida. Esta es la opción predeterminada.
  • REMOVE_EMPTYLos polígonos sin puntos no se devolverán en la salida.
Boolean
summaryFields
[[Field, Statistic],...]
(Opcional)

Una lista de los nombres de campo y del tipo de resumen estadístico que se calcularán para todos los puntos de cada polígono. Siempre se devuelve el recuento de puntos de cada polígono. Se admiten los siguientes tipos de estadísticas:

  • SUM: el valor total
  • MIN: el valor más bajo
  • MAX: el valor más alto
  • MEAN: la media o valor medio
  • STD: la desviación estándar

Value Table
groupByField
(Opcional)

Un nombre de campo de la pointLayer. Los puntos que tienen el mismo valor para el campo de agrupación tendrán sus propios recuentos y estadísticas del campo de resumen.

Puedes crear grupos estadísticos mediante un atributo en la capa de análisis. Por ejemplo, si ha agregado delitos en los límites del vecindario, es posible que tenga un atributo Crime_type con cinco tipos de delitos. Cada tipo de delito único constituye un grupo y las estadísticas que elijas se calcularán para cada valor único de Crime_type. Cuando elige un atributo de agrupación, se crean dos resultados: la capa de resultados y una tabla relacionada que contiene las estadísticas.

Field
minorityMajority
(Opcional)

Especifica si se agregarán los campos de minoría y mayoría. Este parámetro solo se aplica cuando se proporciona un valor para groupByField. Si se establece en ADD_MIN_MAJ, se calcularán los valores de atributos de minoría (menos dominantes) o los de mayoría (más dominantes) para cada campo de grupo dentro de cada límite. Se agregarán dos nuevos campos con el prefijo Majority_ y Minority_ a la capa de salida.

  • NO_MIN_MAJLos campos de minoría y mayoría no se agregarán. Esta es la opción predeterminada.
  • ADD_MIN_MAJLos campos de minoría y mayoría se agregarán.
Boolean
percentPoints
(Opcional)

Especifica si los campos de porcentaje se agregarán a la salida. Este parámetro solo se aplica cuando se proporciona un valor para groupByField. Si se ha definido como ADD_PERCENT, se calculará el recuento porcentual de puntos para cada valor único de groupByField. Se agregará a la tabla de resumen de grupo de salida un nuevo campo que contiene los porcentajes de cada valor de atributo en cada grupo. Si minorityMajority está establecido en ADD_MIN_MAJ, se agregarán a la salida dos campos adicionales que contienen los porcentajes de los valores de atributos de minoría y mayoría en cada grupo.

  • NO_PERCENTNo agrega los campos de porcentaje. Esta es la opción predeterminada.
  • ADD_PERCENTAgrega los campos de porcentaje.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
aggregatedLayer

La capa de salida.

Feature Set
groupSummary

La tabla de salida que resume los grupos a partir del campo de agrupación.

Record Set

Información de licenciamiento

  • Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis

Temas relacionados