Liste en entrée (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Disponible avec une licence Image Analyst.

Synthèse

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

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 multibande) est sélectionné (process_as_multiband est défini sur MULTI_BAND dans Python), chaque raster multibande en entrée est traité comme un raster multibande.

  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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster ou valeur constante en entrée	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 être tout d’abord définies dans l’environnement.	Raster Layer; Constant
Raster ou valeurs constantes en entrée	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 être tout d’abord définies dans l’environnement.	Raster Layer; Constant
Process as multiband (Traiter comme multicanal) (Facultatif)	Indique comment les canaux des rasters multicanaux en entrée sont traités. Désélectionnée : chaque 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. Cochée : chaque 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

Étiquette	Explication	Type de données
Raster en sortie	Raster en sortie.	Raster

Python

InList(in_raster_or_constant, in_raster_or_constants, {process_as_multiband})

Nom	Explication	Type 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 être tout d’abord 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 être tout d’abord 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_BAND—Chaque 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_BAND—Chaque 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

Nom	Explication	Type 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")

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: Nécessite Spatial Analyst ou Image Analyst
• Standard: Nécessite Spatial Analyst ou Image Analyst
• Advanced: Nécessite Spatial Analyst ou Image Analyst