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 que se utilizará para recortar el ráster. Si se ha definido el parámetro Extensión de salida, automáticamente rellenará los valores x mín, y mín, x máx e y máx. Use el botón Restablecer para restablecer la extensión del rectángulo en la extensión del dataset ráster de entrada. Si el valor especificado no está alineado con el dataset ráster de entrada, la herramienta comprueba que se utilice la alineación adecuada. Esto puede provocar que la salida tenga una extensión ligeramente distinta a la especificada. | 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 utilizarán como extensión. La salida de recorte incluye 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. 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) | Especifica si se utilizará el rectángulo mínimo de delimitación o la geometría de la clase de entidad especificada para recortar los datos.
| Boolean |
Mantener extensión de recorte (Opcional) | Especifica la extensión que se utilizará en la salida de recorte.
| 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, puede 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. 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á activado el parámetro Utilizar entidades de entrada para recortar geometría, la salida recorta las áreas seleccionadas. Si se selecciona una entidad dentro de la clase de entidad, pero está activado el parámetro Utilizar entidades de entrada para recortar geometría, la salida recorta el rectángulo mínimo de delimitación de esa entidad.
Puede dibujar interactivamente un polígono en el ráster del mapa para utilizarlo como la extensión de recorte. Haga clic en la lista desplegable Crear entidades nuevas en el mapa actual para su uso como entrada y, a continuación, haga clic en Polígono. A continuación, mueva el puntero al mapa para digitalizar un polígono. Haga doble clic para completar el polígono de recorte.
Nota:
La única opción disponible para recortar una capa ráster es Polígono.
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 que se utilizará para recortar el ráster. Las coordenadas se expresan como x-min, y-min, x-max, y-max. Si se ha definido el parámetro in_template_dataset, se establecerá automáticamente este parámetro. Si el parámetro in_template_dataset es una capa de entidades, la extensión de recorte se extrae del cuadro de delimitación. En este caso, el parámetro rectangle se puede dejar vacío siempre que se especifique el valor del parámetro in_template_dataset. Si se especifican los parámetros rectangle y in_template_dataset, se utilizará el valor del parámetro rectangle. Si el valor especificado no está alineado con el dataset ráster de entrada, la herramienta comprueba que se utilice la alineación adecuada. Esto puede provocar que la salida tenga una extensión ligeramente distinta a la especificada. | 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 utilizarán como extensión. La salida de recorte incluye 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. 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) | Especifica si se utilizará el rectángulo mínimo de delimitación o la geometría de la clase de entidad especificada para recortar los datos.
| Boolean |
maintain_clipping_extent (Opcional) | Especifica la extensión que se utilizará en la salida de recorte.
| Boolean |
Muestra de código
Esta es una muestra de Python para la función 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 de script de Python para la función 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 de script de Python para la función Clip utilizando el parámetro 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")