Skip to main content

SetNull (Outils Image Analyst)

Résumé

Définit les emplacements de cellule identifiés sur la valeur NoData en fonction des critères indiqués. Elle renvoie une valeur NoData si une évaluation conditionnelle est vraie et renvoie la valeur spécifiée par un autre raster si l’évaluation conditionnelle est fausse.

En savoir plus sur la définition de valeurs de cellule sur NoData avec l’outil SetNull

Illustration

! Illustration de l’outil SetNull

OutRas = SetNull(InRas1, InRas2, "Value = 4")

Utilisation

  • Si l'évaluation de la clause Where est vraie, l'emplacement de cellule dans le raster se verra attribuer la valeur NoData. Si l'évaluation est fausse, le raster en sortie sera défini par le raster de valeurs fausses ou la valeur constante en entrée.

  • Si aucune clause Where n'est spécifiée, le raster en sortie recevra un valeur NoData partout où le raster de condition est différent de 0.

  • Le raster de condition en entrée n'influe pas sur le type de données en sortie : nombre entier ou virgule flottante. Si le raster de valeurs fausses (ou la valeur constante) en entré contient des valeurs à virgule flottante, le raster en sortie contiendra des valeurs à virgule flottante. S'il ne contient que des entiers, la sortie sera un raster d'entiers.

  • Si le raster Input conditional raster (Raster de condition en entrée) (in_conditional_raster dans Python) est un raster monobande et que le raster Input false raster or constant value (Raster de valeurs fausses ou valeur constante en entrée) (in_false_raster_or_constant dans Python) est une constante, la sortie sera un raster monobande.

  • Si les deux entrées sont des rasters multicanaux, la sortie est un raster multicanal. Le raster en sortie est également multicanal si l’entrée de raster de valeurs fausses est une constante. Le nombre de canaux dans chaque entrée multi-canaux doit être identique.

  • L’outil exécute l’opération sur chaque canal du raster de condition, en utilisant le canal correspondant de l’autre entrée. Si l’entrée conditionnelle est un raster multicanal et que l’entrée de raster de valeurs fausses est une constante, l’outil exécute l’opération en utilisant la valeur constante de chaque canal de l’entrée multicanal.

  • L’expression utilise une requête SQL. Reportez-vous aux rubriques suivantes pour en savoir plus sur la création des requêtes :

– Pour utiliser une {where_clause} dans Python, placez-la entre guillemets. Par exemple, "Value > 5000".

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

  • La longueur maximale de l'expression logique est de 4 096 octets.

Paramètres

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 de valeurs fausses 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 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.

La Where clause (Clause Where) suit la forme générale d’une expression SQL. Elle peut être saisie 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.

Si l'évaluation conditionnelle est vraie, la valeur NoData est renvoyée. Si elle est fausse, la valeur du deuxième raster en entrée est renvoyée.

Raster

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, 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