Grupo de regiones (Análisis espacial)

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

OutRas = RegionGroup(InRas1)

Uso

• La primera región escaneada recibe el valor uno, la segunda 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.

• Por defecto, la opción Agregar vínculo es Verdadera. Esto creará un elemento denominado LINK en la tabla de atributos del ráster de salida, que conserva el valor original para cada celda desde el ráster de entrada.

• El campo LINK permite trazar el origen de cada una de las regiones creadas recientemente para consultas o análisis.

  Por ejemplo, la tabla de atributos para el ráster de salida que se muestra en la ilustración anterior es:

  Ejemplo de elemento LINK en la tabla de atributos

• Establecer la opción Agregar vínculo en Falso aumentará de manera significativa la velocidad del proceso. Esto es útil cuando el valor original de cada región ya no es necesario.

• Si se ha configurado una máscara en el entorno, esas celdas que se han enmascarado recibirán NoData en el ráster de salida. Con una máscara, la configuración espacial y los cantidad de regiones se pueden alterar en el ráster de salida. Si una región era continua y la imposición de una máscara rompe la continuidad, la región se dividirá en dos regiones con valores o identificadores de grupo diferentes en el ráster de salida.

  La máscara no sólo puede crear regiones adicionales dividiendo una región en dos regiones separadas o más, también puede reducir la cantidad de regiones en la salida. Si una máscara cubre o elimina totalmente una región potencial de celdas conectadas, esas celdas no se considerarán como una zona nueva en la salida; recibirán valores NoData.

• Grupo de regiones es especialmente útil cuando el análisis se realiza sobre regiones y no sobre zonas. Dado que el valor de la zona de entrada se mantiene, la clase zonal original también se puede utilizar en el análisis.

• 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 Grupo de regiones comienza la numeración 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 como cualquier otro valor. Las ubicaciones que contienen valores excluidos se pueden convertir fácilmente a NoData al utilizar la herramienta Evaluación condicional.

Sintaxis

RegionGroup (in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})

Parámetro	Explicación	Tipo de datos
in_raster	El ráster de entrada cuyas regiones conectadas únicas se identificarán. Debe ser de tipo entero.	Raster Layer
number_neighbors (Opcional)	La cantidad de celdas vecinas a utilizar en la evaluación de conectividad entre celdas. FOUR — Define la conectividad entre celdas del mismo valor sólo si las celdas están directamente a la izquierda, a la derecha, arriba o abajo de cada uno de los cuatro vecinos más cercanos. Si dos celdas con el mismo valor son diagonales entre sí, no se consideran conectadas. EIGHT — Define la conectividad entre celdas del mismo valor si se encuentran dentro de la vecindad inmediata de ocho celdas (ocho vecinos más cercanos) de cada una. Esto incluye a la derecha, a la izquierda, arriba o en diagonal a la otra.	String
zone_connectivity (Opcional)	Define cuáles de los valores de las celdas se deben considerar al probar la conectividad. WITHIN — Las pruebas de conectividad entre los valores de entrada que son iguales dentro de la misma zona.Las únicas celdas que se pueden agrupar son las celdas que pertenecen a la misma zona (valor) que cumplan con los requerimientos de conectividad espaciales especificados por las palabras clave FOUR y EIGHT. CROSS — Las pruebas de conectividad mediante los requerimientos espaciales especificados por las palabras clave FOUR o EIGHT entre celdas con cualquier valor, excepto por el valor identificado para excluir.Cuando se utiliza CROSS, un valor para el argumento {excluded_value} debe ser entrada.	String
add_link (Opcional)	Especifica si se añade un campo de vínculo a la tabla de salida. ADD_LINK — Se agregará un elemento ADD_LINK a la tabla del ráster de salida. Este elemento almacena los valores originales de cada zona recién creada desde regiones desconectadas a partir del ráster de entrada antes de que sean reagrupados. Esta es la opción predeterminada. NO_LINK — La tabla de atributos para el ráster de salida sólo contendrá los elementos Valor y Conteo.	Boolean
excluded_value (Opcional)	Identifica un valor tal que si una ubicación de celda contiene el valor, no se evaluará ninguna conectividad espacial, independientemente de cómo se especifica la cantidad de vecinos (FOUR o EIGHT). Las celdas con el valor excluido se tratarán como NoData y se eliminarán de los cálculos. Las ubicaciones de celda 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 o a configurar una máscara en el entorno para una sola ejecución de la herramienta. Se debe especificar un valor para este parámetro si se especifica la palabra clave CROSS.	Long

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de grupo de regiones de salida. El ráster de salida siempre es de tipo entero.	Raster

Ejemplo 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

Tamaño de celda, Espacio de trabajo actual, Máscara, Sistema de coordenadas de salida, Extensión, Espacio de trabajo temporal, Alinear ráster

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst

ArcGIS for Desktop Standard: Requiere Spatial Analyst

ArcGIS for Desktop Advanced: Requiere Spatial Analyst