Resumir dentro de (GeoAnalytics Desktop)

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 sobre 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

Resumir dentro de
Ejemplos de resumen de puntos dentro de polígonos (primera fila), líneas dentro de polígonos (segunda fila) y polígonos dentro de polígonos (tercera fila)

Uso

  • Dicho de un modo más sencillo, 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.

  • 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 valores ponderados geográficamente de la proporción de líneas que hay dentro de un polígono o la proporción 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.

  • 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 entradaDescriptionOpción

    Puntos

    El recuento de los puntos resumidos dentro de cada polígono.

    Nada

    Lines

    La longitud de las líneas resumidas dentro de cada polígono.

    • Millas
    • Yardas
    • Pies
    • Kilómetros
    • Metros

    Áreas

    El área de polígonos resumidos dentro de cada polígono.

    • Millas cuadradas
    • Yardas cuadradas
    • Pies cuadrados
    • Kilómetros cuadrados
    • Metros cuadrados
    • Hectáreas
    • Acres
  • Si lo desea, puede calcular estadísticas estándar. 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 aplican a los datos de las entidades de la 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 los Polígonos de resumen que se interseca con cada entidad de la 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 seis estadísticas ponderadas que se calculan según los campos numéricos de la capa que se va a resumir: recuento, suma, valor medio, mínimo, máximo y rango.

  • Las estadísticas ponderadas no se calculan para los datos de cadena de caracteres. Cada vez que se especifica un Campo y una 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 Polígonos de resumen siempre se calcula.

  • El análisis con agrupamiento en bins requiere que su entrada esté proyectada o que el sistema de coordenadas de salida esté establecido como un sistema de coordenadas proyectadas. Si sus 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.

  • Opcionalmente, se puede seleccionar un valor de Agrupar por campo para que las estadísticas se calculen por separado para cada valor de atributo único. Si se selecciona un valor de Agrupar por campo, se crea 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 selecciona el valor Agrupar por campo. La minoría y la mayoría serán los valores menos y más dominantes de 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.

  • Para las estadísticas ponderadas, las capas de líneas se resumen usando únicamente las proporciones de las entidades de línea contenidas dentro de los Polígonos de resumen. Las estadísticas estándar (no ponderadas) resumen cualquier línea que se interseca con los Polígonos de resumen. Cuando se resumen líneas mediante estadísticas ponderadas, utilice recuentos y cantidades (en lugar de tasas e índices) para que los cálculos proporcionales tengan lógica en su análisis.

  • Las estadísticas ponderadas de las capas de área resumidas se basan en las proporciones de las entidades de Polígonos de resumen que se encuentran dentro de la Capa de resumen. Cuando se resumen áreas, utilice recuentos y cantidades (en lugar de tasas e índices) para que los cálculos proporcionales tengan lógica en su análisis.

  • 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.

    Polígonos devueltos con entidades de puntos
    Se muestran el punto de entrada y las entidades poligonales (izquierda) y las entidades de área resultantes (derecha).

  • En las entidades poligonales de salida se incluyen los siguientes campos:

    Nombre de campoDescription
    count

    El recuento de entidades resumidas que intersecan cada capa de polígonos.

    sum_length_<linearunit> o 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, la desviación máxima y 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 selecciona 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 dentro de cada 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 será rojo.

    majority_<fieldname>

    Este valor se devuelve cuando crea una tabla Agrupar por y selecciona 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 dentro de cada 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 será azul;verde.

    minority_<fieldname>_percent

    Este valor se devuelve cuando crea una tabla Agrupar por y selecciona 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 dentro de cada 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 será 20 (calculado como 1/5).

    majority_<fieldname>_percent

    Este valor se devuelve cuando crea una tabla Agrupar por y selecciona 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 dentro de cada 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 será 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 campoDescription

    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 dentro de cada 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 estas sugerencias:

    • Defina el entorno de extensión para analizar únicamente datos de interés.
    • Si utiliza bins, los bins mayores funcionarán mejor que los pequeños. Si no sabe qué tamaño utilizar, comience con un bin mayor como 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 ArcGIS GeoAnalytics Server con el fin de 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.

Sintaxis

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})
ParámetroExplicaciónTipo 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 summarized_layer se resumirá por polígonos o por bins.

  • POLYGONLa capa resumida se consolidará en un dataset de polígonos.
  • BINLa capa resumida se consolidará en bins cuadrados o hexagonales.
String
bin_type

Especifica la forma del bin que se generará para resumir entidades.

  • SQUAREbin_size representa la altura de un cuadrado. Esta es la opción predeterminada.
  • HEXAGONbin_size representa la altura entre dos lados paralelos.
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 utilizan 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.

  • ADD_SUMMARYSe calcularán los valores de la forma de resumen. Esta es la opción predeterminada.
  • NO_SUMMARYNo se calcularán los valores de la forma de resumen.
Boolean
shape_units
(Opcional)

Especifica la unidad que se va a utilizar para calcular atributos de resumen de forma. Si la summarized_layer de entrada es de 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.

  • METERSSe usarán los metros como unidades de forma.
  • KILOMETERSSe usarán los kilómetros como unidades de forma.
  • FEETSe usarán los pies como unidades de forma.
  • YARDSSe usarán las yardas como unidades de forma.
  • MILESSe usarán las millas como unidades de forma.
  • ACRESSe usarán los acres como unidades de forma.
  • HECTARESSe usarán las hectáreas como unidades de forma.
  • SQUARE_METERSSe usarán los metros cuadrados como unidades de forma.
  • SQUARE_KILOMETERSSe usarán los kilómetros cuadrados como unidades de forma.
  • SQUARE_FEETSe usarán los pies cuadrados como unidades de forma.
  • SQUARE_YARDSSe usarán las yardas cuadradas como unidades de forma.
  • SQUARE_MILESSe usarán las millas cuadradas como unidades de forma.
String
standard_summary_fields
[standard_summary_fields,...]
(Opcional)

Las estadísticas que se calcularán en campos concretos.

  • COUNT: el número de valores no nulos. Se puede usar en campos numéricos o de cadenas de caracteres. El recuento de [null, 0, 2] es 2.
  • SUM: la suma de valores numéricos en un campo. La suma de [null, null, 3] es 3.
  • MEAN: el valor medio de los valores numéricos. La media de [0,2, null] es 1.
  • MIN: el valor mínimo de un campo numérico. El mínimo de [0, 2, null] es 0.
  • MAX: el valor máximo de un campo numérico. El valor máximo de [0, 2, null] es 2.
  • STDDEV: la desviación estándar de un campo numérico. La desviación estándar de [1] es null. La desviación estándar de [null, 1,1,1] es null.
  • VAR: la varianza de un campo numérico en un recorrido. La varianza de [1] es null. La varianza de [null, 1,1,1] es null.
  • RANGE: el rango de un campo numérico. Se calcula como el valor mínimo restado del valor máximo. El rango de [0, null, 1] es 1. El rango de [null, 4] es 0.
  • ANY: una cadena de caracteres de un campo de tipo cadena de caracteres.

Value Table
weighted_summary_fields
[weighted_summary_fields,...]
(Opcional)

Especifica las estadísticas ponderadas que se calcularán en campos concretos.

  • COUNTSe calculará el recuento de cada campo multiplicado por la proporción de la capa resumida dentro de los polígonos.
  • SUMSe calculará la suma de valores ponderados de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • MEANSe calculará el valor medio de los valores ponderados de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • MINSe calculará el mínimo de los valores ponderados de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • MAXSe calculará el máximo de los valores ponderados de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • RANGESe calculará la diferencia entre MIN y MAX.
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 compañías 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. En caso afirmativo, se agregan a la capa de salida dos nuevos campos con el prefijo Majority_ y Minority_. Este parámetro solo se aplica si se usa el parámetro group_by_field.

  • 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
add_percentages
(Opcional)

Especifica si se agregarán campos de porcentaje. En caso afirmativo, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada. Este parámetro solo se aplica si se usan los parámetros group_by_field y add_minority_majority.

  • NO_PERCENTNo se agregarán campos de porcentaje. Esta es la opción predeterminada.
  • ADD_PERCENTSe agregarán campos de porcentaje.
Boolean
group_by_summary
(Opcional)

La tabla de salida que contendrá los grupos por resúmenes.

Table

Muestra de código

Ejemplo de SummarizeWithin (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta 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'
# Execute 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í

Temas relacionados