Disponible con una licencia de Spatial Analyst.
Resumen
Identifica las mejores regiones o grupos de celdas contiguas de un ráster de utilidad (idoneidad) de entrada que satisfacen los criterios de evaluación especificados y que cumplen las restricciones de forma, tamaño, número y distancia entre regiones.
Esta herramienta utiliza un algoritmo de crecimiento de regiones parametrizado (PRG) para aumentar regiones candidatas a partir de celdas de valores de inicialización agregando celdas vecinas a la región que mejor mantiene la forma especificada, a la vez que maximiza la utilidad de la región. Mediante un algoritmo de selección y criterios de evaluación (como el valor medio más alto), se seleccionen las mejores regiones de las regiones candidatas que cumplen el tamaño y las restricciones espaciales indicados. Un ejemplo de restricción espacial sería mantener una determinada distancia mínima entre regiones.
Más información sobre cómo funciona la herramienta Localizar regiones
Uso
El ráster de utilidad de entrada suele ser la salida de un modelo de adecuación. Un modelo de adecuación identifica la idoneidad de cada ubicación según los atributos deseados que caracterizan a la ubicación. La creación de modelos de adecuación es una de las aplicaciones más comunes de Spatial Analyst. Para obtener más información sobre cómo crear modelos de adecuación, consulte Comprender el análisis de superposición
Cuanto más altos son los valores de entrada en el ráster de utilidad, mayor es la utilidad.
La configuración de los parámetros Distancia mínima entre regiones y Distancia máxima entre regiones tiene prioridad sobre el Área total. Por ejemplo, si se desean cinco regiones, pero, debido a las distancias mínima y máxima especificadas solo se pueden localizar cuatro regiones, solo se seleccionarán cuatro regiones. Como resultado, no se cumplirá con el Área total. Cuando sea posible se emitirá un mensaje de advertencia, pero este no es el caso para todas las situaciones.
El algoritmo de crecimiento de regiones parametrizado (PRG) se basa en los valores de utilidad del ráster de entrada (cuanto más altos sean los valores, más preferencia tendrán las celdas en el crecimiento). El Método de evaluación determina qué regiones candidatas se seleccionan; no influye en el crecimiento de las regiones.
La herramienta Localizar regiones es intensiva desde el punto de vista informático. Hay varios pasos que se pueden seguir para configurar los datos de entrada y también existen algunos parámetros que influyen en el proceso.
Para agilizar el procesamiento, las ubicaciones que no se deben tener en cuenta en el proceso de selección se deben establecer como NoData o eliminar utilizando la Máscara. De estas ubicaciones excluidas no se aumentará ninguna región ni se asignará en el proceso de selección. A diferencia de Entidad o ráster de entrada de regiones existentes, las áreas excluidas no afectan a la Distancia mínima entre regiones ni a la Distancia máxima entre regiones en el algoritmo de crecimiento de regiones parametrizado (PRG) o en la selección de las regiones candidatas.
Las opciones que se seleccionen para los parámetros Número de seeds desde los que iniciar el crecimiento y Resolución del crecimiento pueden afectar considerablemente al tiempo de procesamiento.
Seleccionar las opciones Small y Low para estos parámetros, respectivamente, ofrecerá el mejor rendimiento. Seleccionar Small, Medium o Large para Número de valores de inicialización desde los que iniciar el crecimiento y Low, Medium o High para Resolución del crecimiento ofrece los resultados más fiables en una cantidad de tiempo razonable.
Si los parámetros Número de seeds desde los que iniciar el crecimiento o Resolución del crecimiento se especifican con cualquier opción distinta de Maximum, los datos se perderán porque no habrá crecimiento de regiones en cada celda y se remuestreará a una resolución más gruesa. Sin embargo, dependiendo del tamaño del ráster de entrada, la opción Maximum puede ser muy lenta; por lo tanto, puede que las otras opciones sean más prácticas.
Dependiendo del tamaño del ráster de entrada, seleccionar Maximum para Número de seeds desde los que iniciar el crecimiento o Resolución del crecimiento puede tardar mucho. El algoritmo de Localizar regiones implementa un proceso de dos pasos. Primero aumenta regiones candidatas y luego selecciona las mejores regiones entre las regiones candidatas. El crecimiento de las regiones para rásteres de entrada grandes puede tardar mucho. No obstante, en el paso de selección de regiones, primero se carga una matriz de distancia. Si no se puede cargar la matriz debido a limitaciones de memoria, la herramienta finalizará el procesamiento. Si esto ocurre, seleccione un número menor de valores de inicialización desde los que iniciar el crecimiento o especifique una resolución menos detallada del crecimiento.
Los valores predeterminados para Número de valores de inicialización desde los que iniciar el crecimiento y Resolución del crecimiento dependen del número de celdas que haya en el ráster de entrada. Cuantas más celdas haya en el ráster de entrada, más tardará en ejecutarse esta herramienta. Para evitar tiempos de ejecución excesivamente largos, estos valores predeterminados se definen acorde.
Número de celdas de entrada
Número de seeds desde los que iniciar el crecimiento Resolución del crecimiento <= 100.000
Máximo Máximo 100.000 - 500.000
Pequeño Máximo > 500.000
Pequeño Bajo Cuando el Número de regiones es mayor que ocho, se recomienda utilizar la opción Sequential para el Método de selección de regiones. Utilizar el método Combinatorial con más de ocho regiones seleccionadas puede ralentizar el rendimiento.
Normalmente, el valor de Número de seeds desde los que iniciar el crecimiento es el que más afecta a la velocidad de procesamiento. Cuanto más alto sea el número de valores de inicialización desde los que iniciar el crecimiento, más tiempo tardará la herramienta en procesar. No obstante, en la mayoría de los casos, los resultados son similares, independientemente del valor especificado.
El Número de valores de inicialización desde los que iniciar el crecimiento se distribuye en el ráster de entrada basándose en los valores de utilidad; las áreas cuyos valores de utilidad son más altos reciben más valores de inicialización. El Método de evaluación no influye en su distribución.
La Resolución del crecimiento establece la resolución con la que se llevará a cabo el crecimiento de regiones parametrizado. El ráster de entrada se remuestrea a la resolución definida utilizando el método de remuestreo bilineal. Una vez que se seleccionen las regiones, antes de que se cree el ráster de salida final, los resultados se remuestrean según el entorno de Tamaño de celda utilizando el método de remuestreo de vecino más cercano.
Se implementa un ajuste de la forma para las regiones que hay en el borde del ráster de entrada. Si al menos una de las celdas queda fuera del límite del ráster de entrada, la utilidad de la región se reducirá un 50 % para mantener la forma. Debido a esta reducción de la utilidad, es menos probable que se seleccione la región, aunque la reducción no elimina la región del proceso de selección.
El área seleccionada puede ser superior al área total especificada si se activa la opción No se permiten islas en las regiones. Para determinar si la discrepancia entre el área seleccionada y el área total especificada se basa en el parámetro de "no se permiten islas", vuelva a ejecutar la herramienta con este parámetro desactivado. Agregue el número de celdas de COUNT a la tabla de atributos del ráster de salida de la ejecución original y luego vuelva a ejecutar la herramienta, multiplique la suma de cada uno por el área de una celda y compare los resultados con el área especificada.
Si se ha especificado Resolución del crecimiento con cualquier opción distinta a Maximum, mediante un proceso posterior, se pueden identificar los valores de utilidad originales para cada región utilizando las Estadísticas zonales. Introduzca el ráster de la región de salida de Localizar regiones como ráster de zona y el ráster de utilidad de entrada como ráster de valores.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
LocateRegions(in_raster, {total_area}, {area_units}, {number_of_regions}, {region_shape}, {region_orientation}, {shape_tradeoff}, {evaluation_method}, {minimum_area}, {maximum_area}, {minimum_distance}, {maximum_distance}, {distance_units}, {in_existing_regions}, {number_of_neighbors}, {no_islands}, {region_seeds}, {region_resolution}, {selection_method})| Parámetro | Explicación | Tipo de datos |
in_raster | El ráster de utilidad de entrada desde el que se derivarán las regiones. Cuanto más alto sea el valor en el ráster de entrada, mayor será la utilidad. El ráster puede ser de tipo entero o punto flotante. | Raster Layer |
total_area (Opcional) | La cantidad total de área para todas las regiones. El valor predeterminado es 10 por ciento de las celdas de entrada dentro de la extensión de procesamiento. | Double |
area_units (Opcional) | Determina las unidades de área que se utilizan en los parámetros total_area, minimum_area y maximum_area. A continuación se indican las opciones disponibles y las unidades correspondientes:
El valor predeterminado se basa en el dataset ráster de entrada. Si el ráster de entrada está expresado en pies, yardas, millas o en cualquier otra unidad imperial, se utilizará Square miles. Si el ráster de entrada está expresado en metros, kilómetros o en cualquier otra unidad métrica, se utilizará Square kilometers. | String |
number_of_regions (Opcional) | Determina en cuántas regiones se distribuirá el total_area. Se puede especificar una cantidad máxima de 30 regiones. El valor predeterminado es 1. | Long |
region_shape (Opcional) | Define las características de forma de las regiones de salida. Las regiones parten de las ubicaciones de las celdas de los valores de inicialización y crecen hacia afuera tomando como preferencia las celdas que mantienen la forma deseada. Las opciones de forma disponibles son las siguientes:
| String |
region_orientation (Opcional) | Define la orientación de la forma definida. Las regiones crecen hacia afuera desde las ubicaciones de los valores de inicialización tomando como preferencia las celdas que mantienen la orientación deseada de las formas de las regiones. Los valores de orientación se expresan en grados brújula, de 0 a 360, y aumentan en sentido horario desde el norte. El valor predeterminado es 0. El valor predeterminado de 0 orienta las formas del siguiente modo: Círculo: sin efecto; Elipse: el eje menor se orienta hacia el norte-sur; Triángulo y Pentágono: un punto se mueve en línea recta hacia arriba; Cuadrado, Hexágono y Octágono: un lado plano se orienta hacia el este-oeste. | Double |
shape_tradeoff (Opcional) | Identifica la ponderación de las celdas al aumentar las regiones candidatas en el algoritmo de crecimiento de regiones parametrizado. La ponderación es una decisión entre la contribución de una celda a mantener la forma de la región en relación con la contribución de la utilidad del valor de atributo de la celda. Los valores más altos indican que mantener la forma de la región es más importante que seleccionar valores de utilidad más altos. Los valores porcentuales aceptables son 0 y 100, ambos incluidos. El valor predeterminado es 50. Este parámetro se utiliza para identificar las regiones candidatas factibles. Las regiones candidatas que se seleccionarán se controlan mediante el parámetro evaluation_method. | Double |
evaluation_method (Opcional) | Los criterios de evaluación que se van a utilizar para determinar qué regiones candidatas identificadas en el algoritmo de crecimiento de regiones parametrizado se prefieren más. La preferencia se puede especificar según una determinada estadística de los valores de utilidad o de la disposición espacial de las celdas dentro de las regiones. Las opciones disponibles son las siguientes:
| String |
minimum_area (Opcional) | Define el área mínima que se permite para cada región. Se utilizarán las unidades especificadas en area_units. Para obtener más información sobre cómo se crean regiones con las áreas mínima y máxima definidas, consulte Modo de determinar las regiones cuando se especifica un área mínima y máxima. | Double |
maximum_area (Opcional) | Define el área máxima que se permite para cada región. Se utilizarán las unidades especificadas en area_units. Para obtener más información sobre cómo se crean regiones con las áreas mínima y máxima definidas, consulte Modo de determinar las regiones cuando se especifica un área mínima y máxima. | Double |
minimum_distance (Opcional) | Define la distancia mínima permitida entre regiones. No puede haber dos regiones dentro de esta distancia. Este parámetro influye en el algoritmo de crecimiento de regiones parametrizado (PRG). Si una celda tiene la capacidad de poderse agregar a una región candidata, pero está a esta distancia respecto a otra región individual en el in_existing_regions, no se tendrá en cuenta para la región candidata. La configuración de la distancia mínima no se aplica a las ubicaciones excluidas (celdas NoData). Se utilizarán las unidades especificadas en distance_units. | Double |
maximum_distance (Opcional) | Define la distancia máxima permitida entre regiones. No puede haber ninguna región alejada más de esta distancia respecto a otra región como mínimo. Cuando se seleccionan regiones de forma secuencial, si la siguiente mejor región está alejada más de esta distancia respecto a cualquiera de las regiones ya seleccionadas, no se tendrá en cuenta esta vez, pero puede que se seleccione más adelante, cuando se seleccionen más regiones. La distancia máxima se aplica a las in_existing_regions; es decir, al menos una de las regiones seleccionadas debe estar dentro de la distancia máxima respecto a las regiones existentes. La configuración de la distancia máxima no se aplica a las áreas excluidas (celdas NoData) y no afecta al algoritmo PRG. Se utilizarán las unidades especificadas en distance_units. | Double |
distance_units (Opcional) | Define las unidades de distancia que se utilizarán para los parámetros minimum_distance y maximum_distance. A continuación se indican las opciones disponibles y las unidades correspondientes:
El valor predeterminado se basa en el dataset ráster de entrada. Si el ráster de entrada está expresado en pies, yardas, millas o en cualquier otra unidad imperial, se utilizará Miles. Si el ráster de entrada está expresado en metros, kilómetros o en cualquier otra unidad métrica, se utilizará Kilometers. | String |
in_existing_regions (Opcional) | Un dataset que identifica dónde ya existen regiones. La entrada puede ser un ráster o un dataset de entidades. Si la entrada es un ráster, cualquier ubicación del ráster que tenga un valor se considerará como ya asignada. El resto de ubicaciones se establecen como NoData. En el algoritmo de crecimiento de regiones parametrizado, ninguna región crecerá a partir de una ubicación que contenga una región existente. Las regiones existentes se utilizarán en el crecimiento y la evaluación de minimum_distance y maximum_distance, tal y como se describió anteriormente en las descripciones de los parámetros correspondientes. | Raster Layer; Feature Layer |
number_of_neighbors (Opcional) | Define qué celdas vecinas se deben utilizar en el crecimiento de las regiones. Las opciones disponibles son las siguientes:
| String |
no_islands (Opcional) | Define si se permitirán o no islas dentro de las posibles regiones.
| Boolean |
region_seeds (Opcional) | Define el número de valores de inicialización desde los que se aumentarán las posibles regiones. Para obtener más información sobre cómo influyen los valores de inicialización en el algoritmo de crecimiento de las regiones, consulte Cómo se distribuyen los valores de inicialización. Las opciones disponibles son las siguientes:
| String |
region_resolution (Opcional) | Define la resolución con la que se lleva a cabo el crecimiento de regiones. El ráster de entrada se remuestreará según la resolución que determine el número de celdas identificadas con este parámetro (consulte abajo). Por ejemplo, para Low, el ráster de entrada se remuestrea a 147.356 celdas. El algoritmo de crecimiento de regiones parametrizado se lleva a cabo en el ráster intermedio remuestreado. Una vez que se seleccionan las regiones del ráster intermedio remuestreado, las regiones seleccionadas se remuestrearán según el Tamaño de celda. Se puede implementar un ajuste en las resoluciones objetivo identificadas abajo si el número de celdas en el tamaño medio de la región deseada es demasiado pequeño o demasiado grande. Este ajuste garantiza que habrá celdas suficientes en cada región deseada o que no se realizará ese procesamiento innecesario. Como resultado, el total de celdas para el ráster remuestreado intermedio para cada resolución especificada que aparece a continuación puede ser inferior o superior al número de celdas objetivo. Para obtener más información sobre este ajuste y sobre los umbrales que se utilizan, consulte Ajustar la resolución del crecimiento de las regiones según el tamaño de las regiones deseadas. Si la entrada tiene menos de 147.356 celdas o se selecciona Maximum, no se llevará a cabo ningún remuestreo y el crecimiento de regiones se llevará a cabo en todas las celdas del ráster de entrada. Si el ráster de entrada tiene menos de 147.356 celdas, las opciones Low, Medium o High no tendrán efecto alguno. Las opciones disponibles son las siguientes:
| String |
selection_method (Opcional) | Identifica cómo se seleccionarán las regiones. Las opciones disponibles son las siguientes:
| String |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | El ráster de regiones de salida. Cada región se numera de forma exclusiva con valores mayores que cero. A las celdas que no pertenecen a ninguna región se les asignará el valor cero. La salida siempre es un ráster de tipo entero. Se calculan campos adicionales para cada región y se almacenan estadísticas de las regiones seleccionadas. Estos campos son los siguientes:
| Raster |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta LocateRegions.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRegions = LocateRegions("suitsurface", 13.5, "SQUARE_MILES", 5, "CIRCLE",
0, 50, "HIGHEST_AVERAGE_VALUE", 2, 5, 1, 3, "MILES",
"existingreg.shp", "EIGHT", "NO_ISLANDS", "SMALL",
"LOW", "COMBINATORIAL")
outRegions.save("C:/sapyexamples/output/outregions")Identifica las ocho regiones óptimas de una superficie de adecuación y manteniendo los requisitos espaciales.
# Name: LocateRegions_Ex_02.py
# Description: Selects the best specified number of regions
# 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
InRaster1 = "suitsurface"
InTotalArea2 = 13.5
InAreaUnits3 = "SQUARE_MILES"
InNumberofRegions4 = 5
InRegionShape5 = "CIRCLE"
InRegionOrientation6 = 0
InShapeTradeoff7 = 50
InEvaluationMethod8 = "HIGHEST_AVERAGE_VALUE"
InMinimumArea9 = 2
InMaximumArea10 = 5
InMinimumDistance11 = 1
InMaximumDistance12 = 3
InDistanceUnits13 = "MILES"
InExistingRegions14 = "existingreg.shp"
InRegionofNeighbors15 = "EIGHT"
InRegionNoIslands16 = "NO_ISLANDS"
InRegionSeeds17 = "SMALL"
InRegionResolution18 = "LOW"
InCombinatorialThreshold19 = "COMBINATORIAL"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Locate Regions
outRegions = LocateRegions(InRaster1, InTotalArea2, InAreaUnits3, InNumberofRegions4,
InRegionShape5, InRegionOrientation6, InShapeTradeoff7,
InEvaluationMethod8, InMinimumArea9, InMaximumArea10,
InMinimumDistance11, InMaximumDistance12, InDistanceUnits13,
InExistingRegions14, InRegionofNeighbors15, InRegionNoIslands16,
InRegionSeeds17, InRegionResolution18, InCombinatorialThreshold19)
# Save the output
outRegions.save("C:/sapyexamples/output/outregions")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst