Grupo de regiones (Spatial Analyst)

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

Ilustración del grupo de regiones
OutRas = RegionGroup(InRas1, CUATRO, DENTRO DE, #, #)

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:

    Ejemplo de campo LINK en la tabla de atributos

  • 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

Ráster de entrada para el que se identificarán regiones conectadas únicas de celdas.

Debe ser de tipo entero.

Raster Layer
Número de elementos próximos a utilizar
(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.

  • FourSe evalúa la conectividad de los cuatro vecinos más próximos (ortogonal) de cada celda de entrada. Solo las celdas con el mismo valor que comparten al menos un lado contribuyen a una región individual. Si dos celdas con el mismo valor son diagonales entre sí, no se consideran conectadas. Esta es la opción predeterminada.
  • EightSe evalúa la conectividad de los ocho vecinos más próximos (ortogonal y diagonal) de cada celda de entrada. Las celdas con el mismo valor que están conectadas a lo largo de un eje o una esquina común a otros contribuyen a una región individual.
String
Método de agrupamiento de zonas
(Opcional)

Define cuáles de los valores de las celdas se deben considerar al probar la conectividad.

  • Dentro deSe evalúa la conectividad de una región correspondiente a las celdas de entrada que forman parte de la misma zona (valor de celda). Las únicas celdas que se pueden agrupar son las celdas de la misma zona que cumplen los requisitos espaciales de conectividad especificados por el parámetro Número de elementos próximos a utilizar (cuatro u ocho). Esta es la opción predeterminada.
  • CruzSe evalúa la conectividad de una región entre celdas de cualquier valor, excepto celdas de zona identificadas para excluirse según el parámetro Valor excluido y sujetas a requisitos espaciales identificados por el parámetro Número de elementos próximos a utilizar. Las agrupaciones de regiones en la entrada que estén separadas de otras agrupaciones mediante una zona de influencia de celdas NoData se procesarán con independencia de las demás.
String
Agregar un campo de vínculo en la salida
(Opcional)

Especifica si se va a añadir un campo de enlace a la tabla de la salida cuando el parámetro Método de agrupamiento de zonas se configura en Dentro de. Se ignora si el parámetro está establecido en Cruz.

  • Activado: se agrega un campo LINK a la tabla del ráster de salida. En este campo se almacena el valor de la zona a la que pertenece cada región de la salida, según la regla de conectividad definida en el parámetro Número de elementos próximos a utilizar. Esta es la opción predeterminada.
  • Desactivado: no se agrega ningún campo LINK. La tabla de atributos del ráster de salida solo contendrá los campos Value y Count.
Boolean
Valor excluido
(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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de grupo de regiones de salida.

La salida es siempre de tipo entero.

Raster

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

  • FOURSe evalúa la conectividad de los cuatro vecinos más próximos (ortogonal) de cada celda de entrada. Solo las celdas con el mismo valor que comparten al menos un lado contribuyen a una región individual. Si dos celdas con el mismo valor son diagonales entre sí, no se consideran conectadas. Esta es la opción predeterminada.
  • EIGHTSe evalúa la conectividad de los ocho vecinos más próximos (ortogonal y diagonal) de cada celda de entrada. Las celdas con el mismo valor que están conectadas a lo largo de un eje o una esquina común a otros contribuyen a una región individual.
String
zone_connectivity
(Opcional)

Define cuáles de los valores de las celdas se deben considerar al probar la conectividad.

  • WITHINSe evalúa la conectividad de una región correspondiente a las celdas de entrada que forman parte de la misma zona (valor de celda). Las únicas celdas que se pueden agrupar son las celdas de la misma zona que cumplen con los requisitos espaciales de conectividad especificados por el parámetro number_neighbors (cuatro u ocho). Esta es la opción predeterminada.
  • CROSSSe evalúa la conectividad de una región entre celdas de cualquier valor, excepto celdas de zona identificadas para excluirse según el parámetro excluded_value y sujetas a requisitos espaciales identificados por el parámetro number_neighbors. Las agrupaciones de regiones en la entrada que estén separadas de otras agrupaciones mediante una zona de influencia de celdas NoData se procesarán con independencia de las demás.
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.

  • ADD_LINKSe agrega un campo LINK a la tabla del ráster de salida. En este campo se almacena el valor de la zona a la que pertenece cada región de la salida, según la regla de conectividad definida en el parámetro number_neighbors. Esta es la opción predeterminada.
  • NO_LINKNo se agregará un campo LINK. La tabla de atributos del ráster de salida solo contendrá los campos Value y Count.
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

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

# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS", 
                           "NO_LINK", valToIgnore)

# Save the output 
outRegionGrp.save("C:/sapyexamples/output/reggrpout")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados