Combinaison (ArcGIS 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

Illustration de la fonction Combine (Combiner)
OutRas = Combine([InRas1, InRas2])

Utilisation

  • L'outil Combinaison permet de traiter des entiers et les tables attributaires correspondantes. Si les valeurs en entrée sont à virgule flottante, elles sont automatiquement tronquées. Le système les teste pour savoir si elles sont distinctes par rapport à d'autres entrées. Ensuite, ces valeurs sont transmises à la table attributaire en sortie.

  • 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 entrée de raster est représentée par un champ dans la table attributaire de raster (RAT) en sortie dans laquelle l’ordre des champs dans la sortie correspond à l’ordre des rasters en entrée.

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

    Si le même raster est utilisé plusieurs fois, il sera considéré comme une entrée individuelle. Toutefois, un avertissement sera renvoyé.

  • Le nom de champ dans la RAT en sortie est fonction du nom de jeu de données raster. Si le nom du champ est trop long, il sera tronqué pour respecter la limite de longueur de nom de champ. Tous les caractères spéciaux du nom du raster qui ne sont pas pris en charge par la base de données seront remplacés par un trait de soulignement.

    Dans le cas des entrées multibandes, le nom de champ est composé de deux parties séparées par un trait de soulignement. La première partie est déduite du nom du raster suivi de l’index de la bande, à partir de 1.

    Dans le cas des noms de champs dupliqués, chaque 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

ÉtiquetteExplicationType de données
Rasters en entrée

Liste des rasters en entrée à combiner.

Raster Layer

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster combiné en sortie.

La valeur d'un entier est attribuée à chaque combinaison distincte de valeurs en entrée.

Raster

Combine(in_rasters)
NomExplicationType de données
in_rasters
[in_raster,...]

Liste des rasters en entrée à combiner.

Raster Layer

Valeur renvoyée

NomExplicationType de données
out_raster

Raster combiné en sortie.

La valeur d'un entier est attribuée à chaque combinaison distincte de valeurs en entrée.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil Combinaison (fenêtre Python)

Cet exemple prend plusieurs rasters en entrée de différents formats (Grid, IMG et TIFF) et génère une combinaison unique de valeurs 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")
Deuxième exemple d'utilisation de l'outil Combinaison (script autonome)

Cet exemple prend plusieurs rasters en entrée de différents formats (Grid, IMG et TIFF) et génère une combinaison unique de valeurs 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")