División en zonas (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con una licencia de 3D Analyst.

Resumen

Divide o reclasifica el rango de valores de las celdas de entrada en zonas (clases). Los métodos de clasificación de datos disponibles son intervalos iguales, áreas equivalentes (cuantiles), rupturas naturales, desviación estándar (centrada en el medio), desviación estándar (valor medio como ruptura), intervalo definido e intervalo geométrico.

Uso

  • Las siguientes opciones están disponibles para el parámetro Método de división en zonas. Generan zonas de salida con distintas características.

    • Áreas equivalentes: el ráster de salida tiene una cantidad de zonas definida, con una cantidad similar de celdas en cada zona.
    • Intervalo equivalente: el ráster de salida tiene una cantidad de zonas definida, y cada una contiene rangos de valores iguales.
    • Cortes naturales e Intervalo geométrico: el ráster de salida tiene una cantidad de zonas definida, con la cantidad de celdas de cada una determinada por los cortes de clase.
    • Desviación estándar (centrada en el medio), Desviación estándar (valor medio como descanso) e Intervalo definido: el ráster de salida tendrá la cantidad de zonas determinadas por el valor del parámetro Tamaño del intervalo, con la cantidad de celdas de cada una determinada por las rupturas de clase.

  • Dependiendo del método de división en zonas especificado, se debe especificar el valor del parámetro Número de zonas de salida o el valor del parámetro Tamaño del intervalo.

    • El parámetro Número de zonas de salida es obligatorio cuando se utilizan los métodos de división en zonas Área equivalente, Intervalo equivalente, Cortes naturales o Intervalo geométrico.
    • El parámetro Tamaño del intervalo es obligatorio si se utiliza el método de división en zonas Intervalo definido, Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como descanso).

  • Puede utilizar el parámetro Cambiar NoData a valor para salida para reemplazar los valores NoData con un valor entero en la salida. Si necesita evitar que las celdas NoData se combinen con cualquier zona de salida, especifique un valor entero que esté fuera del rango esperado de zonas de salida. Por ejemplo, con zonas de salida que van de 1 a 5, especifique un valor que sea menor que 1 o mayor que 5. Los valores candidatos incluyen 0, 100 y -99. Para fusionar valores NoData en una zona existente, use el valor entero para esta zona. Si no se establece este parámetro, las celdas NoData de entrada permanecerán como NoData en el ráster de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

El ráster de entrada que se reclasificará.

Raster Layer
Número de zonas de salida
(Opcional)

El número de zonas en las que se reclasificará el ráster de entrada.

Este parámetro es obligatorio cuando el valor del parámetro Método de división en zonas es Área equivalente, Intervalo equivalente, Cortes naturales o Intervalo geométrico.

Cuando el valor del parámetro Método de división en zonas es Intervalo definido, Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como descanso), el parámetro Número de zonas de salida estará inactivo. El número de zonas de salida estará determinado por el valor del parámetro Tamaño del intervalo.

Long
Método de división en zonas
(Opcional)

Especifica la forma en que el ráster de entrada se reclasificará en zonas.

  • Intervalo equivalenteEl rango de valores de entrada se dividirá de forma equivalente en el número especificado de zonas de salida para determinar los cortes de clase. Esta es la opción predeterminada.
  • Área igualEl número de celdas de entrada se dividirá de forma equivalente en el número especificado de zonas de salida para determinar los cortes de clase. Cada zona tendrá un número similar de celdas, lo que indica una cantidad similar de área.
  • Cortes naturalesLos cortes de clase se determinarán de forma que se minimice la variación dentro de las clases y se maximice la variación entre clases. Los cortes suelen establecerse en cambios relativamente grandes en los valores de los datos.
  • Desviación estándar (centrada en el valor medio)Los cortes de clase se colocarán por encima y por debajo del valor medio en un tamaño de intervalo especificado, como 2, 1 o 0,5 en la unidad de desviación estándar, hasta alcanzar los valores mínimo y máximo del ráster de entrada. El valor medio no se usa como un corte, sino que se centra en dos cortes de clase. Un corte está a la mitad del tamaño del intervalo especificado por encima de la media, y el otro está a la mitad del tamaño del intervalo especificado por debajo de la media. La desviación estándar se calcula con el denominador n-1, donde n es el número de píxeles con valor.
  • Desviación estándar (valor medio como corte)El valor medio se utilizará como un corte de clase. Otros cortes de clase se colocarán por encima y por debajo del valor medio en un tamaño de intervalo especificado, como 2, 1 o 0,5 en la unidad de desviación estándar, hasta alcanzar los valores mínimo y máximo del ráster de entrada. La desviación estándar se calcula con el denominador n-1, donde n es el número de píxeles con valor.
  • Intervalo definidoLos cortes de clase se establecerán en cero y un múltiplo del tamaño del intervalo especificado en relación con cero. Luego se recortarán a los valores mínimo y máximo de los datos de entrada para la primera y última clase. Para un rango de valores que contiene cero, cero siempre se incluirá como un punto de corte.
  • Intervalo geométricoLos cortes de clase se crearán en función de los intervalos de clase que tengan una serie geométrica. Este es un patrón en el que el valor actual es igual al valor anterior dividido por un coeficiente geométrico. El coeficiente geométrico de este clasificador puede cambiar una vez (a su inverso) para optimizar los rangos de clase. El algoritmo crea estos intervalos geométricos al minimizar la suma de cuadrados del número de elementos de cada clase. Con esto se garantiza que cada clase tenga aproximadamente el mismo número de valores y que el cambio entre intervalos sea coherente.
String
Valor de inicio para la salida.
(Opcional)

El valor de inicio que se usará para las zonas (clases) en el dataset de ráster de salida.

A las clases se les asignarán valores enteros, aumentando en 1 desde el valor inicial.

El valor de inicio predeterminado es 1.

Long
Cambiar NoData a valor para salida
(Opcional)

Reemplace NoData con un valor en la salida.

Si no se establece este parámetro, las celdas NoData permanecerán como NoData en el ráster de salida.

Long
Tamaño del intervalo
(Opcional)

El tamaño del intervalo entre clases.

Este parámetro es obligatorio si el parámetro Método de división en zonas se define como Intervalo definido, Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como descanso).

Si se usa Intervalo definido, el tamaño del intervalo indica el rango de valor real de una clase que se usa para calcular los cortes de clase.

Si se usa Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como descanso), el tamaño del intervalo indica la cantidad de desviaciones estándar utilizadas para calcular rupturas de clase.

Double

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster reclasificado de salida.

La salida siempre será de tipo entero.

La tabla de atributos del ráster de salida tendrá dos nuevos campos además de los campos estándar ObjectID, Value y Count. El campo Value indica el valor de clase. Los campos ZoneMin y ZoneMax registran los valores mínimo y máximo, respectivamente, utilizados para generar una clase.

Raster

Slice(in_raster, {number_zones}, {slice_type}, {base_output_zone}, {nodata_to_value}, {class_interval_size})
NombreExplicaciónTipo de datos
in_raster

El ráster de entrada que se reclasificará.

Raster Layer
number_zones
(Opcional)

El número de zonas en las que se reclasificará el ráster de entrada.

Este parámetro es obligatorio cuando el valor del parámetro slice_type es EQUAL_AREA, EQUAL_INTERVAL, NATURAL_BREAKS o GEOMETRIC_INTERVAL.

Cuando el valor del parámetro slice_type es STANDARD_DEVIATION_MEAN_CENTERED, STANDARD_DEVIATION_MEAN_BREAK o DEFINED_INTERVAL, el parámetro number_zones no se admite. El número de zonas de salida estará determinado por el valor del parámetro class_interval_size.

Long
slice_type
(Opcional)

Especifica la forma en que el ráster de entrada se reclasificará en zonas.

  • EQUAL_INTERVALEl rango de valores de entrada se dividirá de forma equivalente en el número especificado de zonas de salida para determinar los cortes de clase. Esta es la opción predeterminada.
  • EQUAL_AREAEl número de celdas de entrada se dividirá de forma equivalente en el número especificado de zonas de salida para determinar los cortes de clase. Cada zona tendrá un número similar de celdas, lo que indica una cantidad similar de área.
  • NATURAL_BREAKSLos cortes de clase se determinarán de forma que se minimice la variación dentro de las clases y se maximice la variación entre clases. Los cortes suelen establecerse en cambios relativamente grandes en los valores de los datos.
  • STANDARD_DEVIATION_MEAN_CENTEREDLos cortes de clase se colocarán por encima y por debajo del valor medio en un tamaño de intervalo especificado, como 2, 1 o 0,5 en la unidad de desviación estándar, hasta alcanzar los valores mínimo y máximo del ráster de entrada. El valor medio no se usa como un corte, sino que se centra en dos cortes de clase. Un corte está a la mitad del tamaño del intervalo especificado por encima de la media, y el otro está a la mitad del tamaño del intervalo especificado por debajo de la media. La desviación estándar se calcula con el denominador n-1, donde n es el número de píxeles con valor.
  • STANDARD_DEVIATION_MEAN_BREAKEl valor medio se utilizará como un corte de clase. Otros cortes de clase se colocarán por encima y por debajo del valor medio en un tamaño de intervalo especificado, como 2, 1 o 0,5 en la unidad de desviación estándar, hasta alcanzar los valores mínimo y máximo del ráster de entrada. La desviación estándar se calcula con el denominador n-1, donde n es el número de píxeles con valor.
  • DEFINED_INTERVALLos cortes de clase se establecerán en cero y un múltiplo del tamaño del intervalo especificado en relación con cero. Luego se recortarán a los valores mínimo y máximo de los datos de entrada para la primera y última clase. Para un rango de valores que contiene cero, cero siempre se incluirá como un punto de corte.
  • GEOMETRIC_INTERVALLos cortes de clase se crearán en función de los intervalos de clase que tengan una serie geométrica. Este es un patrón en el que el valor actual es igual al valor anterior dividido por un coeficiente geométrico. El coeficiente geométrico de este clasificador puede cambiar una vez (a su inverso) para optimizar los rangos de clase. El algoritmo crea estos intervalos geométricos al minimizar la suma de cuadrados del número de elementos de cada clase. Con esto se garantiza que cada clase tenga aproximadamente el mismo número de valores y que el cambio entre intervalos sea coherente.
