Diff (Image Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Determina qué valores de la primera entrada son lógicamente diferentes de los valores de la segunda entrada en una base celda a celda.

Si los valores en las dos entradas son diferentes, el valor de la primera entrada es la salida. Si los valores en las dos entradas son iguales, la salida es 0.

Ilustración

Ilustración de Diff
OutRas = Diff(InRas1, InRas2)

Uso

  • Se necesitan dos entradas para que ocurra esta evaluación lógica.

  • El orden de entradas es importante para esta herramienta.

  • Si las dos entradas son enteros, la salida será un ráster entero; de lo contrario, será un ráster de punto flotante.

  • 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.

  • En ArcPy, si ambas entradas son rásteres 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 y la salida será un ráster multidimensional. Las variables en las entradas deben tener las mismas dimensiones o dimensión común, pero no dimensiones inusuales.

    Si ambas entradas tienen una variable pero nombres diferentes, establezca el entorno de geoprocesamiento matchMultidimensionalVariable en False para realizar la operación.

    En ArcPy, 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 con la que la que se comparará 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 con la que la que se comparará 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 en la salida serán 0, si los dos valores de entrada son iguales, o el primer valor de entrada si no lo son.

Raster

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

La entrada con la que la que se comparará 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 con la que la que se comparará 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 en la salida serán 0, si los dos valores de entrada son iguales, o el primer valor de entrada si no lo son.

Raster

Muestra de código

Ejemplo 1 de Diff (ventana de Python)

Este ejemplo realiza una operación de diferencia sobre dos rásteres Grid y genera el resultado como un ráster IMG.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outDiff = Diff("degs", "negs")
outDiff.save("C:/iapyexamples/output/outdiff.img")
Ejemplo 2 de Diff (script independiente)

Este ejemplo realiza una operación de diferencia sobre dos rásteres Grid.

# Name: Diff_Ex_02.py
# Description: Determines which values from the first input are
#              logically different from the values of the second input
#              on a pixel-by-pixel basis within the Analysis window
# Requirements: Image Analyst Extension

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

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

# Set local variables
inRaster1 = "degs"
inRaster2 = "negs"

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

# Execute Diff
outDiff = Diff(inRaster1, inRaster2)

# Save the output 
outDiff.save("C:/iapyexamples/output/outdiff")

Información de licenciamiento

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

Temas relacionados