<= (Less Than Equal To) (arcpy.sa)

Récapitulatif

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

Illustration

Less Than or Equal To (Relational) operator illustration
OutRas = Raster("InRas1") <= 2

Discussion

The relational less-than-or-equal-to operation evaluates the first input value in relation to the second input value on a cell-by-cell basis within the Analysis window. In the relational evaluation, if the condition is true (the first input value is less than or equal to the second input value), the output is 1; if it is false, the output is 0.

    Input1 < Input2, Output = 1
    Input1 = Input2, Output = 1
    Input1 > Input2, Output = 0

When one or both input values are NoData, the output is NoData.

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.

Lorsque 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 précédence la plus élevée est exécuté en premier. Pour plus d'informations sur la précédence des opérateurs, consultez la rubrique Table de précédence des opérateurs. Vous pouvez utiliser des parenthèses pour contrôler l'ordre d'exécution.

Les opérateurs booléens (~, &, ^, |) ont un niveau de précédence supérieur à celui des opérateurs relationnels (<, <=, >, >=, ==, !=). Par conséquent, lorsque 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.

Lorsque 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 pertinent pour cet opérateur.

Les valeurs en sortie sont toujours de type entier.

Syntaxe

in_raster_or_constant1 <= in_raster_or_constant2
OpérandeExplicationType de données
in_raster_or_constant1

The input being tested to determine if it is less than or equal to 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 against which the first input is tested to be less than or equal to.

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

NomExplicationType de données
out_raster

Objet raster en sortie.

Where cell values in the first input are less than or equal to that of the second input, the output cell value will be 1. If the values of the first input are greater than the second, the output value will be 0.

Raster

Exemple de code

<= (Less Than Equal To) example 1 (Python window)

This sample performs a Less Than Equal To operation on two input rasters.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outLTE = Raster("degs") <= Raster("negs")
outLTE.save("C:/sapyexamples/output/outlte.img")
<= (Less Than Equal To) example 2 (stand-alone script)

This sample performs a Less Than Equal To operation on two input rasters.

# Name: Op_LessThanEqual_Ex_02.py
# Description: Performs a relational less-than-equal operation on two
#              inputs 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 = Raster("degs")
inRaster2 = Raster("negs")

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

# Execute LessThanEqual
outLTE = inRaster1 <= inRaster2

# Save the output 
outLTE.save("C:/sapyexamples/output/outlte")

Environnements

Thèmes connexes

9/12/2013