Resumir dentro de (Geoanálisis)

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
Se muestran 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.

  • Con ArcGIS Enterprise 10.6.1 y posteriores, puede calcular un grupo mediante el parámetro Agrupar por campo. Esto creará una salida tabular, además de la capa de polígonos resumida.

  • 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 ArcGIS GeoAnalytics Server. El análisis se completa en su GeoAnalytics Server y los resultados se almacenan en su contenido en ArcGIS Enterprise.

  • Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para su GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Por lo tanto, se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.

    Más información acerca del uso compartido de datos en el portal

    Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager

  • 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.geoanalytics.SummarizeWithin(summarized_layer, output_name, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {data_store}, {group_by_field}, {add_minority_majority}, {add_percentages})
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 Set
output_name

El nombre del servicio de entidades poligonales de salida que contiene las geometrías que se intersecan y los atributos.

String
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 Set
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
data_store
(Opcional)

Especifica el ArcGIS Data Store en el que se guardará la salida. La predeterminada es SPATIOTEMPORAL_DATA_STORE. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.

  • SPATIOTEMPORAL_DATA_STORELa salida se almacenará en un big data store espaciotemporal. Esta es la opción predeterminada.
  • RELATIONAL_DATA_STORELa salida se almacenará en un data store relacional.
String
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

Salida derivada

NombreExplicaciónTipo de datos
output

El número resumido de puntos, longitud de las líneas o área de los polígonos dentro de cada polígono.

Conjunto de entidades
group_by_summary

Si se indica Agrupar por resumen, la herramienta generará una tabla con las estadísticas calculadas para cada grupo único.

Conjunto de registros

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.
#			
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
summarizedLayer = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Water/BigDataCatalogServer/Rivers"
summaryPolys = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Boundaries/BigDataCatalogServer/Counties"
summaryStatistics = ["Width", "MEAN"]
weighedSummaryStatistics = ["DOC", "SUM"]
outFS = 'SummarizedRivers'
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute SummarizeWithin
arcpy.geoanalytics.SummarizeWithin(summarizedLayer, outFS, "POLYGON", None, 
                                   None, summaryPolys,"ADD_SUMMARY", 
                                   "KILOMETERS", summaryStatistics, 
                                   weightedSummaryStatistics, dataStore)

Entornos

Sistema de coordenadas de salida

El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. Para las GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.

Información de licenciamiento

  • Basic: Requiere ArcGIS GeoAnalytics Server
  • Standard: Requiere ArcGIS GeoAnalytics Server
  • Advanced: Requiere ArcGIS GeoAnalytics Server

Temas relacionados