Disponible con una licencia de Spatial Analyst.
Resumen
Para cada celda en la salida, se registra la identidad de la región conectada a la que pertenece esa celda. Se asigna un número único a cada región.
Más información sobre cómo crear zonas individuales con Grupo de regiones
Ilustración
Uso
En general, la primera región escaneada recibe el valor uno, la segunda recibe el valor dos y así sucesivamente hasta que se asigna un valor a todas las regiones. El escaneo se desplaza de izquierda a derecha, de arriba hacia abajo. Los valores que se asignen a las zonas de salida dependerán del momento en que se encuentran en el proceso de escaneo.
Existen dos parámetros que controlan cómo se establece la conectividad entre regiones. El parámetro Número de elementos próximos a utilizar determina la geometría de la conectividad como ortogonal (cuatro direcciones) solamente o diagonal además de ortogonal (ocho direcciones). El parámetro Método de agrupamiento de zonas determina los valores de celda que se tienen en cuenta al evaluar la conectividad.
El parámetro Agregar un campo de vínculo en la salida (ADD_LINK en Python) está habilitado de manera predeterminada. Esto creará un campo LINK en la tabla de atributos del ráster de salida, que conserva el valor de zona original de cada celda desde el ráster de entrada.
Este parámetro solo se aplica cuando el parámetro Método de agrupamiento de zonas (zone_connectivity en Python) se configura en Dentro de. Si se configura en Cruzado, la tabla de atributos del ráster de salida solo contendrá los campos Value y Count habituales.
Cuando está disponible, el campo LINK permite rastrear el origen de cada una de las regiones recién creadas con respecto a los valores de zona de entrada originales para el uso en análisis adicionales.
Por ejemplo, la tabla de atributos para el ráster de salida que se muestra en la ilustración anterior es la siguiente:
La velocidad de procesamiento mejora si no se crea ningún campo LINK. Si el valor original de cada región ya no es necesario, desactive esta opción.
Si se configura el entorno de Máscara, la configuración espacial y el número de regiones se pueden modificar en el ráster de salida.
Las ubicaciones de celda que contienen el valor excluido reciben cero en la salida, de modo que estas zonas no se confunden con las ubicaciones de celda NoData actuales. Dado que la numeración comienza con el valor 1, las celdas que se excluyen de la reagrupación se consideran de fondo. Estas celdas de fondo se pueden reclasificar o manipular de la misma forma que cualquier otro valor.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})| Parámetro | Explicación | Tipo de datos |
in_raster | Ráster de entrada para el que se identificarán regiones conectadas únicas de celdas. Debe ser de tipo entero. | Raster Layer |
number_neighbors (Opcional) | Especifica el número de celdas vecinas que se van a utilizar al evaluar la conectividad entre las celdas que definen una región.
| String |
zone_connectivity (Opcional) | Define cuáles de los valores de las celdas se deben considerar al probar la conectividad.
| String |
add_link (Opcional) | Especifica si se va a añadir un campo de vínculo a la tabla de la salida cuando el parámetro zone_connectivity se configura en WITHIN. Se ignora si ese parámetro está establecido en CROSS.
| Boolean |
excluded_value (Opcional) | Valor que excluye todas las celdas de esa zona de la evaluación de conectividad. Si una ubicación de celda contiene el valor, no se evaluará ninguna conectividad espacial, independientemente de cómo se especifique el número de elementos próximos. Las celdas con valor excluido se tratarán de manera similar a las celdas NoData y no se tendrán en cuenta en la operación. Las celda de entrada que contienen el valor excluido recibirán 0 en el ráster de salida. El valor excluido es similar al concepto de valor de fondo. Este parámetro no tiene ningún valor definido de manera predeterminada, lo que significa que todas las celdas de entrada se tendrán en cuenta en la operación. | Long |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | El ráster de grupo de regiones de salida. La salida es siempre de tipo entero. | Raster |
Muestra de código
Ejemplo 1 de RegionGroup (ventana de Python)
En este ejemplo se asigna un número único a cada región del ráster de entrada al utilizar la conectividad de tipo ocho.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")
Ejemplo 2 de RegionGroup (secuencia de comandos independiente)
En este ejemplo se asigna un número único a cada región del ráster de entrada al utilizar la conectividad de tipo ocho con un valor excluido.
# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
# identity of the connected region to which
# it belongs within the Analysis window. A
# unique number is assigned to each region.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "land"
valToIgnore = 5
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst