Localizar regiones (Spatial Analyst)

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. El modelado 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 valores de inicialización 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á regiones en crecimiento en cada celda y se remuestreará a una resolución más gruesa. Sin embargo, en función del tamaño del ráster de entrada, la opción Maximum puede ser muy lenta; por lo tanto, puede que el resto de opciones sean más prácticas.

• En función del tamaño del ráster de entrada, seleccionar Maximum para Número de valores de inicialización desde los que iniciar el crecimiento o Resolución del crecimiento puede tardar mucho tiempo. 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 región. 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 de Maximum, mediante un proceso posterior, se pueden identificar los valores de utilidad originales para cada región mediante 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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	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
Área total (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
Unidades de área (Opcional)	Define las unidades de área que se utilizan en los parámetros Área total, Área mínima de región y Área máxima de región. 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. Unidades de mapa cuadradas—Para el cuadrado de las unidades lineales de la referencia espacial de salida Millas cuadradas—Para millas Kilómetros cuadrados—Para kilómetros Hectáreas—Para hectáreas Acres—Para acres Metros cuadrados—Para metros Yardas cuadradas—Para yardas Pies cuadrados—Para pies	String
Número de regiones (Opcional)	Determina en cuántas regiones se distribuirá el Área total. Se puede especificar una cantidad máxima de 30 regiones. El valor predeterminado es 1.	Long
Forma de la región (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: Círculo—Las celdas que mantienen regiones circulares recibirán una ponderación superior. Esta es la opción predeterminada. Elipse—Las celdas que mantienen regiones con forma elíptica recibirán una ponderación superior. Triángulo equilátero—Las celdas que mantienen regiones con forma de triángulo equilátero recibirán una ponderación superior. Cuadrado—Las celdas que mantienen regiones con forma cuadrada recibirán una ponderación superior. Pentágono—Las celdas que mantienen regiones con forma de pentágono recibirán una ponderación superior. Hexágono—Las celdas que mantienen regiones con forma de hexágono recibirán una ponderación superior. Octágono—Las celdas que mantienen regiones con forma de octágono recibirán una ponderación superior.	String
Orientación de región (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. Si la Forma de la región se define como Circle, el parámetro Orientación de región no estará disponible.	Double
Equilibrio entre forma/utilidad (%) (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 en el algoritmo se controlan mediante el parámetro Método de evaluación.	Double
Método de evaluación (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: Valor medio más alto—Selecciona las regiones según el valor medio más alto. Esta es la opción predeterminada. Suma más alta—Selecciona las regiones según la suma más alta. Valor de mediana más alto—Selecciona las regiones según el valor de mediana más alto. Valor más alto—Selecciona las regiones según el valor de celda individual más alto incluido en la región. Con esta opción se garantiza la selección de las mejores celdas individuales. Valor más bajo—Selecciona las regiones según el valor de celda individual más alto o más bajo incluido en la región. Con esta opción se garantiza que las regiones seleccionadas contienen celdas con un valor de utilidad realmente bajo. Área central más grande—Selecciona las regiones según el área central más grande.Cualquier celda que esté alejada más de una celda desde el borde de una región se considera que forma parte del centro. La distancia de los bordes se puede controlar mediante el tamaño de celda del análisis. Si se define un tamaño de celda más pequeño puede aumentar el área central. Suma más alta de valores de utilidad centrales—Selecciona las regiones según la suma acumulada más alta de los valores de utilidad para el área central. La distancia de los bordes se puede controlar mediante el tamaño de celda del análisis. Borde más grande—Selecciona las regiones según la cantidad de bordes más grande, utilizando la relación P1, que es la relación entre el perímetro de la forma y el perímetro de un círculo de la misma área. La relación P1 de un círculo es 1.	String
Área mínima de región (Opcional)	Define el área mínima que se permite para cada región. Se utilizarán las unidades especificadas en el parámetro Unidades de área.	Double
Área máxima de región (Opcional)	Define el área máxima que se permite para cada región. Se utilizarán las unidades especificadas en el parámetro Unidades de área.	Double
Distancia mínima entre regiones (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 dataset especificado en el parámetro Entidad o ráster de entrada de regiones existentes, 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 el parámetro Unidades de distancia.	Double
Distancia máxima entre regiones (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 al dataset especificado en el parámetro Entidad o ráster de entrada de regiones existentes, donde 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 el parámetro Unidades de distancia.	Double
Unidades de distancia (Opcional)	Define las unidades de distancia que se utilizarán para los parámetros Distancia mínima entre regiones y Distancia máxima entre regiones. 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. Unidades de mapa—Para las unidades lineales de la referencia espacial de salida Millas—Para millas Kilómetros—Para kilómetros Metros—Para metros Yardas—Para yardas Pies—Para pies	String
Entidad o ráster de entrada de regiones existentes (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 identificada como una región existente. Las regiones existentes se utilizarán en el crecimiento y la evaluación de los parámetros Distancia mínima entre regiones y Distancia máxima entre regiones, tal y como se describió anteriormente en las descripciones de los parámetros correspondientes.	Raster Layer; Feature Layer
Número de vecinos a utilizar en crecimiento (Opcional)	Define qué celdas vecinas se deben utilizar en el crecimiento de las regiones. Las opciones disponibles son las siguientes: Four—Solo los cuatro vecinos directos (ortogonales) de las celdas de la región se tendrán en cuenta en el crecimiento de la región. Eight—Los ocho vecinos más cercanos (ortogonales y diagonales) se tendrán en cuenta en el crecimiento de la región. Esta es la opción predeterminada.	String
No se permiten islas en las regiones (Opcional)	Define si se permitirán o no islas dentro de las posibles regiones. Activado: el algoritmo de crecimiento de regiones parametrizado garantiza que no habrá islas dentro de una región. Esta es la opción predeterminada. Se implementa un algoritmo de campo de inundación como proceso posterior una vez que se crean las regiones, pero antes de seleccionarlas. Si hay islas dentro de una región, se rellenarán y las celdas se unirán a la región. Dado que el proceso de relleno se lleva a cabo antes del proceso de selección, se agregará la utilidad de las celdas de islas a la región y sus valores se incluirán en el proceso de selección de las regiones y en las estadísticas de las regiones de salida. Como resultado del proceso de relleno, es probable que el área total asignada supere el objetivo especificado en el parámetro Área total. Desactivado: se permitirán islas.	Boolean
Número de seeds desde los que iniciar el crecimiento (Opcional)	Define el número de valores de inicialización desde los que se aumentarán las posibles regiones. Las opciones disponibles son las siguientes: Basado en entrada—El número de valores de inicialización se basará en el número de celdas del ráster de entrada. Si el ráster de entrada tiene 100.000 celdas o menos, el valor predeterminado es Maximum. Si el ráster de entrada tiene más de 100.000 celdas, el valor predeterminado es Small. Esta es la opción predeterminada. Pequeño—El número de valores de inicialización será igual al 10% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 1.600 valores de inicialización. Medio—El número de valores de inicialización será igual al 20% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 2.500 valores de inicialización. Grande—El número de valores de inicialización será igual al 30% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 3.600 valores de inicialización. Máximo—El crecimiento de regiones se producirá en cada celda disponible dentro del ráster de entrada. Las celdas disponibles son aquellas que no son NoData y que no están identificadas como una región existente.	String
Resolución del crecimiento (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 del entorno. 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. 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: Basado en entrada—La resolución se basará en el número de celdas del ráster de entrada. Si el ráster de entrada tiene 500.000 celdas o menos, el valor predeterminado es Maximum. Si el ráster de entrada tiene más de 500.000 celdas, el valor predeterminado es Low. Esta es la opción predeterminada. Bajo—El análisis se realizará en un ráster intermedio que contenga 147.356 (384 x 384) celdas distribuidas con la misma relación x e y que el ráster de entrada. Medio—El análisis se realizará en un ráster intermedio que contenga 262.144 (512 x 512) celdas distribuidas con la misma relación x,y que el ráster de entrada. Alto—El análisis se realizará en un ráster intermedio que contenga 589.824 (768 x 768) celdas distribuidas con la misma relación x e y que el ráster de entrada. Máximo—El análisis se realizará en todas las celdas del ráster de entrada.	String
Método de selección de regiones (Opcional)	Identifica cómo se seleccionarán las regiones. Las opciones disponibles son las siguientes: Basado en el número de regiones—El método de selección se basa en el parámetro Número de regiones. Si el Número de regiones es ocho o menos, se utilizará el método de selección Combinatorial. Si el parámetro Número de regiones es mayor que ocho, se utilizará el método de selección Sequential. Esta es la opción predeterminada. Combinatoria—Selecciona las mejores regiones según el método de evaluación especificado, respetando las restricciones espaciales, probando todas las combinaciones del número de regiones deseadas dentro de las regiones candidatas mediante el algoritmo de crecimiento de regiones parametrizado (PRG). Secuencial—Selecciona secuencialmente las mejores regiones según el método de evaluación y siempre que cumplan las restricciones espaciales hasta alcanzar el número de regiones deseadas.	String

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	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: AVERAGE—El valor medio de utilidad de la región. TOTAL—La suma total de los valores de utilidad dentro de la región. MEDIAN—El valor de la mediana de utilidad de la región. HIGHEST—El valor de celda individual más alto incluido en la región. LOWEST—El valor de celda individual más bajo incluido en la región. COREAREA—El área central. Cualquier celda que esté alejada más de una celda desde el borde de la región se considera que forma parte del centro. CORESUM—La suma acumulada de los valores de utilidad para el área central. EDGE—La cantidad de bordes utilizando la relación P1, que es la relación entre el perímetro de la forma y el perímetro de un círculo de la misma área. La relación P1 de un círculo es 1.	Raster

Python

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})

Nombre	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: SQUARE_MAP_UNITS—Para el cuadrado de las unidades lineales de la referencia espacial de salida SQUARE_MILES—Para millas SQUARE_KILOMETERS—Para kilómetros HECTARES—Para hectáreas ACRES—Para acres SQUARE_METERS—Para metros SQUARE_YARDS—Para yardas SQUARE_FEET—Para pies 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: CIRCLE—Las celdas que mantienen regiones circulares recibirán una ponderación superior. Esta es la opción predeterminada. ELLIPSE—Las celdas que mantienen regiones con forma elíptica recibirán una ponderación superior. TRIANGLE—Las celdas que mantienen regiones con forma de triángulo equilátero recibirán una ponderación superior. SQUARE—Las celdas que mantienen regiones con forma cuadrada recibirán una ponderación superior. PENTAGON—Las celdas que mantienen regiones con forma de pentágono recibirán una ponderación superior. HEXAGON—Las celdas que mantienen regiones con forma de hexágono recibirán una ponderación superior. OCTAGON—Las celdas que mantienen regiones con forma de octágono recibirán una ponderación superior.	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: HIGHEST_AVERAGE_VALUE—Selecciona las regiones según el valor medio más alto. Esta es la opción predeterminada. HIGHEST_SUM—Selecciona las regiones según la suma más alta. HIGHEST_MEDIAN_VALUE—Selecciona las regiones según el valor de mediana más alto. HIGHEST_VALUE—Selecciona las regiones según el valor de celda individual más alto incluido en la región. Con esta opción se garantiza la selección de las mejores celdas individuales. LOWEST_VALUE—Selecciona las regiones según el valor de celda individual más alto o más bajo incluido en la región. Con esta opción se garantiza que las regiones seleccionadas contienen celdas con un valor de utilidad realmente bajo. GREATEST_CORE_AREA—Selecciona las regiones según el área central más grande.Cualquier celda que esté alejada más de una celda desde el borde de una región se considera que forma parte del centro. La distancia de los bordes se puede controlar mediante el tamaño de celda del análisis. Si se define un tamaño de celda más pequeño puede aumentar el área central. HIGHEST_CORE_SUM—Selecciona las regiones según la suma acumulada más alta de los valores de utilidad para el área central. La distancia de los bordes se puede controlar mediante el tamaño de celda del análisis. GREATEST_EDGE—Selecciona las regiones según la cantidad de bordes más grande, utilizando la relación P1, que es la relación entre el perímetro de la forma y el perímetro de un círculo de la misma área. La relación P1 de un círculo es 1.	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: MAP_UNITS—Para las unidades lineales de la referencia espacial de salida MILES—Para millas KILOMETERS—Para kilómetros METERS—Para metros YARDS—Para yardas FEET—Para pies 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: FOUR—Solo los cuatro vecinos directos (ortogonales) de las celdas de la región se tendrán en cuenta en el crecimiento de la región. EIGHT—Los ocho vecinos más cercanos (ortogonales y diagonales) se tendrán en cuenta en el crecimiento de la región. Esta es la opción predeterminada.	String
no_islands (Opcional)	Define si se permitirán o no islas dentro de las posibles regiones. NO_ISLANDS—El algoritmo de crecimiento de regiones parametrizado garantiza que no habrá islas dentro de una región.Se implementa un algoritmo de campo de inundación como proceso posterior una vez que se crean las regiones, pero antes de seleccionarlas. Si hay islas dentro de una región, se rellenarán y las celdas se unirán a la región. Dado que el proceso de relleno se lleva a cabo antes del proceso de selección, se agregará la utilidad de las celdas de islas a la región y sus valores se incluirán en el proceso de selección de las regiones y en las estadísticas de las regiones de salida. Como resultado del proceso de relleno, es probable que el área total asignada supere el valor de total_area objetivo.Esta es la opción predeterminada. ISLANDS_ALLOWED—Se permitirán islas.	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: AUTO—El número de valores de inicialización se basará en el número de celdas del ráster de entrada. Si el ráster de entrada tiene 100.000 celdas o menos, el valor predeterminado es Maximum. Si el ráster de entrada tiene más de 100.000 celdas, el valor predeterminado es Small. Esta es la opción predeterminada. SMALL—El número de valores de inicialización será igual al 10% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 1.600 valores de inicialización. MEDIUM—El número de valores de inicialización será igual al 20% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 2.500 valores de inicialización. LARGE—El número de valores de inicialización será igual al 30% del número de celdas en el ráster de entrada, después de excluir las celdas NoData; pero no deberá superar los 3.600 valores de inicialización. MAXIMUM—El crecimiento de regiones se producirá en cada celda disponible dentro del ráster de entrada. Las celdas disponibles son aquellas que no son NoData y que no están identificadas como una región existente.	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: AUTO—La resolución se basará en el número de celdas del ráster de entrada. Si el ráster de entrada tiene 500.000 celdas o menos, el valor predeterminado es Maximum. Si el ráster de entrada tiene más de 500.000 celdas, el valor predeterminado es Low. Esta es la opción predeterminada. LOW—El análisis se realizará en un ráster intermedio que contenga 147.356 (384 x 384) celdas distribuidas con la misma relación x e y que el ráster de entrada. MEDIUM—El análisis se realizará en un ráster intermedio que contenga 262.144 (512 x 512) celdas distribuidas con la misma relación x,y que el ráster de entrada. HIGH—El análisis se realizará en un ráster intermedio que contenga 589.824 (768 x 768) celdas distribuidas con la misma relación x e y que el ráster de entrada. MAXIMUM—El análisis se realizará en todas las celdas del ráster de entrada.	String
selection_method (Opcional)	Identifica cómo se seleccionarán las regiones. Las opciones disponibles son las siguientes: AUTO—El método de selección se basa en el parámetro Número de regiones. Si el Número de regiones es ocho o menos, se utilizará el método de selección Combinatorial. Si el parámetro Número de regiones es mayor que ocho, se utilizará el método de selección Sequential. Esta es la opción predeterminada. COMBINATORIAL—Selecciona las mejores regiones según el método de evaluación especificado, respetando las restricciones espaciales, probando todas las combinaciones del número de regiones deseadas dentro de las regiones candidatas mediante el algoritmo de crecimiento de regiones parametrizado (PRG). SEQUENTIAL—Selecciona secuencialmente las mejores regiones según el método de evaluación y siempre que cumplan las restricciones espaciales hasta alcanzar el número de regiones deseadas.	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: AVERAGE—El valor medio de utilidad de la región. TOTAL—La suma total de los valores de utilidad dentro de la región. MEDIAN—El valor de la mediana de utilidad de la región. HIGHEST—El valor de celda individual más alto incluido en la región. LOWEST—El valor de celda individual más bajo incluido en la región. COREAREA—El área central. Cualquier celda que esté alejada más de una celda desde el borde de la región se considera que forma parte del centro. CORESUM—La suma acumulada de los valores de utilidad para el área central. EDGE—La cantidad de bordes utilizando la relación P1, que es la relación entre el perímetro de la forma y el perímetro de un círculo de la misma área. La relación P1 de un círculo es 1.	Raster

Muestra de código

Ejemplo 1 de LocateRegions (ventana de Python)

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")

Ejemplo 2 de LocateRegions (script independiente)

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

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Estadísticas de ráster, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela