Disponible con una licencia de Spatial Analyst.
Resumen
Extrae las celdas de un ráster que corresponden a las áreas definidas por una máscara.
Ilustración
Uso
En caso de que el ráster de entrada contuviera atributos adicionales, estos se trasladarán tal cual a la tabla de atributos del ráster de salida. En función de la naturaleza de la propiedad que se va a registrar, es posible que haya que recalcular los valores de algunos atributos.
Cuando se especifica un ráster multibanda como el Ráster de entrada (in_raster en Python), se utilizarán todas las bandas.
Para procesar una selección de bandas a partir de un ráster multibanda, cree primero un dataset ráster nuevo formado por esas bandas concretas con la herramienta Bandas compuestas y utilice el resultado como el Ráster de entrada (in_raster en Python).
El formato de salida predeterminado es un ráster de geodatabase. Si se especifica una pila en Cuadrícula de Esri como formato de salida, tenga en cuenta que el nombre no puede empezar con un número, utilizar espacios o tener más de nueve caracteres de longitud.
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 el Ráster de entrada (in_raster en Python) y los datos de un ráster Datos de máscara de entidad o ráster de entrada (in_mask_data en Python) tienen el mismo tamaño de celda, y las celdas están alineadas, se utilizarán directamente en la herramienta. No se remuestrearán internamente durante la ejecución de la herramienta.
Si el tamaño de celda es diferente, el tamaño de celda de salida será el máximo de las entradas y el Ráster de entrada (in_raster en Python) se utilizará internamente como el ráster de alineación. Si el tamaño de celda es el mismo, pero las celdas no están alineadas, el Ráster de entrada se utilizará internamente como el ráster de alineación. En ambos casos, se desencadenará un remuestreo interno antes de realizar la operación de extracción.
Encontrará más información en los temas del entorno Tamaño de celda y Ráster de alineación.
Si la entrada de máscara es una entidad, se convertirá internamente a un ráster utilizando el tamaño de celda y la alineación de celda del Ráster de entrada.
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 que se aplican a 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 |
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")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst