Grupo de regiones (Análisis espacial)

Nivel de licencia:BasicStandardAdvanced

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

Region Group illustration
OutRas = RegionGroup(InRas1)

Uso

Sintaxis

RegionGroup (in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})
ParámetroExplicaciónTipo 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

NombreExplicaciónTipo 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

Temas relacionados

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
9/11/2013