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
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.
Sintaxis
arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
Parámetro | Explicación | Tipo 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.
| 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.
| 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:
| 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_.
| 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.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo 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
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