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.

A continuación, se muestran escenarios de ejemplo en los que se utiliza la opción Resumir dentro de:

  • Si tiene una capa de límites de cuencas hidrográficas y una capa de límites de uso del suelo, puede calcular la superficie total del tipo de uso del suelo para cada cuenca hidrográfica.
  • Si tiene una capa de parcelas de un condado y una capa de límites de ciudades, puede resumir el valor medio de las parcelas vacías en cada límite de ciudad.
  • Si tiene una capa de condados y una capa de carreteras, puede resumir el kilometraje total de las carreteras por tipo de carretera en cada condado.

Ilustración

Ilustración de la herramienta Resumir dentro de

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.

  • 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 Crime_type único.

  • Los valores nulos se excluyen de todos los cálculos estadísticos. Por ejemplo, el promedio de 10, 5 y valor nulo es 7,5 ((10+5)/2).

Parámetros

EtiquetaExplicaciónTipo 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 adicionales nuevos 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 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 de entrada se agregarán a la clase de entidad de 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)

Especifica la 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.

  • MetrosLa unidad será metros.
  • KilómetrosLa unidad será kilómetros.
  • PiesLa unidad será pies.
  • YardasLa unidad será yardas.
  • MillasLa unidad será millas.
  • AcresLa unidad será acres.
  • HectáreasLa unidad será hectáreas.
  • Metros cuadradosLa unidad será metros cuadrados.
  • Kilómetros cuadradosLa unidad será kilómetros cuadrados.
  • Pies cuadradosLa unidad será pies cuadrados.
  • Yardas cuadradasLa unidad será yardas cuadradas.
  • Millas cuadradasLa 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 campo de resumen
  • Campo de porcentaje

Este parámetro se requiere cuando se especifica el valor del parámetro Campo de grupo.

Table

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})
NombreExplicaciónTipo 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 adicionales nuevos 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 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 una entidad de resumen de entrada.

  • KEEP_ALLSe copiarán todos los polígonos de entrada en la clase de entidad de salida. Esta es la opción predeterminada.
  • ONLY_INTERSECTINGSe 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 de entrada se agregarán a la clase de entidad de salida.

  • ADD_SHAPE_SUMLos atributos de resumen de forma se agregarán a la clase de entidad de salida. Esta es la opción predeterminada.
  • NO_SHAPE_SUMLos atributos de resumen de forma no se agregarán a la clase de entidad de salida.
Boolean
shape_unit
(Opcional)

Especifica la 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.

  • METERSLa unidad será metros.
  • KILOMETERSLa unidad será kilómetros.
  • FEETLa unidad será pies.
  • YARDSLa unidad será yardas.
  • MILESLa unidad será millas.
  • ACRESLa unidad será acres.
  • HECTARESLa unidad será hectáreas.
  • SQUAREMETERSLa unidad será metros cuadrados.
  • SQUAREKILOMETERSLa unidad será kilómetros cuadrados.
  • SQUAREFEETLa unidad será pies cuadrados.
  • SQUAREYARDSLa unidad será yardas cuadradas.
  • SQUAREMILESLa 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_MAJLos campos de minoría y mayoría no se agregarán a la salida. Esta es la opción predeterminada.
  • ADD_MIN_MAJLos 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_PERCENTNo se agregará un campo de atributo de porcentaje a la salida. Esta es la opción predeterminada.
  • ADD_PERCENTSe 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 campo 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)

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)

Información de licenciamiento

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

Temas relacionados