!= (Relational Not Equal) operator

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Résumé

Returns 1 for cells where the first raster is not equal to the second raster and 0 for cells where it is equal.

Illustration

OutRas = Raster("InRas1") != 2

Discussion

Returns 1 for cells where the first raster does not equal the second raster and 0 for cells where it does.

Lorsque vous utilisez un opérateur avec un raster en entrée, le résultat est un raster. En revanche, si toutes les entrées sont des nombres, le résultat est un nombre.

Si plusieurs opérateurs sont utilisés dans une expression, ils ne sont pas nécessairement exécutés de gauche à droite. L'opérateur doté de la valeur de priorité la plus élevée est exécuté en premier. Pour plus d'informations sur la priorité des opérateurs, consultez la rubrique Table de priorité des opérateurs. Vous pouvez utiliser des parenthèses pour contrôler l'ordre d'exécution.

Les opérateurs booléens (~, &, ^, |) ont une priorité supérieure aux opérateurs relationnels (<, <=, >, >=, ==, !=). Par conséquent, si des opérateurs booléens sont utilisés dans la même expression que des opérateurs relationnels, les opérateurs booléens sont exécutés en premier. Pour modifier l'ordre d'exécution, utilisez des parenthèses.

Si plusieurs opérateurs relationnels et/ou booléens sont utilisés consécutivement dans une expression individuelle, dans certains cas, elle peut ne pas s'exécuter. Pour éviter ce problème éventuel, utilisez des parenthèses appropriées dans l'expression afin de définir explicitement l'ordre d'exécution des opérateurs. Pour plus d'informations, reportez-vous à la rubrique Règles des instructions complexes.

Deux entrées sont nécessaires pour que l'évaluation puisse avoir lieu.

L'ordre de saisie est sans importance pour cet opérateur.

Si les deux entrées correspondent à des rasters monocanaux ou que l’une des entrées est une constante, la sortie correspond à un raster monocanal.

Si les deux entrées correspondent à des rasters multicanaux ou que l’une des entrées est une constante, la sortie correspond à un raster multicanal. Le nombre de canaux de chaque entrée multicanal doit être identique.

L’opérateur effectue l’opération sur chaque canal d’une entrée par rapport au canal correspondant de l’autre entrée. Si l’une des entrées correspond à un raster multicanal et que l’autre entrée est une constante, l’opérateur effectue l’opération par rapport à la valeur constante de chaque canal de l’entrée multicanal.

Syntaxe

in_raster_or_constant1 != in_raster_or_constant2

Opérande	Explication	Type de données
in_raster_or_constant1	The input that will be compared to for inequality by the second input. Si l'une des entrées est un raster et l'autre un scalaire, un raster en sortie est créé et une évaluation est effectuée pour chaque cellule du raster en entrée.	Raster Layer | Constant
in_raster_or_constant2	The input that will be compared from for inequality by the first input. Si l'une des entrées est un raster et l'autre un scalaire, un raster en sortie est créé et une évaluation est effectuée pour chaque cellule du raster en entrée.	Raster Layer | Constant

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Objet raster en sortie. Where cell values in the first input and second inputs are not equal, the output cell value will be 1. If the values are equal, the output value will be 0.	Raster

Exemple de code

!= (Not Equal) example 1 (Python window)

This sample performs a Not Equal operation on two input rasters.

# Name: Op_NotEqual_Ex_02.py
# Description: Performs a relational not-equal operation on two
#              inputs on a cell-by-cell basis
# 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 = Raster("degs")
inRaster2 = Raster("negs")

# Execute NotEqual
outNotEqual = inRaster1 != inRaster2

# Save the output 
outNotEqual.save("C:/iapyexamples/output/outnotequal")

!= (Not Equal) example 2 (stand-alone script)

This sample performs a Not Equal operation on two input rasters.

# Name: Op_NotEqual_Ex_02.py
# Description: Performs a relational not-equal operation on two
#              inputs on a cell-by-cell basis
# 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 = Raster("degs")
inRaster2 = Raster("negs")

# Execute NotEqual
outNotEqual = inRaster1 != inRaster2

# Save the output 
outNotEqual.save("C:/iapyexamples/output/outnotequal")

Environnements

Taille de cellule, Espace de travail courant, Masquer, Système de coordonnées en sortie, Etendue, Espace de travail temporaire, Raster de capture