Extraer por máscara (Spatial Analyst)

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

Ilustración de la herramienta Extraer por máscara
OutRas = ExtractByMask(InRas1, InMsk1, "INSIDE")

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 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 valor de 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 formado por esas bandas concretas con la herramienta Bandas compuestas. A continuación, use el resultado como el valor de Ráster de entrada (in_raster en Python).

    El formato de salida predeterminado es un ráster de geodatabase. Si se especifica una pila de Cuadrícula de Esri como formato de salida, el nombre de la pila no puede comenzar por un número, usar espacios ni 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 valor de 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 valor de Ráster de entrada 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 valor de 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 (ráster de alineación) 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.

  • Puede utilizar el parámetro Extensión de análisis (analysis_extent en Python) para especificar el área de análisis de salida explícitamente para una operación de herramienta independiente o para invalidar la configuración del entorno como parte de un flujo de trabajo. Para especificar la extensión, puede escribir los valores correspondientes, elegir la extensión de visualización, seleccionar una capa o buscar un dataset de entrada.

  • El valor de Extensión de análisis predeterminado se calcula a partir de la intersección del valor de Ráster de entrada y el valor Datos de máscara de entidad o ráster de entrada.

  • Si la extensión de análisis no se especifica explícitamente como el valor de parámetro, se derivará de la configuración del entorno de análisis.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada

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

Raster Layer
Datos de máscara de entidad o ráster de entrada

Máscara de datos de entrada que define las ubicaciones de celda que se van a extraer.

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
Área de extracción
(Opcional)

Especifica si las celdas dentro o fuera de las ubicaciones definidas por la máscara de entrada serán seleccionadas y escritas en el ráster de salida.

  • DentroLas celdas dentro de la máscara de entrada se seleccionarán y se escribirán en el ráster de salida. Todas las celdas fuera de la máscara recibirán NoData en el ráster de salida. Ésta es la opción predeterminada.
  • FueraLas celdas fuera de la máscara de entrada se seleccionarán y se escribirán en el ráster de salida. Todas las celdas cubiertas por la máscara recibirán NoData.
String
Extensión de análisis
(Opcional)

Extensión que define el área que se extraerá.

De forma predeterminada, la extensión se calcula como la intersección del valor de Ráster de entrada y el valor de Datos de máscara de entidad o ráster de entrada. El procesamiento se producirá hasta los límites x e y, y las celdas afuera de esa extensión serán NoData.

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada si el entorno de análisis no las establece explícitamente.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

Ráster de salida que contiene los valores de las celdas extraídos del ráster de entrada.

Raster

ExtractByMask(in_raster, in_mask_data, {extraction_area}, {analysis_extent})
NombreExplicaciónTipo de datos
in_raster

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

Raster Layer
in_mask_data

Máscara de datos de entrada que define las ubicaciones de celda que se van a extraer.

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
extraction_area
(Opcional)

Especifica si las celdas dentro o fuera de las ubicaciones definidas por la máscara de entrada serán seleccionadas y escritas en el ráster de salida.

  • INSIDELas celdas dentro de la máscara de entrada se seleccionarán y se escribirán en el ráster de salida. Todas las celdas fuera de la máscara recibirán NoData en el ráster de salida. Ésta es la opción predeterminada.
  • OUTSIDELas celdas fuera de la máscara de entrada se seleccionarán y se escribirán en el ráster de salida. Todas las celdas cubiertas por la máscara recibirán NoData.
String
analysis_extent
(Opcional)

Extensión que define el área que se extraerá.

Si no se especifica, la extensión predeterminada es la intersección del valor in_raster y el valor in_mask_data.

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada si el entorno de análisis no las establece explícitamente.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent

Valor de retorno

NombreExplicaciónTipo 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", "INSIDE")
outExtractByMask.save("C:/sapyexamples/output/maskextract")
Ejemplo 2 de ExtractByMask (secuencia de comandos independiente)

Este ejemplo extrae celdas de un ráster para todas las áreas fuera de una máscara definida por una clase de entidad de shapefile de polígono de entrada, manteniendo la extensión de salida del ráster de entrada.

# Name: ExtractByMask_Ex_02.py
# Description: Extracts the cells of a elevation raster for all areas outside of the mask features.
#     Keeping the output extent of the input elevation raster. 
# 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"
extraction_area = "OUTSIDE"
analysis_extent = "elevation"


# Execute ExtractByMask
outExtractByMask = ExtractByMask(inRaster, inMaskData, extraction_area, analysis_extent)

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

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados