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

Ilustración de la herramienta 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

  • En otras palabras, la herramienta 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. Puede ver 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 atributos ponderados geográficamente de líneas que hay dentro de un polígono, o los atributos 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.

  • Las estadísticas estándar y las estadísticas ponderadas geográficamente se pueden calcular para atributos que representen recuentos o tasas. Se definen de la siguiente manera:

    • Recuentos: atributos que representan una suma o cantidad de una entidad en una ubicación de punto, a lo largo de una línea o dentro de un polígono. Algunos ejemplos de atributos de tipo recuento son la población de un país, la cantidad de recogidas de taxi en un bloque censal y la cantidad de presas a lo largo de un río. Para las entidades de línea y poligonales, los recuentos se proporcionan antes de calcular las estadísticas estándar o ponderadas.
    • Tasas: atributos que representan un ratio o un índice en una ubicación de punto, a lo largo de una línea o dentro de un polígono. Entre los ejemplos de atributos de tipo de tasa se incluyen la densidad de población de un país, el límite de velocidad de una carretera o la puntuación de accesibilidad a pie de un vecindario. Las tasas no se proporcionan nunca.

    Para los atributos de tipo de recuento, los valores se proporcionan según la cantidad de la línea dentro de un polígono o la cantidad del polígono dentro de otro polígono antes de calcular las estadísticas. Las estadísticas se calculan de la misma manera para los atributos de tipo de recuento y de tipo de tasa cuando las entidades de resumen son puntos.

  • 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 entradaDescripciónOpción

    Puntos

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

    Ninguna

    Líneas

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

    • Millas terrestres
    • Yardas internacionales
    • Pies internacionales
    • Millas de agrimensura de EE. UU.
    • Yardas de agrimensura de EE. UU.
    • Pies de agrimensura de EE. UU.
    • Kilómetros
    • Metros

    Áreas

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

    • Millas terrestres cuadradas
    • Yardas cuadradas internacionales
    • Pies cuadrados internacionales
    • Kilómetros cuadrados
    • Metros cuadrados
    • Hectáreas
    • Acres internacionales
    • Millas cuadradas de agrimensura de EE. UU.
    • Yardas cuadradas de agrimensura de EE. UU.
    • Pies cuadrados de agrimensura de EE. UU.
    • Acres topográficos de EE. UU.
  • 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 aplicarán a los datos de las entidades del valor del parámetro 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 entidades del valor del parámetro Polígonos de resumen que se intersecan con cada entidad del valor del parámetro 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 tres estadísticas ponderadas que se calculan según los campos numéricos de la capa que se va a resumir: valor medio, desviación estándar y varianza.

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

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

  • Puede proporcionar un valor Agrupar por campo para que las estadísticas se calculen por separado para cada valor de atributo único. Si se proporciona un valor de Agrupar por campo, se creará 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 proporciona el valor Agrupar por campo. La minoría y la mayoría serán los valores menos y más dominantes del parámetro 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.

  • 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 punto
    Se muestran el punto de entrada y las entidades poligonales (la primera imagen) y las entidades de área resultantes (la segunda imagen).

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

    Nombre de campoDescripción
    count

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

    sum_length_<linearunit>, o bien, 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, el máximo y la desviación 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 activa 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 en un 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 es rojo.

    majority_<fieldname>

    Este valor se devuelve cuando crea una tabla Agrupar por y activa 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 en un 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 es azul;verde.

    minority_<fieldname>_percent

    Este valor se devuelve cuando crea una tabla Agrupar por y se activa 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 en un 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 es 20 (calculado como 1/5).

    majority_<fieldname>_percent

    Este valor se devuelve cuando crea una tabla Agrupar por y se activa 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 en un 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 es 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 campoDescripción

    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 en un 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 las siguientes acciones:

    • Defina el entorno de extensión de forma que solo se analizarán datos de interés.
    • Los bins mayores funcionarán mejor que los pequeños. Si utiliza bins y no tiene claro qué tamaño utilizar, empiece con un bin más grande para hacer un 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 su ArcGIS GeoAnalytics Server para 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 AllSource.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa resumida

Las entidades de punto, de línea o poligonales que se van a resumir por polígonos o por bins.

Feature Layer
Clase de entidad de salida

El nombre de la clase de entidad de salida que contendrá las geometrías que se intersecan y los atributos.

Feature Class
Polígono o bin

Especifica si el valor Capa resumida se resumirá por polígonos o por bins.

  • PolígonoLa capa resumida se consolidará en un dataset de polígonos.
  • BinLa capa resumida se consolidará en bins cuadrados o hexagonales que se generan cuando se ejecuta la herramienta.
String
Tipo de bin

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

  • CuadradoEl valor Tamaño de bin representa la altura de un cuadrado. Esta es la opción predeterminada.
  • HexágonoEl valor Tamaño de bin representa la altura entre dos lados paralelos.
String
Tamaño de bin
(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
Polígonos de resumen
(Opcional)

Los polígonos que se utilizarán para resumir las entidades en la capa resumida de entrada.

Feature Layer
Agregar atributos de resumen de forma

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.

  • Activado: se calcularán los valores de la forma de resumen. Esta es la opción predeterminada.
  • Desactivado: no se calcularán los valores de la forma de resumen.

Boolean
Unidades de forma
(Opcional)

Especifica la unidad de medida que se utilizará para calcular 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.

  • MetrosLas unidades de forma serán metros de agrimensura de EE. UU.
  • KilómetrosLas unidades de forma serán kilómetros de agrimensura de EE. UU.
  • Pies de agrimensura de EE. UU.Las unidades de forma serán pies de agrimensura de EE. UU.
  • Yardas de agrimensura de EE. UU.Las unidades de forma serán yardas de agrimensura de EE. UU.
  • Millas de agrimensura de EE. UU.Las unidades de forma serán millas de agrimensura de EE. UU.
  • Millas náuticas topográficas de EE. UU.Las unidades de forma serán millas náuticas de agrimensura de EE. UU.
  • Pies internacionalesLas unidades de forma serán pies internacionales.
  • Yardas internacionalesLas unidades de forma serán yardas internacionales.
  • Millas terrestresLas unidades de forma serán millas terrestres.
  • Millas náuticas internacionalesLas unidades de forma serán millas náuticas internacionales.
  • Acres internacionalesLas unidades de forma serán acres internacionales.
  • HectáreasSe usarán las hectáreas como unidades de forma.
  • Metros cuadradosSe usarán los metros cuadrados como unidades de forma.
  • Kilómetros cuadradosSe usarán los kilómetros cuadrados como unidades de forma.
  • Pies cuadrados internacionalesLas unidades de forma serán pies cuadrados internacionales.
  • Yardas cuadradas internacionalesLas unidades de forma serán yardas cuadradas internacionales.
  • Millas terrestres cuadradasLas unidades de forma serán millas terrestres cuadradas.
  • Pies cuadrados de agrimensura de EE. UU.Las unidades de forma serán pies cuadrados de agrimensura de EE. UU.
  • Yardas cuadradas de agrimensura de EE. UU.Las unidades de forma serán yardas cuadradas de agrimensura de EE. UU.
  • Millas cuadradas de agrimensura de EE. UU.Las unidades de forma serán millas cuadradas de agrimensura de EE. UU.
  • Acres topográficos de EE. UU.Las unidades de forma serán acres topográficos de EE. UU.
String
Campos de resumen estándar
(Opcional)

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

Especifica si un campo representa un recuento o una tasa.

  • RecuentoPara las capas de líneas y polígonos, los valores de campo resumidos se proporcionarán según el porcentaje de las entidades resumidas que intersecan los polígonos de resumen antes de calcular las estadísticas. Los valores no se proporcionan para las capas de puntos.
  • VelocidadLos valores de campo resumidos no se proporcionarán. Los valores de campo sin procesar se utilizarán para calcular estadísticas.
Value Table
Campos de resumen ponderados
(Opcional)

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

Especifica si un campo representa un recuento o una tasa.

  • Valor medioSe calculará el valor medio ponderado de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • Desviación estándarSe calculará la desviación estándar ponderada de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • VarianzaSe calculará la varianza ponderada de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • RecuentoLos valores de campo resumidos se proporcionarán según el porcentaje de las entidades resumidas que intersecan los polígonos de resumen antes de calcular las estadísticas.
  • VelocidadLos valores de campo resumidos no se proporcionarán. Los valores de campo sin procesar se utilizarán para calcular estadísticas.
Value Table
Agrupar por campo
(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 empresas 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
Agregar atributos de minoría y mayoría
(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. Cuando se activa este parámetro, se agregan a la capa de salida dos nuevos campos con los prefijos Minority_ y Majority_. Este parámetro solo se aplica si se proporciona un valor para el parámetro Agrupar por campo.

  • Desactivado: los campos de minoría y mayoría no se agregarán. Esta es la opción predeterminada.
  • Activado: los campos de minoría y mayoría se agregarán.

Boolean
Agregar porcentajes de grupo
(Opcional)

Especifica si se agregarán campos de porcentaje. Si este parámetro está activado, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada. Este parámetro solo se aplica cuando se proporciona un valor para el parámetro Agrupar por campo y se especifica un valor para el parámetro Agregar atributos de minoría y mayoría.

  • Desactivado: no se agregarán campos de porcentaje. Esta es la opción predeterminada.
  • Activado: se agregarán campos de porcentaje.

Boolean
Agrupar por tabla de resumen
(Opcional)

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

Table

arcpy.geoanalytics.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})
NombreExplicació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 el valor 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.

  • SQUAREEl valor bin_size representa la altura de un cuadrado. Esta es la opción predeterminada.
  • HEXAGONEl valor bin_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 utilizarán 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 de medida que se utilizará para calcular atributos de resumen de forma. Si el valor de summarized_layer de entrada es puntos, no es necesaria ninguna unidad de forma, dado que solo se agrega el recuento de puntos dentro 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.
  • FEETLas unidades de forma serán pies de agrimensura de EE. UU.
  • YARDSLas unidades de forma serán yardas de agrimensura de EE. UU.
  • MILESLas unidades de forma serán millas de agrimensura de EE. UU.
  • NAUTICAL_MILESLas unidades de forma serán millas náuticas de agrimensura de EE. UU.
  • FEET_INTLas unidades de forma serán pies internacionales.
  • YARDS_INTLas unidades de forma serán yardas internacionales.
  • MILES_INTLas unidades de forma serán millas terrestres.
  • NAUTICAL_MILES_INTLas unidades de forma serán millas náuticas internacionales.
  • ACRESLas unidades de forma serán acres internacionales.
  • 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_FEETLas unidades de forma serán pies cuadrados internacionales.
  • SQUARE_YARDSLas unidades de forma serán yardas cuadradas internacionales.
  • SQUARE_MILESLas unidades de forma serán millas terrestres cuadradas.
  • SQUARE_FEET_USLas unidades de forma serán pies cuadrados de agrimensura de EE. UU.
  • SQUARE_YARDS_USLas unidades de forma serán yardas cuadradas de agrimensura de EE. UU.
  • SQUARE_MILES_USLas unidades de forma serán millas cuadradas de agrimensura de EE. UU.
  • ACRES_USLas unidades de forma serán acres topográficos de EE. UU.
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. El valor medio 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ínimos 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.

Especifica si un campo representa un recuento o una tasa.

  • COUNTPara las capas de líneas y polígonos, los valores de campo resumidos se proporcionarán según el porcentaje de las entidades resumidas que intersecan los polígonos de resumen antes de calcular las estadísticas. Los valores no se proporcionan para las capas de puntos.
  • RATELos valores de campo resumidos no se proporcionarán. Los valores de campo sin procesar se utilizarán para calcular estadísticas.
Value Table
weighted_summary_fields
[weighted_summary_fields,...]
(Opcional)

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

  • MEANSe calculará el valor medio ponderado de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • STDDEVSe calculará la desviación estándar ponderada de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.
  • VARSe calculará la varianza ponderada de cada campo, donde la ponderación aplicada es la proporción de la capa resumida dentro de los polígonos.

Especifica si un campo representa un recuento o una tasa.

  • CountLos valores de campo resumidos se proporcionarán según el porcentaje de las entidades resumidas que intersecan los polígonos de resumen antes de calcular las estadísticas.
  • RateLos valores de campo resumidos no se proporcionarán. Los valores de campo sin procesar se utilizarán para calcular estadísticas.
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 empresas 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. Cuando el valor de este parámetro es ADD_MIN_MAJ, se agregan a la capa de salida dos nuevos campos con los prefijos Minority_ y Majority_. Este parámetro solo se aplica si se proporciona un valor para 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. Si el valor de este parámetro es ADD_PERCENT, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada. Este parámetro solo se aplica cuando se proporciona un valor para el parámetro group_by_field y se especifica un valor para el parámetro 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 función 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", "RATE"]]
weightedSummaryStatistics = [["DOC", "STDDEV", "COUNT"]]
out = 'SummarizedRivers'


# Run SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None, 
                            None, summaryPolys, "ADD_SUMMARY", 
                            "KILOMETERS", summaryStatistics, 
                            weightedSummaryStatistics)