Etiqueta | Explicación | Tipo 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, especifique la extensión del archivo de la siguiente manera:
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 con formato JPEG, un archivo con formato JPEG 2000, un archivo con formato TIFF o una geodatabase, puede especificar valores para Tipo de compresión y Calidad de compresión en los entornos de geoprocesamiento. | 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.
| Boolean |
Mantener extensión de recorte
(Opcional) | Especifica la extensión que se va a utilizar para recortar la salida.
| Boolean |
Resumen
Recorta una parte de un dataset ráster, un dataset de mosaico o una capa de servicio de imágenes.
Ilustración
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 formato BIL, BIP, BMP, BSQ, DAT, Cuadrícula de Esri, GIF, IMG, JPEG, JPEG 2000, PNG, TIFF, MRF o 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
arcpy.management.Clip(in_raster, rectangle, out_raster, {in_template_dataset}, {nodata_value}, {clipping_geometry}, {maintain_clipping_extent})
Nombre | Explicación | Tipo 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, especifique la extensión del archivo de la siguiente manera:
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 con formato JPEG, un archivo con formato JPEG 2000, un archivo con formato TIFF o una geodatabase, puede especificar valores para Tipo de compresión y Calidad de compresión en los entornos de geoprocesamiento. | 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.
| Boolean |
maintain_clipping_extent (Opcional) | Especifica la extensión que se va a utilizar para recortar la salida.
| Boolean |
Muestra de código
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")
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")
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")
Entornos
Casos especiales
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí