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é.

Un raster de capture est généralement utilisé lorsque les entrées effectuées dans les outils :

  • Présentent des alignements de cellules différents ;
  • Présentent des résolutions de cellules différentes ;
  • Présentent des systèmes de coordonnées différents ;
  • 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 pendant l'exécution.
  • 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

ParamètreExplication

raster

Raster à utiliser comme raster de capture.

Syntaxe snapRaster

Exemple de script

Cet exemple illustre la définition de l’environnement de raster de capture avant l’exécution d’un outil de Extension ArcGIS Spatial Analyst.

import arcpy
# Set workspace and extent environments
arcpy.env.workspace = "C:/workspace"
arcpy.env.extent = "C:/data/studyArea"
# Set Snap Raster environment
arcpy.env.snapRaster = "C:/data/my_snapraster"
# Set local variables
InZones = "C:/data/parcels.shp"
InZoneField = "Parcel_ID"
InValueRaster = "C:/data/Slope"
# 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")

Rubriques connexes