| Etiqueta | Explicación | Tipo de datos |
Capa resumida |
Las entidades de punto, de línea o poligonales que se van a resumir por polígonos o por bins. | Feature Layer |
Clase de entidad de salida | El nombre de la clase de entidad de salida que contendrá las geometrías que se intersecan y los atributos. | Feature Class |
Polígono o bin | Especifica si el valor Capa resumida se resumirá por polígonos o por bins.
| String |
Tipo de bin | Especifica la forma del bin que se generará para resumir entidades.
| String |
Tamaño de bin (Opcional) | El intervalo de distancia que representa el tamaño de bin y las unidades por las que se resumirán las entidades de entrada. | Linear Unit |
Polígonos de resumen (Opcional) | Los polígonos que se utilizarán para resumir las entidades en la capa resumida de entrada. | Feature Layer |
Agregar atributos de resumen de forma | Especifica si se calculará la longitud de las líneas o el área de los polígonos dentro de la capa de resumen (polígono o bin). Siempre se incluirá el recuento de puntos, líneas y polígonos que se intersecan con la forma de resumen.
| Boolean |
Unidades de forma (Opcional) | Especifica la unidad de medida que se utilizará para calcular atributos de resumen de forma. Si las entidades de resumen de entrada son puntos, no es necesaria ninguna unidad de forma, dado que solo se agrega el recuento de puntos de cada polígono de entrada. Si las entidades de resumen de entrada son líneas, debe especificar una unidad lineal. Si las entidades de resumen de entrada son polígonos, debe especificar una unidad de área.
| String |
Campos de resumen estándar (Opcional) | Las estadísticas que se calcularán en campos concretos. Especifica si un campo representa un recuento o una tasa.
| Value Table |
Campos de resumen ponderados (Opcional) | Especifica las estadísticas ponderadas que se calcularán en campos concretos. Especifica si un campo representa un recuento o una tasa.
| Value Table |
Agrupar por campo (Opcional) | Un campo de las entidades de resumen de entrada que se usará para calcular estadísticas para cada valor de atributo único. Por ejemplo, las entidades de resumen de entrada contienen ubicaciones de puntos de empresas que almacenan materiales peligrosos, y uno de los campos es HazardClass, que contiene códigos que describen el tipo de material peligroso almacenado. Para calcular resúmenes por cada valor único de HazardClass, úselo como campo por el que se va a agrupar. | Field |
Agregar atributos de minoría y mayoría (Opcional) | Especifica si se agregarán los valores de atributo de minoría (menos dominantes) y de mayoría (más dominantes) para cada campo de grupo en cada límite. Cuando se activa este parámetro, se agregan a la capa de salida dos nuevos campos con los prefijos Minority_ y Majority_. Este parámetro solo se aplica si se proporciona un valor para el parámetro Agrupar por campo.
| Boolean |
Agregar porcentajes de grupo (Opcional) | Especifica si se agregarán campos de porcentaje. Si este parámetro está activado, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada. Este parámetro solo se aplica cuando se proporciona un valor para el parámetro Agrupar por campo y se especifica un valor para el parámetro Agregar atributos de minoría y mayoría.
| Boolean |
Agrupar por tabla de resumen (Opcional) | La tabla de salida que contendrá los grupos por resúmenes. | Table |
Resumen
Superpone una capa de polígonos con otra capa para resumir el número de puntos, la longitud de las líneas o el área de los polígonos dentro de cada polígono, y calcula estadísticas de campos de atributos para las entidades dentro de los polígonos.
A continuación se muestran situaciones de ejemplo que usan Resumir dentro de:
- Dados los límites de cuencas hidrográficas y los límites de uso del suelo por tipo de uso del suelo, calcule la superficie total del tipo de uso del suelo para cada cuenca hidrográfica.
- Dadas las parcelas de un condado y los límites de ciudades, resuma el valor medio de las parcelas vacías dentro de los límites de cada ciudad.
- Dados los condados y las carreteras, resuma el kilometraje total de las carreteras por tipo de carretera dentro de cada condado.
Ilustración
Uso
En otras palabras, la herramienta Resumir dentro de toma dos capas, los polígonos de entrada y las entidades de resumen de entrada, y las apila una encima de la otra. Puede ver la pila y contar el número de entidades de resumen de entrada que están incluidas en los polígonos de entrada. También puede calcular estadísticas simples sobre los atributos de las entidades de resumen de entrada, como la suma, el valor medio, el mínimo, el máximo, etcétera.
Utilice Resumir dentro de para calcular estadísticas estándar y estadísticas con ponderación geográfica. Las estadísticas estándar resumen los valores estadísticos sin ponderación. Las estadísticas ponderadas calculan los valores usando los atributos ponderados geográficamente de líneas que hay dentro de un polígono, o los atributos de polígonos que hay dentro de un polígono. Las estadísticas ponderadas no se aplican a los puntos contenidos dentro de polígonos.
Las estadísticas estándar y las estadísticas ponderadas geográficamente se pueden calcular para atributos que representen recuentos o tasas. Se definen de la siguiente manera:
- Recuentos: atributos que representan una suma o cantidad de una entidad en una ubicación de punto, a lo largo de una línea o dentro de un polígono. Algunos ejemplos de atributos de tipo recuento son la población de un país, la cantidad de recogidas de taxi en un bloque censal y la cantidad de presas a lo largo de un río. Para las entidades de línea y poligonales, los recuentos se proporcionan antes de calcular las estadísticas estándar o ponderadas.
- Tasas: atributos que representan un ratio o un índice en una ubicación de punto, a lo largo de una línea o dentro de un polígono. Entre los ejemplos de atributos de tipo de tasa se incluyen la densidad de población de un país, el límite de velocidad de una carretera o la puntuación de accesibilidad a pie de un vecindario. Las tasas no se proporcionan nunca.
Para los atributos de tipo de recuento, los valores se proporcionan según la cantidad de la línea dentro de un polígono o la cantidad del polígono dentro de otro polígono antes de calcular las estadísticas. Las estadísticas se calculan de la misma manera para los atributos de tipo de recuento y de tipo de tasa cuando las entidades de resumen son puntos.
Es posible calcular las longitudes y áreas de las capas resumidas dentro de cada polígono con las opciones de la siguiente tabla. Las opciones se basan en la geometría de la capa resumida.
Entidad de entrada Descripción Opción Puntos
El recuento de los puntos resumidos dentro de cada polígono
Ninguna
Líneas
La longitud de las líneas resumidas dentro de cada polígono
- Millas terrestres
- Yardas internacionales
- Pies internacionales
- Millas de agrimensura de EE. UU.
- Yardas de agrimensura de EE. UU.
- Pies de agrimensura de EE. UU.
- Kilómetros
- Metros
Áreas
El área de polígonos resumidos dentro de cada polígono
- Millas terrestres cuadradas
- Yardas cuadradas internacionales
- Pies cuadrados internacionales
- Kilómetros cuadrados
- Metros cuadrados
- Hectáreas
- Acres internacionales
- Millas cuadradas de agrimensura de EE. UU.
- Yardas cuadradas de agrimensura de EE. UU.
- Pies cuadrados de agrimensura de EE. UU.
- Acres topográficos de EE. UU.
Para las líneas y áreas, se calcularán todas las estadísticas ponderadas. Tanto las estadísticas de campo de resumen estándar como las estadísticas de campo de resumen ponderado se aplicarán a los datos de las entidades del valor del parámetro Capa resumida que se intersecan con la capa Polígonos de resumen. Las estadísticas de campo de resumen ponderado se multiplican por el peso basado en la proporción de entidades del valor del parámetro Polígonos de resumen que se intersecan con cada entidad del valor del parámetro Capa resumida.
Las estadísticas estándar cuentan con ocho opciones: recuento, suma, valor medio, mínimo, máximo, rango, desviación estándar y varianza. Las estadísticas de cadena de caracteres cuentan con dos opciones: recuento y cualquiera. Existen tres estadísticas ponderadas que se calculan según los campos numéricos de la capa que se va a resumir: valor medio, desviación estándar y varianza.
Las estadísticas ponderadas no se calculan para los datos de cadena de caracteres. Cada vez que se especifican valores de Campo y Estadística, se agrega una fila al panel de la herramienta para que se pueda calcular más de una estadística. Puede consultar los resultados resumidos en la tabla o los elementos emergentes de la capa de resultados. De forma predeterminada, el recuento de entidades que se intersecan con los valores de Polígonos de resumen siempre se calcula.
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.
Puede proporcionar un valor Agrupar por campo para que las estadísticas se calculen por separado para cada valor de atributo único. Si se proporciona un valor de Agrupar por campo, se creará también una tabla de resumen que muestra cada entidad y estadística por valor de Agrupar por campo.
Los parámetros Agregar atributos de minoría y mayoría y Agregar porcentajes de grupo están disponibles si se proporciona el valor Agrupar por campo. La minoría y la mayoría serán los valores menos y más dominantes del parámetro Agrupar por campo, respectivamente, de modo que el dominio se determina usando el recuento de puntos, la longitud total o el área total de cada valor.
Cuando se activa el parámetro Agregar atributos de minoría y mayoría, se agregan dos campos a la capa de resultados. Los campos mostrarán los valores del parámetro Agrupar por campo que son la minoría y la mayoría para cada entidad resultante.
El parámetro Agregar porcentajes de grupo solo está disponible si selecciona Agregar atributos de minoría y mayoría. Cuando se activa el parámetro Agregar porcentajes de grupo, se agregarán a la capa de resultados dos campos que mostrarán el porcentaje del recuento de puntos, la longitud total o el área total que pertenecen a los valores de minoría y mayoría de cada entidad. También se agregará a la tabla de resultados un campo de porcentaje que muestra el porcentaje del recuento de puntos, la longitud total o el área total que pertenece a todos los valores del parámetro Agrupar por campo de cada entidad.
La capa de entidades de salida siempre es una capa de polígonos. Solo se devolverán los polígonos que intersequen una capa resumida. El resto de polígonos se eliminarán por completo de la capa de resultados.
Se muestran el punto de entrada y las entidades poligonales (la primera imagen) y las entidades de área resultantes (la segunda imagen). En las entidades poligonales de salida se incluyen los siguientes campos:
Nombre de campo Descripción count El recuento de entidades resumidas que intersecan cada capa de polígonos.
sum_length_<linearunit>, o bien, sum_area_<areaunit>
La longitud total de líneas dentro del polígono o el área total del polígono resumido dentro de cada polígono. Estos valores se devuelven cuando selecciona Agregar atributos de resumen de forma y se devuelven en la unidad especificada.
statistic_<fieldname>
Cada estadística especificada creará un campo de atributo, cuyo nombre tendrá el siguiente formato: <estadística>_<nombredecampo>. Por ejemplo, el máximo y la desviación estándar del campo id son MAX_id y SD_id.
pstatistic_<fieldname>
Cada estadística ponderada especificada creará un campo de atributo, cuyo nombre tendrá el siguiente formato: p<estadística>_<nombredecampo>. Por ejemplo, el máximo ponderado del campo id es pMAX_id.
minority_<fieldname>
Este valor se devuelve cuando crea una tabla Agrupar por y activa Agregar atributos de minoría y mayoría. Representa los valores del campo especificado, que es la minoría de cada polígono. Por ejemplo, hay cinco puntos en un polígono con un campo llamado color y valores de rojo, azul, azul, verde, verde. Si crea un grupo por el campo color, el valor del campo minority_color es rojo.
majority_<fieldname>
Este valor se devuelve cuando crea una tabla Agrupar por y activa Agregar atributos de minoría y mayoría. Representa los valores del campo especificado, que es la mayoría de cada polígono. Por ejemplo, hay cinco puntos en un polígono con un campo llamado color y valores de rojo, azul, azul, verde, verde. Si crea un grupo por el campo color, el valor del campo minority_color es azul;verde.
minority_<fieldname>_percent
Este valor se devuelve cuando crea una tabla Agrupar por y se activa Agregar porcentajes de grupo. Representa los porcentajes del recuento del campo especificado, que es la minoría de cada polígono. Por ejemplo, hay cinco puntos en un polígono con un campo llamado color y valores de rojo, azul, azul, verde, verde. Si crea un grupo por el campo color, el valor del campo minority_color_percent es 20 (calculado como 1/5).
majority_<fieldname>_percent
Este valor se devuelve cuando crea una tabla Agrupar por y se activa Agregar porcentajes de grupo. Representa los porcentajes del recuento del campo especificado, que es la mayoría de cada polígono. Por ejemplo, hay cinco puntos en un polígono con un campo llamado color y valores de rojo, azul, azul, verde, verde. Si crea un grupo por el campo color, el valor del campo majority_color_percent es 40 (calculado como 2/5).
join_id
Este valor se devuelve cuando crea una tabla Agrupar por. Es un Id. para vincular entidades con la tabla Agrupar por. Cada campo join_id se corresponde con una o varias filas de la tabla Agrupar por.
Se incluyen los siguientes campos en la tabla Agrupar por de salida:
Nombre de campo Descripción join_id
Es un Id. para vincular entidades con la capa de polígono. Cada polígono tendrá una o varias entidades con el mismo Id., que representa todos los valores de Agrupar por. Por ejemplo, hay cinco puntos en un polígono con un campo llamado color y valores de rojo, azul, azul, verde, verde. La tabla Agrupar por tendrá tres filas que representen ese polígono (mismo Id. de unión), una para cada color: rojo, azul y verde.
count
El recuento del grupo especificado dentro del polígono unido. Por ejemplo, rojo es 1 para el polígono seleccionado.
<statistic>_<fieldname>
Cualquier estadística especificada que se ha calculado para cada grupo.
p<statistic>_<fieldname>
Cualquier estadística ponderada que se ha calculado para cada grupo.
percentcount
El porcentaje que contribuye cada grupo al recuento total del polígono. Con el ejemplo anterior, el rojo contribuye 1/5 = 20, el azul contribuye 2/5 = 40 y el verde contribuye 2/5 = 20.
Es posible mejorar el rendimiento de la herramienta Resumir dentro de gracias a una o varias de las siguientes acciones:
- Defina el entorno de extensión de forma que solo se analizarán datos de interés.
- Los bins mayores funcionarán mejor que los pequeños. Si utiliza bins y no tiene claro qué tamaño utilizar, empiece con un bin más grande para hacer un prototipo.
- 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 Resumir dentro de de la caja de herramientas Análisis de entidades estándar en ArcGIS Pro.
Parámetros
arcpy.gapro.SummarizeWithin(summarized_layer, out_feature_class, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {group_by_field}, {add_minority_majority}, {add_percentages}, {group_by_summary})| Nombre | Explicación | Tipo de datos |
summarized_layer |
Las entidades de punto, de línea o poligonales que se van a resumir por polígonos o por bins. | Feature Layer |
out_feature_class | El nombre de la clase de entidad de salida que contendrá las geometrías que se intersecan y los atributos. | Feature Class |
polygon_or_bin | Especifica si el valor summarized_layer se resumirá por polígonos o por bins.
| String |
bin_type | Especifica la forma del bin que se generará para resumir entidades.
| String |
bin_size (Opcional) | El intervalo de distancia que representa el tamaño de bin y las unidades por las que se resumirán las entidades de entrada. | Linear Unit |
summary_polygons (Opcional) | Los polígonos que se utilizarán para resumir las entidades en la capa resumida de entrada. | Feature Layer |
sum_shape | Especifica si se calculará la longitud de las líneas o el área de los polígonos dentro de la capa de resumen (polígono o bin). Siempre se incluirá el recuento de puntos, líneas y polígonos que se intersecan con la forma de resumen.
| Boolean |
shape_units (Opcional) | Especifica la unidad de medida que se utilizará para calcular atributos de resumen de forma. Si el valor de summarized_layer de entrada es puntos, no es necesaria ninguna unidad de forma, dado que solo se agrega el recuento de puntos dentro de cada polígono de entrada. Si las entidades de resumen de entrada son líneas, debe especificar una unidad lineal. Si las entidades de resumen de entrada son polígonos, debe especificar una unidad de área.
| String |
standard_summary_fields [standard_summary_fields,...] (Opcional) | Las estadísticas que se calcularán en campos concretos.
Especifica si un campo representa un recuento o una tasa.
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (Opcional) | Especifica las estadísticas ponderadas que se calcularán en campos concretos.
Especifica si un campo representa un recuento o una tasa.
| Value Table |
group_by_field (Opcional) | Un campo de las entidades de resumen de entrada que se usará para calcular estadísticas para cada valor de atributo único. Por ejemplo, las entidades de resumen de entrada contienen ubicaciones de puntos de empresas que almacenan materiales peligrosos, y uno de los campos es HazardClass, que contiene códigos que describen el tipo de material peligroso almacenado. Para calcular resúmenes por cada valor único de HazardClass, úselo como campo por el que se va a agrupar. | Field |
add_minority_majority (Opcional) | Especifica si se agregarán los valores de atributo de minoría (menos dominantes) y de mayoría (más dominantes) para cada campo de grupo en cada límite. Cuando el valor de este parámetro es ADD_MIN_MAJ, se agregan a la capa de salida dos nuevos campos con los prefijos Minority_ y Majority_. Este parámetro solo se aplica si se proporciona un valor para el parámetro group_by_field.
| Boolean |
add_percentages (Opcional) | Especifica si se agregarán campos de porcentaje. Si el valor de este parámetro es ADD_PERCENT, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada. Este parámetro solo se aplica cuando se proporciona un valor para el parámetro group_by_field y se especifica un valor para el parámetro add_minority_majority.
| Boolean |
group_by_summary (Opcional) | La tabla de salida que contendrá los grupos por resúmenes. | Table |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función SummarizeWithin.
#-------------------------------------------------------------------------------
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
# Set local variables
summarizedLayer = "Rivers"
summaryPolys = "Basins"
summaryStatistics = [["Width", "MEAN"]]
weighedSummaryStatistics = [["DOC", "SUM"]]
out = 'SummarizedRivers'
# Run SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí