Extraer por rectángulo (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Extrae las celdas de un ráster basado en un rectángulo especificando la extensión del rectángulo.

Ilustración

Ilustración de Extraer por rectángulo
OutRas = ExtractByRectangle(InRas1, Extent(1, 0, 5, 5), "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 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. A continuación, use 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 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.

  • El centro de la celda se utiliza para determinar si una celda se encuentra dentro o fuera de un rectángulo. Si el centro se encuentra dentro del contorno del rectángulo, la celda se considera completamente dentro, incluso si algunas porciones de la celda caen fuera del rectángulo.

  • A las ubicaciones de las celdas que no están seleccionadas se les asigna el valor NoData.

  • Si el ráster de entrada es un entero, el ráster de salida será un entero. Si la entrada es de punto flotante, la salida será de punto flotante.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a 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
Extensión

Un rectángulo que define el área que se extraerá.

Si el parámetro Extensión se ha ajustado en Como se especifica en la parte inferior, utilice los parámetros identificados con las flechas izquierda y hacia abajo para definir la coordenada inferior izquierda del área que se extraerá, y aquellos con las flechas derecha y hacia arriba para definir la coordenada superior derecha.

Si el parámetro Extensión se ha ajustado en Examinar, puede seleccionar un dataset cuya caja de límite definirá la extensión.

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada.

Extent
Área de extracción
(Opcional)

Identifica si debe extraer celdas dentro o fuera del rectángulo de entrada.

  • Dentro Una palabra clave que especifica que debe seleccionar las celdas dentro del rectángulo de entrada y escribirlas en el ráster de salida. Todas las celdas fuera del rectángulo recibirán valores NoData en el ráster de salida.
  • FueraUna palabra clave que especifica que debe seleccionar las celdas fuera del rectángulo de entrada y escribirlas en el ráster de salida. Todas las celdas dentro del rectángulo recibirán valores NoData en el ráster de salida.
String

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

ExtractByRectangle(in_raster, rectangle, {extraction_area})
NombreExplicaciónTipo de datos
in_raster

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

Raster Layer
rectangle
extent

Un rectángulo que define el área que se extraerá.

Un objeto de Extensión se usa para especificar las coordenadas.

El formato del objeto es:

  • Extent(XMin, YMin, XMax, YMax)

    donde XMin y YMin definen las coordenadas de la parte inferior izquierda del área que se extraerá y XMax y YMax definen las coordenadas de la parte superior derecha.

Las coordenadas se especifican en las mismas unidades de mapa que el ráster de entrada.

Extent
extraction_area
(Opcional)

Identifica si debe extraer celdas dentro o fuera del rectángulo de entrada.

  • INSIDE Una palabra clave que especifica que debe seleccionar las celdas dentro del rectángulo de entrada y escribirlas en el ráster de salida. Todas las celdas fuera del rectángulo recibirán valores NoData en el ráster de salida.
  • OUTSIDEUna palabra clave que especifica que debe seleccionar las celdas fuera del rectángulo de entrada y escribirlas en el ráster de salida. Todas las celdas dentro del rectángulo recibirán valores NoData en el ráster de salida.
String

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 ExtractByRectangle (ventana de Python)

En este ejemplo se extraen las celdas fuera de una extensión rectangular a un nuevo ráster.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
rectExtract = ExtractByRectangle("elevation", 
                                 Extent(477625, 213900, 486400, 224200), 
                                 "OUTSIDE")
rectExtract.save("c:/sapyexamples/output/extrect")
Ejemplo 2 de ExtractByRectangle (secuencia de comandos independiente)

En este ejemplo se extraen las celdas dentro de una extensión rectangular a un nuevo ráster.

# Name: ExtractByRectangle_Ex_02.py
# Description: 
# 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"
inRectangle = Extent(477625, 213900, 486400, 224200)

# Execute ExtractByRectangle
rectExtract = ExtractByRectangle(inRaster, inRectangle, "INSIDE")

# Save the output 
rectExtract.save("c:/sapyexamples/output/extrect02")

Información de licenciamiento

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

Temas relacionados