Recortar ráster (Administración de datos)

Resumen

Recorta una parte de un dataset ráster, un dataset de mosaico o una capa de servicio de imágenes.

Ilustración

Ilustración de Recortar

Uso

  • Esta herramienta permite extraer una porción de un dataset ráster en función de una extensión de plantilla. La salida de recorte incluye todos los píxeles que intersecan la extensión de plantilla. Para extraer una porción de un dataset de entidades, use la herramienta Recortar de la caja de herramientas Análisis.

  • El área recortada se especifica ya sea con un contorno rectangular con las coordenadas mínimas y máximas x e y, o con un archivo de extensión de salida. Si la extensión de recorte especificada no está alineada con el dataset ráster de entrada, esta herramienta comprueba que se utilice la alineación adecuada. Esto puede provocar que la salida tenga una extensión ligeramente distinta a la especificada en la herramienta.

  • Se puede utilizar un ráster o una capa vectorial existente como la extensión de corte. Si está utilizando una clase de entidad como la extensión de salida, tiene la opción de recortar el ráster por el rectángulo mínimo de delimitación de la clase de entidad o por la geometría de polígono de las entidades. Si se utiliza la geometría de recorte, es probable que se promueva la profundidad de píxel de la salida. Por lo tanto, asegúrese de que el formato de la salida admita la profundidad de píxel adecuada.

  • También puede usar las entidades seleccionadas dentro de la visualización como extensión de recorte. Si se selecciona una entidad dentro de la clase de entidad y está activada la opción Utilizar entidades de entrada para recortar geometría (clipping_geometry está establecida en ClippingGeometry en Python), la salida recorta las áreas seleccionadas. Si se selecciona una entidad dentro de la clase de entidad, pero no se activa la opción Utilizar entidades de entrada para recortar geometría (establecida en NONE en Python), la salida recorta el rectángulo mínimo de delimitación de esa entidad.

  • Puede guardar la salida en los formatos BIL, BIP, BMP, BSQ, DAT, Cuadrícula de Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF, CRF o en cualquier dataset ráster de geodatabase.

  • Los valores de extensión deben estar en las mismas unidades y coordenadas espaciales que el dataset ráster.

  • Esta herramienta admite datos ráster multidimensionales. Para ejecutar la herramienta en cada porción del ráster multidimensional y generar una salida de ráster multidimensional, asegúrese de guardar la salida en CRF.

    Entre los tipos de dataset multidimensional de entrada admitidos se incluyen: capa ráster multidimensional, dataset de mosaico, servicio de imágenes y CRF.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de Entrada

El dataset ráster, dataset de mosaico o servicio de imágenes que se desea recortar.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
Rectángulo

Las cuatro coordenadas que definen la extensión del cuadro de delimitación utilizado para recortar el ráster.

Si la extensión de recorte especificada no está alineada con el dataset ráster de entrada, la herramienta de recorte comprueba que se utilice la alineación adecuada. Esto puede provocar que la salida tenga una extensión ligeramente distinta a la especificada en la herramienta.

Use el botón Borrar para restablecer la extensión del rectángulo en la extensión del dataset ráster de entrada.

Envelope; Feature Class; Feature Layer
Dataset ráster de salida

El nombre, la ubicación y el formato del dataset creado. Asegúrese de que puede admitir la profundidad de bit necesaria.

Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:

  • .bil: Esri BIL
  • .bip: Esri BIP
  • .bmp: BMP
  • .bsq: Esri BSQ
  • .dat: ENVI DAT
  • .gif: GIF
  • .img: ERDAS IMAGINE
  • .jpg: JPEG
  • .jp2: JPEG 2000
  • .png: PNG
  • .tif: TIFF
  • .mrf: MRF
  • .crf: CRF
  • Ninguna extensión para Cuadrícula de Esri

Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster.

Cuando almacene el dataset ráster en un archivo JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, puede especificar un Tipo de compresión y la Calidad de compresión en los Entornos.

Raster Dataset
Extensión de salida
(Opcional)

Dataset ráster o clase de entidad que se va a utilizar como extensión. La salida de recorte incluye todos los píxeles que intersecan el rectángulo mínimo de delimitación.

Si utiliza una clase de entidad como la extensión de salida y desea recortar el ráster en función de las entidades poligonales, active el parámetro Usar entidad de entrada para recortar geometría. Si este parámetro está activado, es probable que se promueva la profundidad de píxel de la salida. Por lo tanto, asegúrese de que el formato de la salida admita la profundidad de píxel adecuada.

Raster Layer; Feature Layer
Valor NoData
(Opcional)

El valor de los píxeles que se va a considerar como NoData.

String
Utilizar entidades de entrada para recortar geometría
(Opcional)

Especifique si los datos se recortarán según el rectángulo mínimo de delimitación o según la geometría de la clase de entidad.

  • Desactivado: se utiliza el rectángulo mínimo de delimitación para recortar los datos.
  • Activado: se utiliza la geometría de la clase de entidad seleccionada para recortar los datos. Puede que aumente la profundidad de píxel de la salida; por lo tanto, asegúrese de que el formato de la salida admita la profundidad de píxel adecuada.

Boolean
Mantener extensión de recorte
(Opcional)

