Liste en entrée (Outils Spatial 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 l’une des listes d’autres entrées, elle est attribuée au raster en sortie. Si elle ne s’y trouve pas, la cellule en sortie prend la valeur NoData.

Illustration

Utilisation

Si toutes les entrées sont des entiers, le raster en sortie est également de type entier. Si certaines entrées sont à virgule flottante, la sortie est de type flottant.
Dans la liste des rasters en entrée, l’ordre n’est pas pertinent pour le résultat de cet outil.
Si le paramètre Process as multiband (Traiter comme multibande) n’est pas sélectionné (process_as_multiband défini sur SINGLE_BAND dans Python), seul la première bande d’un élément Input raster or constant value (Raster de classement ou valeur constante en entrée) multibande (input_raster_or_constant dans Python) est utilisée. Chaque bande du paramètre Input rasters or constant values (Rasters ou valeurs constantes en entrée) multibande (in_rasters_or_constants dans Python) est traitée séparément en tant que raster monobande.
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 bandes 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 raster à une seule bande, le nombre de bandes du raster en sortie est égal au nombre maximal de bandes de tous les rasters multibandes indiqués dans le paramètre Input rasters or constant values (Rasters ou valeurs constantes en entrée). Si le raster en entrée est un raster multibande, le raster en sortie possède le même nombre de bandes que le raster en entrée.

Si l’un des éléments indiqués dans Input rasters or constant values (Rasters ou valeurs constantes en entrée) est un raster comportant un nombre de bandes inférieur à celui du raster en sortie, les bandes manquantes sont interprétées comme des bandes renseignées avec des valeurs NoData. Si l’une des entrées de la liste est une constante, elle est interprétée en tant que raster multibande dans lequel les valeurs de cellule de toutes les bandes sont identiques à la constante et possédant le même nombre de bandes que le raster en sortie.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Raster ou valeur constante en entrée	Entrée qui définit la valeur à rechercher dans une liste de rasters, cellule par cellule. 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 des rasters en entrée qui serviront à évaluer la première entrée. Pour chaque localisation, si la valeur de cellule de la première entrée existe dans l’un des autres rasters, cette valeur est attribuée au raster en sortie. Si la valeur n’existe dans aucun des autres rasters, la valeur en sortie à cette localisation est 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 bandes des rasters multibandes en entrée seront traitées. Activé—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées. Décoché—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.	Boolean

Etiqueter

Explication

Type de données

Raster ou valeur constante en entrée

Entrée qui définit la valeur à rechercher dans une liste de rasters, cellule par cellule.

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 des rasters en entrée qui serviront à évaluer la première entrée. Pour chaque localisation, si la valeur de cellule de la première entrée existe dans l’un des autres rasters, cette valeur est attribuée au raster en sortie. Si la valeur n’existe dans aucun des autres rasters, la valeur en sortie à cette localisation est NoData.

Raster Layer; Constant

Process as multiband (Traiter comme multicanal)

(Facultatif)

Indique comment les bandes des rasters multibandes en entrée seront traitées.

Activé—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées.
Décoché—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.

Boolean

Valeur de retour

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

InList(in_raster_or_constant, in_raster_or_constants, {process_as_multiband})

Nom Explication Type de données

Nom	Explication	Type de données
in_raster_or_constant	Entrée qui définit la valeur à rechercher dans une liste de rasters, cellule par cellule. 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 des rasters en entrée qui serviront à évaluer la première entrée. Pour chaque localisation, si la valeur de cellule de la première entrée existe dans l’un des autres rasters, cette valeur est attribuée au raster en sortie. Si la valeur n’existe dans aucun des autres rasters, la valeur en sortie à cette localisation est 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 bandes des rasters multibandes en entrée seront traitées. `MULTI_BAND`—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées. `SINGLE_BAND`—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.	Boolean

in_raster_or_constant

Entrée qui définit la valeur à rechercher dans une liste de rasters, cellule par cellule.

Raster Layer; Constant

in_raster_or_constants [in_raster_or_constant,...]

Raster Layer; Constant

process_as_multiband

(Facultatif)

Indique comment les bandes des rasters multibandes en entrée seront traitées.

MULTI_BAND—Chaque entrée de raster multibande sera traitée comme un raster multibande. L’opération est réalisée sur chaque bande depuis une entrée en utilisant le numéro de bande correspondant des autres entrées.
SINGLE_BAND—Chaque bande d’une entrée de raster multibandes sera traitée séparément comme un raster monobande. Il s’agit de l’option par défaut.

Boolean

Valeur de retour

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

Exemple de code

InList Exemple 1 (fenêtre Python)

Cet exemple détermine quelles valeurs de cellules dans la première entrée 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")

InList Exemple 2 (script autonome)

Cet exemple détermine quelles valeurs de cellules dans la première entrée 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"

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

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

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

Liste en entrée (Outils Spatial Analyst)

Résumé

Illustration

Utilisation

Paramètres

Valeur de retour

Environnements

Informations de licence

Rubriques connexes