Resumir dentro de (Standard Feature Analysis)

Resumen

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

A continuación se ofrecen escenarios de uso de ejemplo de esta herramienta:

  • Para una capa de límites de cuencas hidrográficas y una capa de 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.
  • Para una capa de parcelas de un condado y una capa de límites de ciudad, resuma el valor medio de las parcelas vacías dentro de los límites de cada ciudad.
  • Para una capa de condados y una capa de 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

Uso

  • Usar esta herramienta es como tomar dos capas y apilarlas una encima de la otra. Por ejemplo, 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 entidades del valor del parámetro 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 creará en su portal.

String
Agregar atributos de resumen de forma
(Opcional)

Especifica si las estadísticas se calcularán en función de la forma del valor del parámetro 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 dentro de cada polígono de entrada.

  • Activado: las estadísticas se calcularán en función de los atributos de resumen de forma. Esta es la opción predeterminada.
  • Desactivado: las estadísticas no se calcularán en función de los atributos de resumen de forma.

Boolean
Unidad de forma
(Opcional)

Especifica las unidades que se utilizarán para el 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 millas, pies, kilómetros, metros y yardas.

  • MillasLas unidades serán millas.
  • PiesLas unidades serán pies.
  • KilómetrosLas unidades serán kilómetros.
  • MetrosLas unidades serán metros.
  • YardasLas unidades serán yardas.
  • AcresLas unidades serán acres.
  • HectáreasLas unidades serán hectáreas.
  • Metros cuadradosLas unidades serán metros cuadrados.
  • Kilómetros cuadradosLas unidades serán kilómetros cuadrados.
  • Pies cuadradosLas unidades serán pies cuadrados.
  • Yardas cuadradasLas unidades serán yardas cuadradas.
  • Millas cuadradasLas unidades serán millas cuadradas.
String
Campos de resumen
(Opcional)

Una lista de los nombres de campo y del tipo de resumen estadístico que se calcularán 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: se calculará el valor total.
  • Mínimo: se identificará el valor más bajo.
  • Máximo: se identificará el valor más alto.
  • Valor medio: se calculará la media o valor medio.
  • Desviación estándar: se calculará la desviación estándar.

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 separado. Por ejemplo, el valor del parámetro Entidades de resumen de entrada contiene ubicaciones de puntos de compañías que almacenan materiales peligrosos, y el campo HazardClass contiene códigos que describen el tipo de material peligroso almacenado. Para calcular resúmenes por cada valor único del campo HazardClass, úselo como campo por el que se va a agrupar.

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 solo se aplica al usar el parámetro Agrupar por campo.

  • Desactivado: los campos de minoría y mayoría no se agregarán a la salida. Esta es la opción predeterminada.
  • Activado: se calcularán los valores de atributo de minoría (menos dominantes) o de mayoría (más dominantes) para cada campo de grupo dentro de cada límite, y se agregarán dos campos nuevos con el prefijo Minority_ y Majority_ a la salida.

Boolean
Agregar porcentajes de grupo
(Opcional)

Especifica si los campos de porcentaje de grupo se agregarán a la salida.

Este parámetro solo se aplica al usar el parámetro Agrupar por campo.

  • Desactivado: no se agregarán campos de porcentaje a la salida. Esta es la opción predeterminada.
  • Activado: se calculará el porcentaje de cada valor de grupo único para cada polígono de entrada y se agregarán campos de porcentaje a la salida.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Servicio de entidades de salida

Capa resumida de salida.

Feature Set
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.

Record Set

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 entidades del valor del parámetro summaryLayer 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 creará en su portal.

String
sumShape
(Opcional)

Especifica si las estadísticas se calcularán en función de la forma del valor del parámetro summaryLayer, como la longitud de las líneas o las áreas de los polígonos de las entidades de resumen de entrada dentro de cada polígono de entrada.

  • ADD_SHAPE_SUMLas estadísticas se calcularán en función de los atributos de resumen de forma. Esta es la opción predeterminada.
  • NO_SHAPE_SUMLas estadísticas no se calcularán en función de los atributos de resumen de forma.
Boolean
shapeUnits
(Opcional)

Especifica las unidades que se utilizarán para el 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 millas, pies, kilómetros, metros y yardas.

  • MILESLas unidades serán millas.
  • FEETLas unidades serán pies.
  • KILOMETERSLas unidades serán kilómetros.
  • METERSLas unidades serán metros.
  • YARDSLas unidades serán yardas.
  • ACRESLas unidades serán acres.
  • HECTARESLas unidades serán hectáreas.
  • SQUAREMETERSLas unidades serán metros cuadrados.
  • SQUAREKILOMETERSLas unidades serán kilómetros cuadrados.
  • SQUAREFEETLas unidades serán pies cuadrados.
  • SQUAREYARDSLas unidades serán yardas cuadradas.
  • SQUAREMILESLas unidades serán millas cuadradas.
String
summaryFields
[[Field, Statistic],...]
(Opcional)

Una lista de los nombres de campo y del tipo de resumen estadístico que se calcularán 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: se calculará el valor total.
  • MIN: se identificará el valor más bajo.
  • MAX: se identificará el valor más alto.
  • MEAN: se calculará la media o valor medio.
  • STD: se calculará la desviación estándar.

Value Table
groupByField
(Opcional)

Un campo de las entidades de resumen de entrada que se usará para calcular estadísticas para cada valor de atributo único por separado. Por ejemplo, el valor del parámetro summaryLayer contiene ubicaciones de puntos de compañías que almacenan materiales peligrosos, y el campo HazardClass contiene códigos que describen el tipo de material peligroso almacenado. Para calcular resúmenes por cada valor único del campo HazardClass, úselo como campo por el que se va a agrupar.

Field
minorityMajority
(Opcional)

Especifica si los campos de minoría y mayoría se agregarán a la salida.

Este parámetro solo se aplica al usar el parámetro groupByField.

  • 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_MAJSe calcularán los valores de atributo de minoría (menos dominantes) o de mayoría (más dominantes) para cada campo de grupo dentro de cada límite, y se agregarán dos campos nuevos con el prefijo Minority_ y Majority_ a la salida.
Boolean
percentShape
(Opcional)

Especifica si los campos de porcentaje de grupo se agregarán a la salida.

Este parámetro solo se aplica al usar el parámetro groupByField.

  • NO_PERCENTNo se agregarán campos de porcentaje a la salida. Esta es la opción predeterminada.
  • ADD_PERCENTSe calculará el porcentaje de cada valor de grupo único para cada polígono de entrada y se agregarán campos de porcentaje a la salida.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
outputLayer

Capa resumida de salida.

Feature Set
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.

Record Set

Entornos

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