Descargar rásteres (Administración de datos)

Resumen

Descarga los archivos de origen de un servicio de imágenes o dataset de mosaico.

Uso

• Los datasets ráster que descargue son los archivos de origen, a menos que los convierta a otro formato. La conversión del formato puede ser forzada, o bien, ocurrirá cuando sea requerido. Los archivos descargados se convierten si ocurre recorte o si el archivo origen no se puede descargar como un ráster.

• Puede descargar los rásteres seleccionados o archivos LAS desde un servicio de imágenes o dataset de mosaico hacia una carpeta especificada en el formato del archivo original.

• Si se especifica una extensión de recorte, los rásteres que intersecan la extensión del clip se recortarán y luego se convertirán a un formato específico.

• Puede elegir descargar los datos en la misma estructura de la carpeta como el origen.

Sintaxis

arcpy.management.DownloadRasters(in_image_service, out_folder, {where_clause}, {selection_feature}, {clipping}, {convert_rasters}, {format}, {compression_method}, {compression_quality}, {MAINTAIN_FOLDER})

Parámetro	Explicación	Tipo de datos
in_image_service	El servicio de imágenes o dataset de mosaico que se va a descargar.	Image Service; Mosaic Layer; Raster Layer; String
out_folder	El destino del servicio de imágenes o dataset de mosaico.	Folder
where_clause (Opcional)	Expresión SQL para limitar la descarga a los datasets ráster que cumplen con la expresión.	SQL Expression
selection_feature (Opcional)	Limita la descarga a la extensión de una clase de entidad o cuadro de delimitación. Se descargarán todos los datasets ráster que intersequen la extensión. MAXOF: se utilizará la extensión máxima de todas las entradas. MINOF: se utilizará el área mínima en común de todas las entradas. DISPLAY: la extensión es igual a la visualización actual. 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
clipping (Opcional)	Especifique si desea recortar las imágenes descargadas con base en la geometría de una entidad. Cualquier ráster que interseque la geometría de recorte se recortará y luego se descargará. Esto es útil cuando su área de interés no es un rectángulo. Cuando se recortan imágenes descargadas, debe especificar un formato de salida para las imágenes recortadas. NO_CLIPPING —Los archivos se recortarán en función del rectángulo mínimo de delimitación que se especificó. Esta es la opción predeterminada. CLIPPING —Los archivos se recortarán en función de la geometría de la selection_feature.	Boolean
convert_rasters (Opcional)	Elija si siempre quiere convertir los rásteres al formato especificado o solamente convertirlos cuando sea necesario. CONVERT_AS_REQUIRED —Los datasets ráster no se convierten a un formato nuevo. ALWAYS_CONVERT —Convierte los datasets ráster descargados a otro formato. Si utilizó la opción selection_feature para limitar la extensión, deberá especificar un formato en el parámetro format.	Boolean
format (Opcional)	Elija un formato de salida para los datasets ráster descargados. TIFF —Formato de archivo de imagen con etiquetas. Esta es la opción predeterminada. BIL —Banda Esri intercalada por línea. BSQ —Banda Esri secuencial. BIP —Banda Esri intercalada por píxel. BMP —Mapa de bits. ENVI —Archivo ENVI DAT. IMAGINE Image —ERDAS IMAGINE. JPEG —Joint Photographics Experts Group. Si se elige, también puede especificar la calidad de compresión. Los rangos del valor de calidad de compresión válidos son de 0 a 100. GIF —Formato de intercambio de gráficos. JP2 —JPEG 2000. Si se elige, también puede especificar la calidad de compresión. Los rangos del valor de calidad de compresión válidos son de 0 a 100. PNG —Portable Network Graphics.	String
compression_method (Opcional)	Elija el método de compresión que va a usar con el Formato de salida especificado. NONE —No se producirá ninguna compresión. Esta es la opción predeterminada. JPEG —Compresión con pérdida de información que utiliza el algoritmo de compresión JPEG público. Si elige JPEG, también puede especificar la calidad de compresión. Los rangos del valor de calidad de compresión válidos son de 0 a 100. Este método de compresión se puede utilizar para archivos JPEG y TIFF. LZW —Compresión sin pérdida de información que preserva todos los valores de celda ráster. PACKBITS —PackBits: compresión para archivos TIFF. RLE —Codificación por longitud de pista para archivos IMG. CCITT_GROUP3 —Compresión sin pérdida de información para datos de 1 bit. CCITT_GROUP4 —Compresión sin pérdida de información para datos de 1 bit. CCITT_1D —Compresión sin pérdida de información para datos de 1 bit.	String
compression_quality (Opcional)	Defina un valor de 1 a 100. Los valores más altos tendrán una mejor calidad de la imagen, pero menos compresión.	Long
MAINTAIN_FOLDER (Opcional)	Determina la estructura de carpetas de los rásteres descargados. MAINTAIN_FOLDER —Replica la estructura de carpetas jerárquica utilizada para almacenar los datasets ráster de origen. NO_MAINTAIN_FOLDER —Los datasets ráster se descargarán en la out_folder como una estructura de carpetas plana.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
derived_out_folder	La carpeta de salida actualizada.	Carpeta

Muestra de código

Ejemplo 1 de DownloadRasters (ventana de Python)

Esta es una muestra de Python para la herramienta DownloadRasters.

import arcpy
DownloadRasters_management(
     "http://srv/arcgis/services/Ext/MDpan/ImageServer?", "c:/dload/", 
     "AcquisitionDate = date '1999-08-18'", "", 
     "c:/workspace/clippingfeat.shp", "TIFF", "JPEG", "75", 
     "MAINTAIN_FOLDER", "CONVERT_AS_REQUIRED")

Ejemplo 2 de DownloadRasters (script independiente)

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

##Download Rasters from image services URL
##Maintain the original sensor data folder structure

import arcpy
arcpy.env.workspace = r"\\myworkstation\Workspace\downloadras"
    
arcpy.DownloadRasters_management(
     "http://serv1/arcgis/services/Ext/MD_LS_pan/ImageServer?",
     "downloadFolder", "AcquisitionDate = date '1999-08-18 00:00:00'",
     "", "", "", "", "", "MAINTAIN_FOLDER")

Entornos

Extensión

Información de licenciamiento

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