Raster de capture (paramètre d'environnement)

Les outils dédiés à l'environnement Raster de capture ajustent l'étendue des rasters en sortie, de telle sorte qu'ils correspondent à l'alignement des cellules du raster de capture spécifié.

En général, un raster de capture est utilisé lorsque les entrées de l’outil répondent à l’un des critères suivants :

• Ont différents alignements de cellule.
• Ont différentes résolutions de cellule.
• Ont différents systèmes de coordonnées.
• Sont des entités.

Pour en savoir plus sur le fonctionnement du raster de capture

Remarques sur l’utilisation

• La spécification du raster de capture n’affecte pas immédiatement les valeurs du contrôle d’étendue en sortie ; l’étendue est toutefois ajustée lorsqu’elle est exécutée.
• Le coin inférieur gauche de l'étendue est capturé sur le coin d'une cellule du raster de capture, puis le coin supérieur droit est ajusté à l'aide de la taille de cellule en sortie. En conséquence, lorsque la taille de cellule en sortie est identique à celle du raster de capture, les cellules du raster en sortie sont alignées sur les cellules du raster de capture.
• En général, le raster de capture est appliqué aux outils qui génèrent un raster en sortie. L'étendue n'est pas capturée lorsque la sortie est une classe d'entités, une table ou un fichier.
• Un raster de capture peut être utilisé avec l'étendue en sortie par défaut. Il n'est pas nécessaire de spécifier explicitement une étendue dans l'environnement pour utiliser un raster de capture.
• Il est recommandé d'utiliser une taille de cellule identique pour le raster de capture et le raster en sortie. Vous pouvez toutefois spécifier deux tailles de cellule différentes. Dans ce cas, seules les limites inférieure et gauche s’alignent sur les cellules du raster de capture et il se peut que le coin supérieur droit de l’étendue en sortie ne coïncide pas avec un coin de cellule du raster de capture.
• Puisque l’étendue peut être capturée sur une étendue plus importante, le raster en sortie peut contenir une ligne et une colonne supplémentaire de cellules NoData.
• La taille (c'est-à-dire le nombre de lignes ou de colonnes) d'un raster de capture est sans importance. Seules son origine et sa taille de cellule sont utilisées pour ajuster l’étendue en sortie.
• L’étendue du raster de capture ne doit pas nécessairement recouvrir l’étendue en sortie. Un raster de taille réduite situé en dehors de votre zone d’analyse peut être utilisé pour la capture.
• L’environnement Raster de capture est indépendant de l’environnement Etendue.

Syntaxe de la boîte de dialogue

Snap Raster (Raster de capture) : spécifie un raster pour définir l’alignement des cellules d’un raster en sortie.

Syntaxe de script

arcpy.env.snapRaster = raster

Syntaxe snapRaster

Paramètre	Explication
raster	Raster à utiliser comme raster de capture.

Exemple de script

Cet exemple montre comment définir l’environnement Raster de capture avant d’exécuter un outil Extension ArcGIS Spatial Analyst.

import arcpy

# Set workspace and extent environments
arcpy.env.workspace = "C:/workspace"
arcpy.env.extent = "C:/data/StudyArea.tif"

# Set Snap Raster environment
arcpy.env.snapRaster = "C:/data/my_snapraster.tif"

# Set local variables
InZones = "C:/data/parcels.shp"
InZoneField = "Parcel_ID"
InValueRaster = "C:/data/slope_ras.tif"

# Check out ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Process: Calculate the mean slope of each parcel area.
out = arcpy.sa.ZonalStatistics(InZones, InZoneField, InValueRaster, "MEAN", 
                               "DATA")
out.save("mean_ParSlp.tif")