Dividir (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Disponible con una licencia de 3D Analyst.

Resumen

Divide los valores de dos rásteres celda por celda.

Ilustración

Ilustración de Dividir
OutRas = Divide (InRas1, InRas2)

Uso

  • El orden de entradas es importante para esta herramienta.

  • Cuando se divide un número por cero, el resultado de salida es NoData.

  • Los tipos de datos de las entradas para determinar el tipo de salida:

    • Si ambas entradas son números enteros, se realiza una división de números enteros, y el resultado de salida es un número entero. Por ejemplo, si se divide 3 por 2, el resultado es 1.
    • Si alguna de las entradas es un punto flotante, se realiza una división de puntos flotantes y el resultado de salida es un valor de punto flotante. Por ejemplo, si se divide 3 por 2.0, el resultado es 1.5.

  • Si ambas entradas son rásteres de banda única o una de las entradas es una constante, la salida será un ráster de banda única.

  • Si ambas entradas son rásteres multibanda, la herramienta realizará la operación en cada banda desde una entrada y la salida será un ráster multibanda. El número de bandas en cada entrada multibanda debe ser el mismo.

  • Si una de las entradas es un ráster multibanda y la otra entrada es una constante, la herramienta realizará la operación con el valor constante de cada banda de la entrada multibanda, y la salida será un ráster multibanda.

  • Si ambas entradas son datos ráster multidimensionales con el mismo número de variables, la herramienta realizará la operación para todas las porciones con el mismo valor de dimensión. La salida será un ráster multidimensional en formato CRF. Las variables de las entradas deben tener al menos una dimensión común y un valor dimensional común para que esta herramienta procese; de lo contrario, se producirá un error.

    Si ambas entradas tienen una variable pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (definido como arcpy.env.matchMultidimensionalVariable = False en Python) antes de ejecutar la herramienta.

    Si una de las entradas es un ráster multidimensional y la otra entrada es una constante, la herramienta realizará la operación en todas las porciones de todas las variables respecto al valor constante y la salida será un ráster multidimensional.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada o valor constante 1

La entrada cuyos valores se dividirán por la segunda entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
Ráster de entrada o valor constante 2

La entrada cuyos valores se dividirán por la primera entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Los valores de celda serán el cociente del primer ráster de entrada (dividendo) dividido por la segunda entrada (divisor).

Raster

Divide(in_raster_or_constant1, in_raster_or_constant2)
NombreExplicaciónTipo de datos
in_raster_or_constant1

La entrada cuyos valores se dividirán por la segunda entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
in_raster_or_constant2

La entrada cuyos valores se dividirán por la primera entrada.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Los valores de celda serán el cociente del primer ráster de entrada (dividendo) dividido por la segunda entrada (divisor).

Raster

Muestra de código

Ejemplo 1 de Dividir (ventana de Python)

En este ejemplo se dividen los valores del primer ráster de entrada por el segundo.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outDivide = Divide("degs", "negs")
outDivide.save("C:/sapyexamples/output/outdivide2")
Ejemplo 2 de Dividir (script independiente)

En este ejemplo se dividen los valores del primer ráster de entrada por el segundo.

# Name: Divide_Ex_02.py
# Description: Divides the values of two rasters on a cell-by-cell basis
# 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
inRaster01 = "elevation"
inRaster02 = "landuse"

# Execute Divide
outDivide = Divide(inRaster01, inRaster02)

# Save the output 
outDivide.save("C:/sapyexamples/output/outdivide")