Combinaison (ArcGIS Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Combine plusieurs rasters de manière à attribuer une valeur unique en sortie à chaque combinaison distincte de valeurs en entrée.

Illustration

OutRas = Combine([InRas1, InRas2])

Utilisation

• L’outil Combinaison s’applique aux valeurs entières et aux tables attributaires correspondantes. Si les valeurs en entrée sont à virgule flottante, elles sont automatiquement tronquées. Le système les teste pour déterminer si elles sont uniques par rapport aux autres entrées. Ensuite, ces valeurs sont transmises à la table attributaire en sortie.

• L’outil Combinaison s’apparente à l’outil Ou combinatoire. Ces deux outils permettent d’attribuer un nombre différent à chaque combinaison unique de valeurs en entrée. Dans l’outil Combinaison, vous spécifiez une liste de rasters tandis que dans l’outil Ou combinatoire, vous ne spécifiez que deux entrées qui peuvent être des rasters ou des valeurs constantes.

• Lorsqu’un raster multicanal est spécifié comme l’une des valeurs du paramètre Input rasters (Rasters en entrée) (in_rasters dans Python), tous les canaux sont utilisés.

  Pour traiter une sélection de canaux d’un raster multicanal, créez d’abord un jeu de données raster composé de ces canaux spécifiques à l’aide de l’outil Composite Bands (Canaux composites), puis utilisez le résultat de la liste dans le paramètre Input rasters (Rasters en entrée) (in_rasters dans Python)

• Le raster en sortie est toujours un entier.

• Chaque raster en entrée est représenté par un champ dans la table attributaire raster (RAT) en sortie, dans laquelle l’ordre des champs de la sortie correspond à l’ordre des rasters en entrée.

  En présence d’entrées multibandes, la sortie identifie chaque bande comme un raster individuel et le nombre correspondant de champs est créé.

  Si le même raster est utilisé à plusieurs reprises, il est considéré comme étant constitué d’entrées individuelles. Un avertissement est toutefois renvoyé.

• Le nom de champ dans la table attributaire raster en sortie repose sur le nom du jeu de données raster. Si le nom de champ est trop long, il est tronqué pour respecter la limitation de longueur du nom de champ. Tout caractère spécial dans le nom du raster qui n’est pas pris en charge par la base de données sera remplacé par un trait de soulignement.

  Dans le cas des entrées multibandes, le nom du champ se compose de deux parties, séparées par un trait de soulignement. La première partie est tirée du nom du raster. Elle est suivie par l’index de la bande, en commençant par 1.

  Dans le cas des noms de champ dupliqués, chaque nom de champ subséquent devient unique en modifiant le nom du raster avec un index commençant à 1.

• 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
Rasters en entrée	Liste des rasters en entrée à combiner.	Raster Layer

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster combiné en sortie. Une valeur entière unique est attribuée à chaque combinaison distincte de valeurs en entrée.	Raster

Python

Combine(in_rasters)

Nom	Explication	Type de données
in_rasters [in_raster,...]	Liste des rasters en entrée à combiner.	Raster Layer

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster combiné en sortie. Une valeur entière unique est attribuée à chaque combinaison distincte de valeurs en entrée.	Raster

Exemple de code

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

Cet exemple accepte plusieurs rasters en entrée dans des formats différents (Grid, IMG et TIFF) et indique les valeurs que vous obtenez pour chaque combinaison sous la forme d'un raster Grid.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCombine = Combine(["filter", "zone", "source.img", "dec.tif"])
outCombine.save("C:/sapyexamples/output/outcombine2")

Exemple 2 d’utilisation de la fonction Combinaison (script autonome)

Cet exemple accepte plusieurs rasters en entrée dans des formats différents (Grid, IMG et TIFF) et indique les valeurs que vous obtenez pour chaque combinaison sous la forme d'un raster Grid.

# Name: Combine_Ex_02.py
# Description: Combines multiple rasters such that a unique value is
#              assigned to each unique combination of input values
# 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
inRaster01 = "filter"
inRaster02 = "zone"
inRaster03 = "source.img"
inRaster04 = "dec.tif"

# Execute Combine
outCombine = Combine([inRaster01,inRaster02,inRaster03,inRaster04])

# Save the output 
outCombine.save("C:/sapyexamples/output/outcombine")

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