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ámetroExplicaciónTipo 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_CLIPPINGLos archivos se recortarán en función del rectángulo mínimo de delimitación que se especificó. Esta es la opción predeterminada.
  • CLIPPINGLos 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_REQUIREDLos datasets ráster no se convierten a un formato nuevo.
  • ALWAYS_CONVERTConvierte 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.

  • TIFFFormato de archivo de imagen con etiquetas. Esta es la opción predeterminada.
  • BILBanda Esri intercalada por línea.
  • BSQBanda Esri secuencial.
  • BIPBanda Esri intercalada por píxel.
  • BMPMapa de bits.
  • ENVIArchivo ENVI DAT.
  • IMAGINE ImageERDAS IMAGINE.
  • JPEGJoint 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.
  • GIFFormato de intercambio de gráficos.
  • JP2JPEG 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.
  • PNGPortable Network Graphics.
String
compression_method
(Opcional)

Elija el método de compresión que va a usar con el Formato de salida especificado.

  • NONENo se producirá ninguna compresión. Esta es la opción predeterminada.
  • JPEGCompresió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.
  • LZWCompresión sin pérdida de información que preserva todos los valores de celda ráster.
  • PACKBITSPackBits: compresión para archivos TIFF.
  • RLECodificación por longitud de pista para archivos IMG.
  • CCITT_GROUP3Compresión sin pérdida de información para datos de 1 bit.
  • CCITT_GROUP4Compresión sin pérdida de información para datos de 1 bit.
  • CCITT_1DCompresió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_FOLDERReplica la estructura de carpetas jerárquica utilizada para almacenar los datasets ráster de origen.
  • NO_MAINTAIN_FOLDERLos datasets ráster se descargarán en la out_folder como una estructura de carpetas plana.
Boolean

Salida derivada

NombreExplicaciónTipo 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

Información de licenciamiento

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

Temas relacionados