Máscara (configuración del entorno)

Las herramientas que distinguen el entorno de Máscara sólo considerarán aquellas celdas que corresponden a la máscara de análisis en la operación.

Ilustración

Las celdas de una entrada de máscara ráster que tienen un valor (las celdas en morado) identifican esas ubicaciones en la extensión de análisis que se incluirá en la operación. Las celdas blancas representan NoData.

Notas de uso

• La configuración de una máscara de análisis se traduce en que el procesamiento solo ocurrirá en las ubicaciones que corresponden a la máscara y a todas las ubicaciones ajenas a ella se les asignará NoData en la salida.

  Nota:

  El entorno de Máscara se aplica a las herramientas de las extensiones Spatial Analyst, Image Analyst y Geostatistical Analyst que generan un ráster. También se aplica a las herramientas en los conjuntos de herramientas Interpolación ráster, Matemática ráster, Reclasificación ráster y Superficie de ráster de la extensión 3D Analyst que tienen como salida un ráster.

• La máscara puede ser datos de entidad o ráster.
• Si la máscara de análisis es un ráster, se considerarán todas las celdas que tienen un valor para definir la máscara. Las celdas en un ráster de máscara que son NoData se considerarán fuera de la máscara y serán NoData en la salida.

  Las herramientas como Reclasificar y Evaluación condicional pueden ayudar a crear una máscara de análisis ráster.

• Si la máscara de análisis es una clase de entidad o una capa de entidades, se convertirá internamente en un ráster en el momento de la ejecución. Por este motivo, asegúrese de que los entornos de Tamaño de celda y Ráster de alineación estén adecuadamente definidos para el análisis.

Sintaxis de cuadro de diálogo

Máscara: un dataset que define qué ubicaciones en las entradas se considerarán en la ejecución de la herramienta. Si el dataset de máscara es un ráster, todas las celdas que contengan un valor compondrán la máscara. Las celdas que son NoData en una máscara de ráster serán NoData en la salida. Si se utiliza un dataset de entidades como entrada para la máscara, el dataset se convertirá internamente en un ráster en el momento de la ejecución.

Sintaxis de script

arcpy.env.mask = mask_source

Sintaxis de mask

Parámetro	Explicación
mask_source	El dataset que define la máscara. El dataset puede ser datos de entidad o ráster. Si es un dataset ráster, las celdas que tienen un valor constituirán la máscara, y toda celda que es NoData en la máscara será NoData en la salida.

Ejemplo de script

Este ejemplo demuestra cómo establecer el entorno de Máscara antes de ejecutar una herramienta de ArcGIS Spatial Analyst extension.

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")