Liste en entrée (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Résumé

Détermine quelles valeurs de la première entrée sont contenues dans un jeu d'autres entrées, cellule par cellule.

Pour chaque cellule, si la valeur du premier raster en entrée se trouve dans une des listes des autres entrées, elle sera affectée au raster en sortie. Si elle ne s'y trouve pas, la cellule en sortie aura la valeur NoData.

Illustration

Illustration de l'outil Liste en entrée
OutRas = InList(InRas1,[0, 2, 3, 7])

Utilisation

  • Si toutes les entrées sont des nombres entiers, le raster en sortie sera également de type entier. Si certaines entrées sont à virgule flottante, le raster en sortie sera de type virgule flottante.

  • Dans la liste des rasters en entrée, l'ordre n'a pas d'incidence sur le résultat de cet outil.

  • Si le paramètre Process as multiband (Traiter comme multicanal) n’est pas sélectionné (process_as_multiband est défini sur SINGLE_BAND dans Python), seul le premier canal d’un raster ou valeur constante en entrée multicanal (input_raster_or_constant dans Python) est utilisé. Chaque canal d’un raster ou valeur constante en entrée multicanal (in_rasters_or_constants dans Python) est traité séparément en tant que raster monocanal.

  • Si le paramètre Process as multiband (Traiter comme multicanal) est coché (process_as_multiband défini sur MULTI_BAND dans Python), chaque raster multicanal en entrée sera traité comme un raster multicanal.

    Le nombre de canaux dans la sortie dépend du paramètre Input raster or constant value (Raster ou valeur constante en entrée). Si le raster en entrée est un canal unique ou une constante, le nombre de canaux du raster en sortie est identique au nombre maximal de canaux de tous les rasters multicanaux des rasters ou valeurs constantes en entrée. Si le raster en entrée est multicanal, le raster en sortie comporte le même nombre de canaux que le raster en entrée.

    Si l’un des rasters ou valeurs constantes en entrée est un raster comportant un nombre de canaux inférieur à celui du raster en sortie, les canaux manquants sont interprétés comme remplis de valeurs NoData. Si l’une des entrées de la liste en entrée est une constante, elle est interprétée en tant que raster multicanal, dans lequel les valeurs de cellule de tous les canaux sont identiques à la constante et possèdent le même nombre de canaux que le raster en sortie.

  • Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Syntaxe

InList(in_raster_or_constant, in_raster_or_constants, {process_as_multiband})
ParamètreExplicationType de données
in_raster_or_constant

Entrée qui définit la valeur qui sera recherchée dans une liste de raster, dans chaque cellule individuelle.

Un nombre peut être utilisé en entrée pour ce paramètre, à condition qu'un raster soit spécifié pour l'autre paramètre. Pour spécifier un nombre pour les deux entrées, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.

Raster Layer; Constant
in_raster_or_constants
[in_raster_or_constant,...]

Liste de rasters en entrée par rapport auxquels la première entrée sera évaluée. Pour chaque emplacement, si la valeur de cellule de la première entrée existe dans l’un des autres rasters, elle est affectée au raster en sortie. Si la valeur n’existe dans aucun autre raster, la valeur en sortie dans cet emplacement est considérée comme NoData.

Un nombre peut être utilisé en entrée pour ce paramètre, à condition qu'un raster soit spécifié pour l'autre paramètre. Pour spécifier un nombre pour les deux entrées, la taille de cellule et l’étendue doivent d’abord être définies dans l’environnement.

Raster Layer; Constant
process_as_multiband
(Facultatif)

Indique comment les canaux des rasters multicanaux en entrée sont traités.

  • SINGLE_BANDChaque canal d’une entrée de raster multicanal est traité séparément comme un raster monocanal. Il s’agit de l’option par défaut.
  • MULTI_BANDChaque entrée de raster multicanal est traitée comme un raster multicanal. L’opération est effectuée pour chaque canal d’une même entrée en utilisant le numéro de canal correspondant des autres entrées.
Boolean

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie.

Raster

Exemple de code

1er exemple d'utilisation de l'outil InList (fenêtre Python)

Cet exemple détermine les valeurs de cellule de la première entrée qui se trouvent dans le jeu des autres rasters en entrée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outInList = InList("redlandsc1", ["redlandsc2", "redlandsc3"])
outInList.save("C:/sapyexamples/output/outinlist.tif")
2e exemple d'utilisation de l'outil InList (script autonome)

Cet exemple détermine les valeurs de cellule de la première entrée qui se trouvent dans le jeu des autres rasters en entrée.

# Name: InList_Ex_02.py
# Description: Determines which values from the first input are
#              contained in the other inputs
# 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 = "redlandsc1"
inRaster2 = "redlandsc2"
inRaster3 = "redlandsc3"

# Execute InList
outInList = InList(inRaster1, [inRaster2, inRaster3])

# Save the output 
outInList.save("C:/sapyexamples/output/outinlist")

Informations de licence

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

Rubriques connexes