Skip to main content

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

En savoir plus sur le fonctionnement de l’environnement Snap Raster (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.

  • L’angle inférieur gauche de l’étendue est capturé sur l’angle d’une cellule du raster de capture, puis l’angle supérieur droit est ajusté en fonction 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 Snap Raster (Raster de capture) est indépendant de l’environnement Extent (Étendue).

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 Python

arcpy.env.snapRaster = raster

Nom Explication

raster

Raster à utiliser comme raster de capture.

Syntaxe de script

Cet exemple montre comment définir l’environnement Snap Raster (Raster de capture) avant d’exécuter un outil d’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"

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