Extraer por máscara—Ayuda

Disponible con una licencia de Spatial Analyst.

Resumen
Ilustración
Uso
Sintaxis
Muestra de código
Entornos
Información sobre licencias

Resumen

Extrae las celdas de un ráster que corresponden a las áreas definidas por una máscara.

Ilustración

Uso

Cuando un ráster multibanda se especifica como entrada, se creará un ráster multibanda nuevo como salida. Cada banda individual del ráster multibanda de entrada se analizará como corresponda.
Cuando especifica un ráster multibanda para la máscara de ráster de entrada, sólo la primera banda se utilizará en la operación.
Si se ha especificado Máscara en la configuración del entorno al ejecutar la herramienta Extraer por máscara, el ráster de salida tendrá valores de celdas solo para el área que reside en la intersección de los datos de la máscara de entorno y la máscara de entrada.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Sintaxis

ExtractByMask (in_raster, in_mask_data)

Parámetro	Explicación	Tipo de datos
in_raster	El ráster de entrada desde el cual se extraerán las celdas.	Raster Layer
in_mask_data	Datos de máscara de entrada que definen áreas que se extraerán. Puede ser un ráster o un dataset de entidades. Cuando los datos de máscara de entrada son un ráster, a las celdas NoData de la máscara se le asignarán valores NoData en el ráster de salida. Si la máscara de entrada son datos de entidad, las celdas del ráster de entrada cuyo centro quede dentro del perímetro de la entidad se incluirán en la salida, mientras que las celdas cuyo centro quede fuera, recibirán NoData.	Raster Layer; Feature Layer

Parámetro

Explicación

Tipo de datos

in_raster

El ráster de entrada desde el cual se extraerán las celdas.

Raster Layer

in_mask_data

Datos de máscara de entrada que definen áreas que se extraerán.

Puede ser un ráster o un dataset de entidades.

Cuando los datos de máscara de entrada son un ráster, a las celdas NoData de la máscara se le asignarán valores NoData en el ráster de salida.

Si la máscara de entrada son datos de entidad, las celdas del ráster de entrada cuyo centro quede dentro del perímetro de la entidad se incluirán en la salida, mientras que las celdas cuyo centro quede fuera, recibirán NoData.

Raster Layer; Feature Layer

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	Ráster de salida que contiene los valores de las celdas extraídos del ráster de entrada.	Raster

Muestra de código

Ejemplo 1 de ExtractByMask (ventana de Python)

En este ejemplo se extraen las celdas de un ráster dentro de una marca definida por una clase de entidad de shapefile de polígonos de entrada.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outExtractByMask = ExtractByMask("elevation", "mask.shp")
outExtractByMask.save("C:/sapyexamples/output/maskextract")

Ejemplo 2 de ExtractByMask (secuencia de comandos independiente)

En este ejemplo se extraen las celdas de un ráster dentro de una marca definida por una clase de entidad de shapefile de polígonos de entrada.

# Name: ExtractByMask_Ex_02.py
# Description: Extracts the cells of a raster that correspond with the areas
#    defined by a mask.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
inMaskData = "mask.shp"

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

# Execute ExtractByMask
outExtractByMask = ExtractByMask(inRaster, inMaskData)

# Save the output 
outExtractByMask.save("C:/sapyexamples/output/extractmask")

ArcMap

Extraer por máscara