Módulo (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Determina el resto (módulo) del primer ráster cuando se divide por el segundo ráster celda por celda.

Ilustración

Ilustración de Módulo
OutRas = Mod(InRas1, InRas2)

Uso

  • El orden de entradas es importante para esta herramienta.

  • Módulo 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.

  • 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 o una de las entradas es una constante, la salida será un ráster multibanda. El número de bandas de cada entrada multibanda debe ser el mismo.

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

  • En Álgebra de mapas, el símbolo del operador equivalente para esta herramienta es "%" (vínculo).

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Sintaxis

Mod(in_raster_or_constant1, in_raster_or_constant2)
ParámetroExplicaciónTipo 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 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 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 son el resto de la división de los valores de la primera entrada por la segunda entrada.

Raster

Muestra de código

Ejemplo 1 de Módulo (ventana de Python)

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")
Ejemplo 2 de Módulo (script independiente)

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"

# Execute Mod
outMod = Mod(inRaster1, inRaster2)

# Save the output 
outMod.save("C:/sapyexamples/output/outmod")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst o Image Analyst
  • Standard: Requiere Spatial Analyst o Image Analyst
  • Advanced: Requiere Spatial Analyst o Image Analyst

Temas relacionados