| Etiqueta | Explicación | Tipo de datos |
Polígonos de entrada | Los polígonos que se van a utilizar para resumir las entidades, o porciones de las entidades, en la capa de resumen de entrada. | Feature Layer |
Entidades de resumen de entrada | Las entidades de punto, línea o poligonales que se van a resumir para cada polígono de entrada. | Feature Layer |
Clase de entidad de salida | La clase de entidad poligonal de salida que contiene las mismas geometrías y atributos que los polígonos de entrada. La clase de entidad incluirá atributos adicionales para el número de puntos, la longitud de las líneas y el área de los polígonos dentro de cada polígono de entrada, así como estadísticas sobre esas entidades. | Feature Class |
Mantener todos los polígonos de entrada (Opcional) | Especifica si en la clase de entidad de salida se copiarán todos los polígonos de entrada o solo aquellos que se intersequen o contengan al menos una entidad de resumen de entrada.
| Boolean |
Campos de resumen (Opcional) | Una lista de los nombres de campo de atributo provenientes de las entidades de resumen de entrada, así como los tipos de resumen de estadísticas que se calcularán para esos campos de atributos para todos los puntos de cada polígono. Los campos de resumen deben ser numéricos. No se admiten campos de texto ni otros tipos de campos de atributos. Los siguientes son los tipos de estadísticas:
| Value Table |
Agregar atributos de resumen de forma (Opcional) | Especifica si los atributos correspondientes al número de puntos, la longitud de las líneas y el área de las entidades poligonales que se resumen en cada polígono de entrada se agregarán a la clase de entidad de salida.
| Boolean |
Unidad de forma (Opcional) | Especifica la unidad que se utilizará cuando se calculen 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 |
Campo de grupo (Opcional) | Un campo de atributo de las entidades de resumen de entrada que se utilizará para la agrupación. Las entidades que tengan el mismo valor de campo de grupo se combinarán y resumirán con otras entidades que tengan el mismo valor de campo de grupo. Cuando se proporciona un campo de grupo, se requiere el parámetro Tabla agrupada de salida. | 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 permite determinar qué valor de campo de grupo corresponde a la minoría (menos dominante) y a la mayoría (más dominante) en cada polígono de entrada. Este parámetro está activo si ha proporcionado el valor del parámetro Campo de grupo.
| Boolean |
Agregar porcentajes de grupo (Opcional) | Especifica si se agregará un campo de atributo de porcentaje a la salida. Este parámetro permite determinar el porcentaje de cada valor de atributo en cada grupo. Este parámetro está activo si ha proporcionado el valor del parámetro Campo de grupo.
| Boolean |
Tabla agrupada de salida (Opcional) | Se trata de una tabla de salida que incluye campos de resumen para cada grupo de entidades de cada polígono de entrada. La tabla contendrá los siguientes campos de atributos:
Este parámetro se requiere cuando se proporciona el valor del parámetro Campo de grupo. | Table |
Resumen
Superpone una capa de polígono 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, así como para calcular estadísticas de campos de atributos sobre las entidades dentro de los polígonos.
A continuación, se muestran escenarios de ejemplo en los que se utiliza la opción Resumir dentro de:
- A partir de una capa de límites de cuencas hidrográficas y una capa de límites de uso del suelo, calcule la superficie total del tipo de uso del suelo para cada cuenca hidrográfica.
- A partir de una capa de parcelas de un condado y una capa de límites de ciudades, resuma el valor medio de las parcelas vacías en cada límite de ciudad.
- A partir de una capa de condados y una capa de carreteras, resuma el kilometraje total de las carreteras por tipo de carretera en cada condado.
Ilustración
Uso
Imagine que 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. Después de apilar estas capas, puede examinar 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.
Desde el punto de vista conceptual, las herramientas Resumir dentro de y Resumir cerca de son parecidas. Con la herramienta Resumir dentro de, puede resumir entidades dentro de polígonos existentes. Con la herramienta Resumir cerca de, puede generar áreas alrededor de puntos, líneas o polígonos, y resumir entidades dentro de dichas áreas derivadas.
Las entidades de resumen de polígonos se resumen utilizando las proporciones de área de las entidades de entrada. Considere un polígono de entrada que se superpone a un polígono de resumen en 1 kilómetro cuadrado. Si el polígono de resumen es de 100 kilómetros cuadrados, la herramienta resumirá 1/100 de los valores numéricos del polígono de resumen. Para garantizar la validez de los cálculos proporcionales, utilice campos con recuentos y cantidades en lugar de tasas o ratios.
Puede crear grupos especificando un nombre de grupo en los puntos de entrada. Por ejemplo, si está haciendo un resumen de los actos delictivos dentro de los límites de un vecindario, puede que tenga un atributo Crime_type con cinco tipos de actos delictivos. Cada tipo de delito único constituye un grupo y las estadísticas que elija se calcularán para cada valor único Crime_type.
Los valores nulos se excluyen de todos los cálculos estadísticos. Por ejemplo, el promedio de 6, 4 y un valor nulo es 5 ((6+4)/2).
Parámetros
arcpy.analysis.SummarizeWithin(in_polygons, in_sum_features, out_feature_class, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {out_group_table})| Nombre | Explicación | Tipo de datos |
in_polygons | Los polígonos que se van a utilizar para resumir las entidades, o porciones de las entidades, en la capa de resumen de entrada. | Feature Layer |
in_sum_features | Las entidades de punto, línea o poligonales que se van a resumir para cada polígono de entrada. | Feature Layer |
out_feature_class | La clase de entidad poligonal de salida que contiene las mismas geometrías y atributos que los polígonos de entrada. La clase de entidad incluirá atributos adicionales para el número de puntos, la longitud de las líneas y el área de los polígonos dentro de cada polígono de entrada, así como estadísticas sobre esas entidades. | Feature Class |
keep_all_polygons (Opcional) | Especifica si en la clase de entidad de salida se copiarán todos los polígonos de entrada o solo aquellos que se intersequen o contengan al menos una entidad de resumen de entrada.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Opcional) | Una lista de los nombres de campo de atributo provenientes de las entidades de resumen de entrada, así como los tipos de resumen de estadísticas que se calcularán para esos campos de atributos para todos los puntos de cada polígono. Los campos de resumen deben ser numéricos. No se admiten campos de texto ni otros tipos de campos de atributos. Los siguientes son los tipos de estadísticas:
| Value Table |
sum_shape (Opcional) | Especifica si los atributos correspondientes al número de puntos, la longitud de las líneas y el área de las entidades poligonales que se resumen en cada polígono de entrada se agregarán a la clase de entidad de salida.
| Boolean |
shape_unit (Opcional) | Especifica la unidad que se utilizará cuando se calculen 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 |
group_field (Opcional) | Un campo de atributo de las entidades de resumen de entrada que se utilizará para la agrupación. Las entidades que tengan el mismo valor de campo de grupo se combinarán y resumirán con otras entidades que tengan el mismo valor de campo de grupo. Cuando se proporciona un campo de grupo, se requiere el parámetro out_grouped_table. | Field |
add_min_maj (Opcional) | Especifica si los campos de minoría y mayoría se agregarán a la salida. Este parámetro permite determinar qué valor de campo de grupo corresponde a la minoría (menos dominante) y a la mayoría (más dominante) en cada polígono de entrada. Este parámetro está habilitado si ha proporcionado el valor del parámetro group_field.
| Boolean |
add_group_percent (Opcional) | Especifica si se agregará un campo de atributo de porcentaje a la salida. Este parámetro permite determinar el porcentaje de cada valor de atributo en cada grupo. Este parámetro está habilitado si ha proporcionado el valor del parámetro group_field.
| Boolean |
out_group_table (Opcional) | Se trata de una tabla de salida que incluye campos de resumen para cada grupo de entidades de cada polígono de entrada. La tabla contendrá los siguientes campos de atributos:
Este parámetro se requiere cuando se proporciona el valor del parámetro group_field. | Table |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función SummarizeWithin.
import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')La siguiente secuencia de comandos independiente es un ejemplo de cómo utilizar la función SummarizeWithin en un entorno de secuencias de comandos.
# Description: Use SummarizeWithin to summarize the crimes in each city neighborhood
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data/city.gdb'
# Set local variables
polys = 'neighborhoods'
points = 'crimes'
outFeatureClass = 'crimes_aggregated'
keepAll = 'KEEP_ALL'
sumFields = [['Damages', 'SUM'], ['VICTIM_AGE', 'MEAN']]
addShapeSum = 'ADD_SHAPE_SUM'
groupField = 'Crime_type'
addMinMaj = 'ADD_MIN_MAJ'
addPercents = 'ADD_PERCENT'
outTable = 'crimes_aggregated_groups'
arcpy.analysis.SummarizeWithin(polys, points, outFeatureClass, keepAll,
sumFields, addShapeSum, '', groupField,
addMinMaj, addPercents, outTable)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí