Con (Outils Image Analyst)

Résumé

Exécute une évaluation conditionnelle if/else sur chacune des cellules en entrée d’un raster en entrée.

En savoir plus sur l’évaluation conditionnelle à l’aide de l’outil Con

Illustration

Utilisation

Si le raster vrai ou le raster faux en option est à virgule flottante, le raster en sortie l’est également. Si l’expression vraie et le raster faux en option sont des entiers, le raster en sortie est un entier.
Si le raster indiqué dans Input conditional raster (Raster de condition en entrée) (in_conditional_raster dans Python) est un raster à une seule bande et que le raster indiqué dans Input true raster or constant value (Raster vrai ou valeur constante en entrée) (in_true_raster_or_constant dans Python) ou le raster facultatif indiqué dans Input false raster or constant value (Raster faux ou valeur constante en entrée) (in_false_raster_or_constant dans Python) est une constante, la sortie est un raster à une seule bande.
Si toutes les entrées sont des rasters multibandes, la sortie est un raster multibande. Le raster en sortie est également multibande si l’entrée vraie ou l’entrée fausse facultative est une constante. Le nombre de bandes dans chaque entrée multibande doit être identique.
L’outil exécute l’opération sur chaque bande du raster de condition, en utilisant la bande correspondante des autres entrées. Si l’entrée conditionnelle est un raster multibande et que le raster vrai ou faux en entrée est une constante, l’outil exécute l’opération en utilisant la valeur constante de chaque bande de l’entrée multibande.
Si l’évaluation de l’expression est différente de zéro, elle est traitée en tant que true (vraie).
Si le paramètre Input false raster or constant value (Raster faux ou valeur constante en entrée) n’est pas spécifié, la valeur NoData est attribuée aux cellules pour lesquelles l’expression ne produit pas la valeur vrai.
Si cette valeur NoData n'est pas conforme à l'expression, vous n'obtenez pas la valeur du raster false en entrée. Vous devez donc conserver la valeur NoData.
Une requête SQL est utilisée dans Expression. Reportez-vous aux rubriques suivantes pour en savoir plus sur la création de requêtes :
- Créer une requête SQL
- Référence SQL pour les expressions de requête utilisées dans ArcGIS

– Pour utiliser un élément {where_clause} dans Python, placez-le entre guillemets. Par exemple, "Value > 5000".

Vous pouvez consulter l’aide pour plus d’informations sur la spécification d’une requête dans Python.

Dans Python, vous pouvez éviter d’utiliser un élément {where_clause} spécifiant le champ Value en utilisant à la place une expression d’algèbre spatiale comme in_conditional_raster.

Par exemple, l'expression suivante :
- Con("elev", 0, 1, "value > 1000")
peut être réécrite comme suit :
- Con(Raster("elev") > 1000, 0, 1)
Pour plus d’informations, reportez-vous aux exemples de code répertoriés ci-dessous ou consultez la rubrique Instructions complexes dans Algèbre spatial.
La longueur maximale de l'expression logique est de 4 096 octets.
Si au moins l’une des entrées correspond à des données raster multidimensionnelles comportant le même nombre de variables, l’outil effectue l’opération pour toutes les tranches dont la valeur de dimension est identique. La sortie est un raster multidimensionnel au format CRF. Les variables des entrées doivent posséder au moins une dimension en commun et une valeur dimensionnelle en commun à traiter par cet outil ; sinon, une erreur est générée.

Si deux entrées quelconques sont des rasters multidimensionnels et partagent une variable, mais ont des noms différents, désélectionnez l’environnement de géotraitement Match Multidimensional Variable (Apparier la variable multidimensionnelle) (définissez arcpy.env.matchMultidimensionalVariable = False dans Python) avant d’exécuter l’outil.

Si la valeur Input conditional raster (Raster de condition en entrée) est un raster multidimensionnel et que les paramètres Input true raster or constant value (Raster vrai ou valeur constante en entrée) et Input false raster or constant value (Raster faux ou valeur constante en entrée) sont définis sur des valeurs constantes, l’outil effectue l’opération pour toutes les tranches de toutes les variables à l’aide des valeurs constantes et la sortie est un raster multidimensionnel.
Lorsque le raster en entrée comporte des cellules rectangulaires, il est traité de telle sorte que les cellules du raster en sortie soient carrées avec des côtés égaux à la moyenne de la longueur et de la largeur des cellules rectangulaires.

Etiqueter	Explication	Type de données
Raster de condition en entrée	Raster en entrée représentant le résultat vrai ou faux de la condition souhaitée. Il peut être de type entier ou à virgule flottante.	Raster Layer
Raster vrai ou valeur constante en entrée	Entrée dont les valeurs seront utilisées en tant que valeurs de cellule en sortie si la condition est vraie. Il peut s’agir d’un raster de type entier ou à virgule flottante ou d’une valeur constante.	Raster Layer; Constant
Raster faux ou valeur constante en entrée (Facultatif)	Entrée dont les valeurs seront utilisées en tant que valeurs de cellule en sortie si la condition est fausse. Il peut s’agir d’un raster de type entier ou à virgule flottante ou d’une valeur constante.	Raster Layer; Constant
Expression (Facultatif)	Expression logique qui détermine lesquelles des cellules en entrée sont vraies ou fausses. L’élément Where clause (Clause Where) suit la forme générale d’une expression SQL. Vous pouvez le saisir directement, par exemple VALUE > 100, en cliquant sur le bouton du mode Edit SQL (Éditeur SQL) . Si vous êtes en mode Edit Clause (Modifier la clause) , vous pouvez commencer à créer l’expression en cliquant sur le bouton du mode Add Clause (Ajouter une clause).	SQL Expression

Valeur de retour

Etiqueter	Explication	Type de données
Raster en sortie	Raster en sortie.	Raster

Con(in_conditional_raster, in_true_raster_or_constant, {in_false_raster_or_constant}, {where_clause})

Nom	Explication	Type de données
in_conditional_raster	Raster en entrée représentant le résultat vrai ou faux de la condition souhaitée. Il peut être de type entier ou à virgule flottante.	Raster Layer
in_true_raster_or_constant	Entrée dont les valeurs seront utilisées en tant que valeurs de cellule en sortie si la condition est vraie. Il peut s’agir d’un raster de type entier ou à virgule flottante ou d’une valeur constante.	Raster Layer; Constant
in_false_raster_or_constant (Facultatif)	Entrée dont les valeurs seront utilisées en tant que valeurs de cellule en sortie si la condition est fausse. Il peut s’agir d’un raster de type entier ou à virgule flottante ou d’une valeur constante.	Raster Layer; Constant
where_clause (Facultatif)	Expression logique qui détermine lesquelles des cellules en entrée sont vraies ou fausses. L’expression suit la forme générale d’une expression SQL. "VALUE > 100" est un exemple de saisie pour `where_clause`.	SQL Expression

Valeur de retour

Nom	Explication	Type de données
out_raster	Raster en sortie.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction Con (fenêtre Python)

Dans cet exemple, la valeur initiale est conservée dans la sortie lorsque la valeur du raster de condition en entrée est supérieure à 2 000. Lorsque ce n’est pas le cas, la valeur NoData s’applique.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/output/data"
outCon = Con("elevation", "elevation", "", "VALUE > 2000")
outCon.save("C:/output/outcon.img")

# Run Con using a map algebra expression instead of a where clause
outCon2 = Con(Raster("elevation") > 2000, "elevation")
outCon2.save("C:/output/outcon2")

Exemple 2 d’utilisation de la fonction Con (fenêtre Python)

Dans cet exemple, la valeur d’origine est conservée dans la sortie à l’exception de la valeur NoData, qui est remplacée par 0.

# Name: Con_Ex_02.py
# Description: Performs a conditional if/else evaluation
#              on each pixel of an input raster.
# Requirements: Image Analyst extension

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

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

# Set local variables
inRaster = Raster("elevation")
inTrueRaster = 1
inFalseConstant = 0
whereClause = "VALUE >= 1500"

# Run Con and save the output
outCon = Con(inRaster, inTrueRaster, inFalseConstant, whereClause)
outCon.save("C:/output/outcon.tif")

# Run Con using a map algebra expression instead of a where clause, and save the output.
outCon2 = Con(inRaster >= 1500, inTrueRaster, inFalseConstant)
outCon2.save("C:/output/outcon2.tif")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Requiert Image Analyst ou Spatial Analyst
Standard: Requiert Image Analyst ou Spatial Analyst
Advanced: Requiert Image Analyst ou Spatial Analyst

Con (Outils Image Analyst)

Résumé

Illustration

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes