Mod (Spatial Analyst)
Resumen
Encuentra el resto (módulo) del primer ráster dividido por el segundo ráster, a través de cada celda individual.
Ilustración
 |
OutRas = Mod(InRas1, InRas2) |
Uso
El orden de entradas es importante para esta herramienta.
-
Mod asume que las dos entradas son enteros. Si alguna de las entradas no es un entero, esas entradas se convertirán a un entero mediante truncamiento. Los valores de salida siempre son enteros.
-
A todo valor modulado (dividido) por 0 se le asigna NoData en la salida. Por lo tanto, toda ubicación en la segunda entrada que sea 0 o NoData devolverá NoData para esa ubicación en la salida.
-
Si el segundo valor de entrada (el divisor) es más grande que el primer valor de entrada (el dividendo), la salida será el mismo valor que la primera entrada. Por ejemplo, si fuera a dividir un valor de 8 por el valor 10, el cálculo de división de enteros devolverá el valor de entrada 8 para el resto.
-
En Álgebra de mapas, el símbolo del operador equivalente para esta herramienta es "%" (vínculo).
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_raster_or_constant1 |
La entrada del numerador. 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 poder 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 del denominador. 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 poder 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
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de salida. Los valores de celda son el resto de la división de los valores de la primera entrada por la segunda entrada. | Raster |
Ejemplo de código
En este ejemplo se devuelve el valor del resto (módulo) de dividir las celdas en el primer ráster por el segundo.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outMod = Mod("degs", "negs")
outMod.save("C:/sapyexamples/output/outmod.tif")
En este ejemplo se devuelve el valor del resto (módulo) de dividir las celdas en el primer ráster por el segundo.
# Name: Mod_Ex_02.py
# Description: Finds the remainder of the first raster when divided by
# the second raster 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
inRaster1 = "degs"
inRaster2 = "negs"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Mod
outMod = Mod(inRaster1, inRaster2)
# Save the output
outMod.save("C:/sapyexamples/output/outmod")