Especifica la extensión que se va a utilizar para recortar la salida.

  • Activado: se ajusta el número de columnas y filas, y los píxeles se remuestrean para que coincidan exactamente con la extensión de recorte especificada.
  • Desactivado: la alineación de las celdas del ráster de entrada se mantiene, y la extensión de salida se ajusta correspondientemente.

Boolean

arcpy.management.Clip(in_raster, rectangle, out_raster, {in_template_dataset}, {nodata_value}, {clipping_geometry}, {maintain_clipping_extent})
NombreExplicaciónTipo de datos
in_raster

El dataset ráster, dataset de mosaico o servicio de imágenes que se desea recortar.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
rectangle

Las cuatro coordenadas que definen la extensión del cuadro de delimitación utilizado para recortar el ráster, en este orden: X mínima, Y mínima, X máxima e Y máxima.

Si la extensión de recorte especificada no está alineada con el dataset ráster de entrada, la herramienta Recortar comprueba que se utilice la alineación adecuada. Esto puede provocar que la salida tenga una extensión ligeramente distinta a la especificada en la herramienta.

Envelope; Feature Class; Feature Layer
out_raster

El nombre, la ubicación y el formato del dataset creado. Asegúrese de que puede admitir la profundidad de bit necesaria.

Al almacenar el dataset ráster en un formato de archivo, deberá especificar la extensión del archivo:

  • .bil: Esri BIL
  • .bip: Esri BIP
  • .bmp: BMP
  • .bsq: Esri BSQ
  • .dat: ENVI DAT
  • .gif: GIF
  • .img: ERDAS IMAGINE
  • .jpg: JPEG
  • .jp2: JPEG 2000
  • .png: PNG
  • .tif: TIFF
  • .mrf: MRF
  • .crf: CRF
  • Ninguna extensión para Cuadrícula de Esri

Cuando almacene un dataset ráster en una geodatabase, no agregue ninguna extensión de archivo al nombre del dataset ráster.

Cuando almacene el dataset ráster en un archivo JPEG, un archivo JPEG 2000, un archivo TIFF o una geodatabase, puede especificar un Tipo de compresión y la Calidad de compresión en los Entornos.

Raster Dataset
in_template_dataset
(Opcional)

Dataset ráster o clase de entidad que se va a utilizar como extensión. La salida de recorte incluye todos los píxeles que intersecan el rectángulo mínimo de delimitación.

Si utiliza una clase de entidad como la extensión de salida y desea recortar el ráster en función de las entidades poligonales, establezca el parámetro clipping_geometry en ClippingGeometry. Es posible que esta opción promueva la profundidad de píxel de la salida. Por lo tanto, asegúrese de que el formato de la salida admita la profundidad de píxel adecuada.

Raster Layer; Feature Layer
nodata_value
(Opcional)

El valor de los píxeles que se va a considerar como NoData.

String
clipping_geometry
(Opcional)

Especifique si los datos se recortarán según el rectángulo mínimo de delimitación o según la geometría de la clase de entidad.

  • NONESe utilizará el rectángulo mínimo de delimitación para recortar los datos. Esta es la opción predeterminada.
  • ClippingGeometrySe usará la geometría de la clase de entidad especificada para recortar los datos. Puede que aumente la profundidad de píxel de la salida; por lo tanto, asegúrese de que el formato de la salida admita la profundidad de píxel adecuada.
Boolean
maintain_clipping_extent
(Opcional)

Especifica la extensión que se va a utilizar para recortar la salida.

  • MAINTAIN_EXTENTSe ajusta el número de columnas y filas, y los píxeles se remuestrean para que coincidan exactamente con la extensión de recorte especificada.
  • NO_MAINTAIN_EXTENTLa alineación de las celdas del ráster de entrada se mantiene, y la extensión de salida se ajusta correspondientemente.
Boolean

Muestra de código

Ejemplo 1 de Clip (ventana de Python)

Esta es una muestra de Python para la herramienta Clip.

import arcpy
arcpy.Clip_management(
    "c:/data/image.tif","1952602 294196 1953546 296176",
    "c:/data/clip.gdb/clip01", "#", "#", "NONE", "NO_MAINTAIN_EXTENT")
Ejemplo 2 de Recortar (script independiente)

Esta es una muestra del script de Python para la herramienta Clip.

##Clip Raster Dataset by known extent - Left Bottom Right Top

import arcpy
arcpy.env.workspace = "C:/Workspace"
    

arcpy.Clip_management(
    "image.tif","1952602.23 294196.279 1953546.23 296176.279",
    "clip.gdb/clip", "#", "#", "NONE")
Ejemplo 3 de Clip (script independiente)

Esta es una muestra del script de Python para la herramienta Clip mediante clipping_geometry.

##Clip while maintaining original extent



import arcpy

arcpy.env.workspace = "C:/Workspace"



arcpy.Clip_management("c:\\test\\image.tif", "2536996.21761925 7365614.23930381 2537634.12209192 7366302.3861673", 
                      "c:\\output\\clip.tif", "c:\\test\\clipfeature.shp", "0", "ClippingGeometry", 
                      "MAINTAIN_EXTENT")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados