Resumir dentro de (Standard Feature Analysis)

Resumen

Busca las entidades de punto, de línea o poligonales (o partes de estas entidades) que están dentro de los límites de los polígonos de otra capa.

Por ejemplo

  • 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

Ilustración de Resumir dentro de

Uso

  • La opción Resumir dentro de es similar a tomar dos capas y apilarlas una encima de la otra. Imagine que las entidades de una de las capas, la capa de polígonos de entrada, tienen todas color rojo. La otra capa, con las entidades de resumen de entrada, puede contener cualquier tipo de entidad: de punto, de línea o poligonal. Después de apilar estas capas una sobre otra, puede examinar la pila y contar el número de entidades de la capa de entidades de resumen de entrada que están dentro de los polígonos con los límites rojos (los polígonos de entrada). No solo puede contar el número de entidades: también puede calcular estadísticas simples sobre los atributos de las entidades de la capa de entidades de resumen de entrada, como la suma, el valor medio, el mínimo, el máximo, etcétera.

Parámetros

EtiquetaExplicaciónTipo de datos
Polígonos de entrada

Se resumirán las entidades o partes de las entidades de resumen de entrada que están dentro de los límites de estos polígonos.

Feature Set
Entidades de resumen de entrada

Las entidades de punto, de línea o poligonales que se van a resumir para cada polígono de entrada.

Feature Set
Nombre de salida

El nombre de la capa de salida que se debe crear en el portal.

String
Agregar atributos de resumen de forma
(Opcional)

Calcula las estadísticas en función de la forma de las entidades de resumen de entrada, como la longitud de las líneas o las áreas de los polígonos de las entidades de resumen de entrada contenidas dentro de cada polígono de entrada.

  • Activado: calcula los atributos de resumen de forma. Esta es la opción predeterminada.
  • Desactivado: no calcula los atributos de resumen de forma.

Boolean
Unidad de forma
(Opcional)

Si desea resumir la forma de las entidades de resumen de entrada, especifique las unidades del resumen de forma.

Cuando las entidades de resumen de entrada son polígonos, las opciones válidas son acres, hectáreas, metros cuadrados, kilómetros cuadrados, pies cuadrados, yardas cuadradas y millas cuadradas.

Cuando las entidades de resumen de entrada son líneas, las opciones válidas son metros, kilómetros, pies, yardas y millas.

  • MillasMillas
  • PiesPies
  • KilómetrosKilómetros
  • MetrosMetros
  • YardasYardas
  • AcresAcres
  • HectáreasHectáreas
  • Metros cuadradosMetros cuadrados
  • Kilómetros cuadradosKilómetros cuadrados
  • Pies cuadradosPies cuadrados
  • Yardas cuadradasYardas cuadradas
  • Millas cuadradasMillas cuadradas
String
Campos de resumen
(Opcional)

Una lista de los nombres de campos y del tipo de resumen estadístico que desea calcular para todos los puntos de cada polígono. Siempre se devuelve el recuento de puntos de cada polígono. Se admiten los siguientes tipos de estadísticas:

  • Suma: el valor total.
  • Mínimo: el valor más bajo.
  • Máximo: el valor más alto.
  • Media: media o valor medio.
  • Desviación estándar: la desviación estándar.

Value Table
Agrupar por campo
(Opcional)

Este es un campo de las entidades de resumen de entrada que puede utilizar para calcular por separado las estadísticas de cada valor de atributo único. Por ejemplo, supongamos que 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
Agregar atributos de minoría y mayoría
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si está activado, se calculan los valores de atributo que son minoría (menos dominantes) o los que son mayoría (más dominantes) para cada campo de grupo en cada límite. Se agregan a la capa de salida dos nuevos campos con el prefijo Majority_ y Minority_.

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

Boolean
Agregar porcentajes de grupo
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si está activado, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada.

  • Desactivado: no agrega los campos de porcentaje. Esta es la opción predeterminada.
  • Activado: agrega los campos de porcentaje.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Servicio de entidades de salida

Capa resumida de salida.

Conjunto de entidades
Tabla de grupo de salida

Si se ha proporcionado un campo de agrupación, la herramienta generará una tabla que contiene las estadísticas calculadas para cada grupo único.

Conjunto de registros

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
NombreExplicaciónTipo de datos
sumWithinLayer

Se resumirán las entidades o partes de las entidades de resumen de entrada que están dentro de los límites de estos polígonos.

Feature Set
summaryLayer

Las entidades de punto, de línea o poligonales que se van a resumir para cada polígono de entrada.

Feature Set
outputName

El nombre de la capa de salida que se debe crear en el portal.

String
sumShape
(Opcional)

Calcula las estadísticas en función de la forma de las entidades de resumen de entrada, como la longitud de las líneas o las áreas de los polígonos de las entidades de resumen de entrada contenidas dentro de cada polígono de entrada.

  • ADD_SHAPE_SUMCalcula los atributos de resumen de forma. Esta es la opción predeterminada.
  • NO_SHAPE_SUMNo calcula los atributos de resumen de forma.
Boolean
shapeUnits
(Opcional)

Si desea resumir la forma de las entidades de resumen de entrada, especifique las unidades del resumen de forma.

Cuando las entidades de resumen de entrada son polígonos, las opciones válidas son acres, hectáreas, metros cuadrados, kilómetros cuadrados, pies cuadrados, yardas cuadradas y millas cuadradas.

Cuando las entidades de resumen de entrada son líneas, las opciones válidas son metros, kilómetros, pies, yardas y millas.

  • MILESMillas
  • FEETPies
  • KILOMETERSKilómetros
  • METERSMetros
  • YARDSYardas
  • ACRESAcres
  • HECTARESHectáreas
  • SQUAREMETERSMetros cuadrados
  • SQUAREKILOMETERSKilómetros cuadrados
  • SQUAREFEETPies cuadrados
  • SQUAREYARDSYardas cuadradas
  • SQUAREMILESMillas cuadradas
String
summaryFields
[[Field, Statistic],...]
(Opcional)

Una lista de los nombres de campos y del tipo de resumen estadístico que desea calcular para todos los puntos de cada polígono. Siempre se devuelve el recuento de puntos de cada polígono. Se admiten los siguientes tipos de estadísticas:

  • SUM: el valor total.
  • MIN: el valor más bajo.
  • MAX: el valor más alto.
  • MEAN: media o valor medio.
  • STD: la desviación estándar.

Value Table
groupByField
(Opcional)

Este es un campo de las entidades de resumen de entrada que puede utilizar para calcular por separado las estadísticas de cada valor de atributo único. Por ejemplo, supongamos que 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
minorityMajority
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si especifica ADD_MIN_MAJ, se calculan los valores de atributo que son minoría (menos dominantes) o los que son mayoría (más dominantes) para cada campo de grupo en cada límite. Se agregan a la capa de salida dos nuevos campos con el prefijo Majority_ y Minority_.

  • NO_MIN_MAJNo agrega los campos de minoría y mayoría. Esta es la opción predeterminada.
  • ADD_MIN_MAJAgrega los campos de minoría y mayoría.
Boolean
percentShape
(Opcional)

Esto solo se aplica cuando se usa un campo de agrupación. Si está activado, se calcula el porcentaje de cada valor de grupo único para cada polígono de entrada.

  • NO_PERCENTNo agrega los campos de porcentaje. Esta es la opción predeterminada.
  • ADD_PERCENTAgrega los campos de porcentaje.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
outputLayer

Capa resumida de salida.

Conjunto de entidades
groupBySummaryLayer

Si se ha proporcionado un campo de agrupación, la herramienta generará una tabla que contiene las estadísticas calculadas para cada grupo único.

Conjunto de registros

Entornos

Casos especiales

Información de licenciamiento

  • Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
  • Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis

Temas relacionados