String
base_output_zone
(Opcional)

El valor de inicio que se usará para las zonas (clases) en el dataset de ráster de salida.

A las clases se les asignarán valores enteros, aumentando en 1 desde el valor inicial.

El valor de inicio predeterminado es 1.

Long
nodata_to_value
(Opcional)

Reemplace NoData con un valor en la salida.

Si no se establece este parámetro, las celdas NoData permanecerán como NoData en el ráster de salida.

Long
class_interval_size
(Opcional)

El tamaño del intervalo entre clases.

Este parámetro es obligatorio si el parámetro slice_type se define como DEFINED_INTERVAL, STANDARD_DEVIATION_MEAN_CENTERED o STANDARD_DEVIATION_MEAN_BREAK.

Si se usa DEFINED_INTERVAL, el tamaño del intervalo indica el rango de valor real de una clase que se usa para calcular los cortes de clase.

Si se usa STANDARD_DEVIATION_MEAN_CENTERED o STANDARD_DEVIATION_MEAN_BREAK, el tamaño del intervalo indica la cantidad de desviaciones estándar utilizadas para calcular rupturas de clase.

Double

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

Ráster reclasificado de salida.

La salida siempre será de tipo entero.

La tabla de atributos del ráster de salida tendrá dos nuevos campos además de los campos estándar ObjectID, Value y Count. El campo Value indica el valor de clase. Los campos ZoneMin y ZoneMax registran los valores mínimo y máximo, respectivamente, utilizados para generar una clase.

Raster

Muestra de código

Ejemplo 1 de División en zonas (ventana de Python)

Reclasificar el ráster de entrada en cinco clases según las agrupaciones naturales inherentes a los datos.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", 5, "NATURAL_BREAKS")
outslice.save("C:/sapyexamples/output/elev_slice.tif")
Ejemplo 2 de División en zonas (ventana de Python)

Reclasifique el ráster de entrada con un intervalo definido igual a 10.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"

outslice = Slice("elevation", "", "DEFINED_INTERVAL", "", "", 10)
outslice.save("C:/sapyexamples/output/elev_slice_02.tif")
Ejemplo 3 de Slice (script independiente)

Reclasifique el ráster de entrada en 10 clases según las agrupaciones naturales inherentes a los datos y defina el valor inicial para las clases de salida en -5.

# Name: Slice_Ex_03.py
# Description: Slices the input raster into 10 zones(classes) based on natural groupings inherent in the data.
#              Specify the starting value for output classes to be -5.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = -5

# Execute Slice
outSlice = Slice(inRaster, numberZones, "NATURAL_BREAKS", baseOutputZone)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_03.tif")
Ejemplo 4 de Slice (script independiente)

Reclasifique el ráster de entrada en 10 clases de áreas equivalentes. Asigne celdas NoData para que tengan un valor de -99 en la salida.

# Name: Slice_Ex_04.py
# Description: Slices the input raster into 10 zones(classes) based on equal area.
#              Assign NoData cells to have a value of -99 in the output.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
numberZones = 10
baseOutputZone = 5
nodataToValue = -99
classIntervalSize = "" # or None

# Execute Slice
outSlice = Slice(inRaster, numberZones, "EQUAL_AREA", baseOutputZone, nodataToValue, classIntervalSize)

# Save the output
outSlice.save("C:/sapyexamples/output/elev_slice_04.tif")