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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Dataset de entrada	El servicio de imágenes o dataset de mosaico que se va a descargar.	Image Service; Mosaic Layer; Raster Layer; String
Carpeta de salida	El destino del servicio de imágenes o dataset de mosaico.	Folder
Definición de consulta (Opcional)	Expresión SQL para limitar la descarga a los datasets ráster que cumplen con la expresión.	SQL Expression
Entidad de selección (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. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Portapapeles : la extensión puede copiarse y pegarse desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Usar Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent
Recortar utilizando entidad de selección (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. Desactivada: 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. Activado: los archivos se recortarán en función de la geometría de la Entidad de la selección.	Boolean
Convertir rásteres (Opcional)	Elija si siempre quiere convertir los rásteres al formato especificado o solamente convertirlos cuando sea necesario. Desactivado: los datasets ráster no se convierten a un formato nuevo. Activado: convierte los datasets ráster descargados a otro formato. Si utilizó la opción Entidad de selección para limitar la extensión, deberá especificar un formato en el parámetro Formato de salida.	Boolean
Formato de salida (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
Método de compresión (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
Calidad de compresión (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
Mantener la estructura de carpetas (Opcional)	Determina la estructura de carpetas de los rásteres descargados. Activado: replica la estructura de carpetas jerárquica utilizada para almacenar los datasets ráster de origen. Desactivado: los datasets ráster se descargarán en la carpeta de salida como una estructura de carpetas plana.	Boolean

Salida derivada

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

Python

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

Nombre	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 usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. 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