Resumir dentro de (Análisis)

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.

Escenarios de ejemplo en los que se utiliza la opción Resumir dentro de:

• Dada 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.
• Dada 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.
• Dada una capa de condados y una capa de carreteras, resume el kilometraje total de las carreteras por tipo de carretera dentro de 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, examine la pila y cuente el número de entidades de resumen de entrada que están incluidas en los polígonos de entrada. No solo puede contar el número de entidades, sino que también puede calcular estadísticas simples sobre los atributos de las entidades de resumen, 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.

• 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 distintos de actos delictivos. Cada tipo de delito único constituye un grupo y las estadísticas que elijas se calcularán para cada valor único de Crime_type.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Polígonos de entrada	Los polígonos que se utilizan 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, con atributos nuevos para el número de puntos, la longitud de las líneas, el área de los polígonos dentro de cada polígono de entrada y estadísticas sobre dichas 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. Activado: se copiarán todos los polígonos de entrada en la clase de entidad de salida. Esta es la opción predeterminada. Desactivado: se copiarán solo los polígonos de entrada que 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: Suma: valor total de todos los puntos de cada polígono que se calculará. Media: media de todos los puntos de cada polígono que se calculará. Mínimo: valor más pequeño de todos los puntos de cada polígono que se identificará. Máximo: valor más grande de todos los puntos de cada polígono que se identificará. Stddev: desviación estándar de todos los puntos de cada polígono que se calculará.	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 entrada se agregarán a la salida. Activado: los atributos de resumen de forma se agregarán a la clase de entidad de salida. Esta es la opción predeterminada. Desactivado: los atributos de resumen de forma no se agregarán a la clase de entidad de salida.	Boolean
Unidad de forma (Opcional)	Unidad que se utilizará al calcular los 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. Metros—La unidad será metros. Kilómetros—La unidad será kilómetros. Pies—La unidad será pies. Yardas—La unidad será yardas. Millas—La unidad será millas. Acres—La unidad será acres. Hectáreas—La unidad será hectáreas. Metros cuadrados—La unidad será metros cuadrados. Kilómetros cuadrados—La unidad será kilómetros cuadrados. Pies cuadrados—La unidad será pies cuadrados. Yardas cuadradas—La unidad será yardas cuadradas. Millas cuadradas—La unidad será millas cuadradas.	String
Campo de grupo (Opcional)	Campo de atributo de las entidades de resumen de entrada que se utiliza 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 especifica 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 especificado el valor del parámetro Campo de grupo. Desactivado: los campos de minoría y mayoría no se agregarán a la salida. Esta es la opción predeterminada. Activado: los campos de minoría y mayoría se agregarán a la salida.	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 especificado el valor del parámetro Campo de grupo. Desactivado: no se agregará un campo de atributo de porcentaje a la salida. Esta es la opción predeterminada. Activado: se agregará un campo de atributo de porcentaje a la salida.	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: Join_ID—Id. correspondiente a un campo de Id. agregado a la clase de entidad de salida El campo de grupo Un campo de resumen de forma Un campo para cada uno de los campos de resumen Campo de porcentaje Este parámetro se requiere cuando se especifica el valor del parámetro Campo de grupo.	Table

Python

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 utilizan 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, con atributos nuevos para el número de puntos, la longitud de las líneas, el área de los polígonos dentro de cada polígono de entrada y estadísticas sobre dichas 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 contengan al menos un punto de entrada. KEEP_ALL—Se copiarán todos los polígonos de entrada en la clase de entidad de salida. Esta es la opción predeterminada. ONLY_INTERSECTING—Se copiarán solo los polígonos de entrada que 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: Suma: valor total de todos los puntos de cada polígono que se calculará. Media: media de todos los puntos de cada polígono que se calculará. Mínimo: valor más pequeño de todos los puntos de cada polígono que se identificará. Máximo: valor más grande de todos los puntos de cada polígono que se identificará. Stddev: desviación estándar de todos los puntos de cada polígono que se calculará.	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 entrada se agregarán a la salida. ADD_SHAPE_SUM—Los atributos de resumen de forma se agregarán a la clase de entidad de salida. Esta es la opción predeterminada. NO_SHAPE_SUM—Los atributos de resumen de forma no se agregarán a la clase de entidad de salida.	Boolean
shape_unit (Opcional)	Unidad que se utilizará al calcular los 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. METERS—La unidad será metros. KILOMETERS—La unidad será kilómetros. FEET—La unidad será pies. YARDS—La unidad será yardas. MILES—La unidad será millas. ACRES—La unidad será acres. HECTARES—La unidad será hectáreas. SQUAREMETERS—La unidad será metros cuadrados. SQUAREKILOMETERS—La unidad será kilómetros cuadrados. SQUAREFEET—La unidad será pies cuadrados. SQUAREYARDS—La unidad será yardas cuadradas. SQUAREMILES—La unidad será millas cuadradas.	String
group_field (Opcional)	Campo de atributo de las entidades de resumen de entrada que se utiliza 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 especifica 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 especificado el valor del parámetro group_field. NO_MIN_MAJ—Los campos de minoría y mayoría no se agregarán a la salida. Esta es la opción predeterminada. ADD_MIN_MAJ—Los campos de minoría y mayoría se agregarán a la salida.	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 especificado el valor del parámetro group_field. NO_PERCENT—No se agregará un campo de atributo de porcentaje a la salida. Esta es la opción predeterminada. ADD_PERCENT—Se agregará un campo de atributo de porcentaje a la salida.	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: Join_ID—Id. correspondiente a un campo de Id. agregado a la clase de entidad de salida El campo de grupo Un campo de resumen de forma Un campo para cada uno de los campos de resumen Campo de porcentaje Este parámetro se requiere cuando se especifica el valor del parámetro group_field.	Table

Muestra de código

Ejemplo 1 de SummarizeWithin (ventana de Python)

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')

Ejemplo 2 de SummarizeWithin (secuencia de comandos independiente)

El siguiente script independiente es un ejemplo de cómo utilizar la función SummarizeWithin en un entorno de scripts.

# 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

Sistema de coordenadas de salida, Extensión, Espacio de trabajo actual, Espacio de trabajo temporal, La salida tiene valores Z, Resolución Z, Valor Z de salida predeterminado, Transformaciones geográficas, Dominio XY de salida, Dominio Z de salida, Resolución XY, Tolerancia XY, Tolerancia Z

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí