Masque (paramètre d’environnement)

Les outils dédiés à l'environnement Masque ne prennent en compte que les cellules qui se trouvent dans le masque d'analyse de l'opération.

Illustration

Le masque identifie les emplacements dans l’étendue de l’analyse qui seront inclus dans l’opération.
Les cellules dans une entrée de masque de raster qui ont une valeur (cellules en violet) identifient ces emplacements dans l’étendue d’analyse qui seront inclus dans l’opération. Les cellules en blanc représentent la valeur NoData.

Remarques sur l’utilisation

  • La définition d’un masque d’analyse signifie que le traitement ne se produit que sur les emplacements situés dans le masque et que tous les emplacements situés en dehors auront une valeur NoData dans la sortie.
    Remarque :

    L’environnement Masque s’applique aux outils des extensions Spatial Analyst, Image Analyst et Geostatistical Analyst qui génèrent un raster. Il s’applique également aux outils des jeux d’outils Raster - Interpolation, Raster - Mathématiques, Raster - Reclassement et Raster - Surface de l’extension 3D Analyst qui génèrent un raster.

  • Le masque peut représenter un raster ou des données d’entités.
  • Si le masque d'analyse est un raster, toutes les cellules ayant une valeur sont prises en compte pour définir le masque. Les cellules NoData d'un raster de masque sont considérées comme se trouvant à l'extérieur du masque et auront donc une valeur NoData dans la sortie.

    Des outils tels que Reclassification et Con peuvent aider à créer un masque d'analyse de raster.

  • Si le masque d’analyse est une classe d’entités ou une couche d’entités, il est converti en interne en un raster lors de l’exécution de l’outil. Vous devez donc vérifier que les environnements Taille de cellule et Raster de capture sont correctement paramétrés pour votre analyse.

Syntaxe de la boîte de dialogue

Masque : jeu de données qui définit les emplacements en entrée qui seront pris en compte lors de l’exécution de l’outil. Si le jeu de données du masque est un raster, toutes les cellules ayant une valeur comprennent le masque. Les cellules NoData d'un raster de masque auront une valeur NoData dans la sortie. Si un jeu de classes d’entités est utilisé en entrée pour le masque, il est converti en interne en raster lors de l’exécution de l’outil.

Syntaxe de script

arcpy.env.mask = mask_source

ParamètreExplication

mask_source

Jeu de données qui définit le masque.

Le jeu de données peut être un raster ou des données d’entité. S’il s’agit d’un jeu de données de type raster, les cellules qui ont une valeur constituent le masque et toute cellule qui affiche une valeur NoData dans le masque affiche une valeur NoData en sortie.

Syntaxe mask

Exemple de script

Cet exemple montre comment paramétrer l’environnement Masque avant d’exécuter un outil Extension ArcGIS Spatial Analyst.

import arcpy

# Set environment
arcpy.env.workspace = "C:/workspace"
arcpy.env.extent = "C:/data/StudyArea.tif"
arcpy.env.snapRaster = "C:/data/slope_ras.tif"

# Set Mask environment
arcpy.env.mask = "C:/data/maskpoly.shp"

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

# Check out a Spatial Analyst 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")