División en zonas (Spatial 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 características diferentes.

    • Área equivalente: el ráster de salida tendrá un número de zonas definido, con un número similar de celdas en cada una.
    • Intervalo equivalente: la trama de salida tendrá el número definido de zonas, cada una de las cuales contendrá rangos de valores iguales.
    • Cortes naturales e Intervalo geométrico: el ráster de salida tendrá el número especificado de zonas, cada una con el número de celdas determinado por los saltos de clase.
    • Desviación estándar (centrada en el medio), Desviación estándar (valor medio como ruptura) e Intervalo definido: el ráster de salida tendrá el número de zonas determinado por el valor del parámetro Tamaño del intervalo, cada una con el número de celdas determinado por las rupturas de clase.

  • En función del método de división especificado, debe especificarse 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 necesario cuando se utiliza el método de división Área equivalente, Intervalo equivalente, Rupturas naturales o Intervalo geométrico.
    • El parámetro Tamaño del intervalo es necesario cuando se utiliza el método de división Intervalo definido, Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como ruptura).

  • Puede utilizar el parámetro Cambiar NoData a valor para salida para reemplazar los valores NoData por 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 menor que 1 o mayor que 5. Los valores candidatos son 0, 100 y -99. Para fusionar valores NoData en una zona existente, utilice el valor entero de esta zona. Si no se establece este parámetro, las celdas NoData de entrada permanecerán como NoData en el raster 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)

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

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

Si 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 ruptura), el parámetro Número de zonas de salida estará inactivo. El número de zonas de salida se determinará a partir del 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á por igual en el número especificado de zonas de salida para determinar las rupturas de clase. Esta es la opción predeterminada.
  • Área igualEl número de celdas de entrada se dividirá por igual en el número especificado de zonas de salida para determinar las rupturas de clase. Cada zona tendrá un número similar de celdas, lo que indica una cantidad similar de superficie.
  • Cortes naturalesLas rupturas de clase se determinarán de forma que se minimice la varianza dentro de las clases y se maximice la varianza entre clases. Las pausas suelen fijarse en cambios relativamente grandes de los valores de los datos.
  • Desviación estándar (centrada en el medio)Las rupturas 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 utiliza como ruptura, sino que se centra mediante dos rupturas de clase. Una ruptura está a la mitad del tamaño del intervalo especificado por encima del valor medio y la otra está a la mitad del tamaño del intervalo especificado por debajo del valor medio. La desviación estándar se calcula con el denominador n-1, siendo n el número de píxeles con valor.
  • Desviación estándar (valor medio como ruptura)El valor medio se utilizará como ruptura de clase. Otras rupturas 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, siendo n el número de píxeles con valor.
  • Intervalo definidoLas rupturas de clase se establecerán en cero y un múltiplo del tamaño del intervalo especificado relativo a cero. Luego se recortarán a los valores mínimo y máximo de los datos de entrada para la primera y la última clase. Para un rango de valores que contenga cero, este se incluirá siempre como punto de ruptura.
  • Intervalo geométricoLas rupturas de clase se crearán a partir de intervalos de clase que tengan una serie geométrica. Se trata de 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 minimizando la suma de cuadrados del número de elementos de cada clase. Esto garantiza que cada clase tenga aproximadamente el mismo número de valores y que el cambio entre intervalos sea coherente.
String
Valor inicial para salida
(Opcional)

Valor inicial que se utilizará para las zonas (clases) en el dataset ráster de salida.

A las clases se les asignarán valores enteros, que aumentarán en 1 a partir del valor inicial.

El valor inicial predeterminado es 1.

Long
Cambiar NoData a valor para salida
(Opcional)

Reemplaza NoData por un valor en la salida.

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

Long
Tamaño del intervalo
(Opcional)

Tamaño del intervalo entre clases.

Este parámetro es necesario cuando el parámetro Método de división de zonas se establece en Intervalo definido, Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como ruptura).

Si se utiliza Intervalo definido, el tamaño del intervalo indica el rango de valores real de una clase utilizado para calcular las rupturas de clase.

Si se utiliza Desviación estándar (centrada en el medio) o Desviación estándar (valor medio como ruptura), el tamaño del intervalo indica el número de desviaciones estándar utilizadas para calcular las 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)

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

Este parámetro es necesario 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, no se admite el parámetro number_zones. El número de zonas de salida se determinará a partir del 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á por igual en el número especificado de zonas de salida para determinar las rupturas de clase. Esta es la opción predeterminada.
  • EQUAL_AREAEl número de celdas de entrada se dividirá por igual en el número especificado de zonas de salida para determinar las rupturas de clase. Cada zona tendrá un número similar de celdas, lo que indica una cantidad similar de superficie.
  • NATURAL_BREAKSLas rupturas de clase se determinarán de forma que se minimice la varianza dentro de las clases y se maximice la varianza entre clases. Las pausas suelen fijarse en cambios relativamente grandes de los valores de los datos.
  • STANDARD_DEVIATION_MEAN_CENTEREDLas rupturas 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 utiliza como ruptura, sino que se centra mediante dos rupturas de clase. Una ruptura está a la mitad del tamaño del intervalo especificado por encima del valor medio y la otra está a la mitad del tamaño del intervalo especificado por debajo del valor medio. La desviación estándar se calcula con el denominador n-1, siendo n el número de píxeles con valor.
  • STANDARD_DEVIATION_MEAN_BREAKEl valor medio se utilizará como ruptura de clase. Otras rupturas 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, siendo n el número de píxeles con valor.
  • DEFINED_INTERVALLas rupturas de clase se establecerán en cero y un múltiplo del tamaño del intervalo especificado relativo a cero. Luego se recortarán a los valores mínimo y máximo de los datos de entrada para la primera y la última clase. Para un rango de valores que contenga cero, este se incluirá siempre como punto de ruptura.
  • GEOMETRIC_INTERVALLas rupturas de clase se crearán a partir de intervalos de clase que tengan una serie geométrica. Se trata de 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 minimizando la suma de cuadrados del número de elementos de cada clase. Esto 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)

Valor inicial que se utilizará para las zonas (clases) en el dataset ráster de salida.

A las clases se les asignarán valores enteros, que aumentarán en 1 a partir del valor inicial.

El valor inicial predeterminado es 1.

Long
nodata_to_value
(Opcional)

Reemplaza NoData por un valor en la salida.

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

Long
class_interval_size
(Opcional)

Tamaño del intervalo entre clases.

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

Si se utiliza DEFINED_INTERVAL, el tamaño del intervalo indica el rango de valores real de una clase utilizado para calcular las rupturas de clase.

Si se utiliza STANDARD_DEVIATION_MEAN_CENTERED o STANDARD_DEVIATION_MEAN_BREAK, el tamaño del intervalo indica el número de desviaciones estándar utilizadas para calcular las 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)

Reclasificar 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 División en zonas (secuencia de comandos independiente)

Reclasificar el ráster de entrada en 10 clases según las agrupaciones naturales inherentes a los datos y especificar que el valor inicial para las clases de salida sea -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 División en zonas (secuencia de comandos independiente)

Reclasificar el ráster de entrada en 10 clases de área iguales. Asignar a las celdas NoData 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")