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

EtiquetaExplicaciónTipo 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 Vista de mapa: 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 Cuadrar y terminar: 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 Capa: 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 Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: 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 Restablecer: 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.

  • 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.
  • ENVI DatArchivo ENVI DAT.
  • Imagen de ImagineERDAS 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
Método de compresión
(Opcional)

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

  • NadaNo 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 Grupo 3Compresión sin pérdida de información para datos de 1 bit.
  • Ccitt Grupo 4Compresió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
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

EtiquetaExplicaciónTipo de datos
Carpeta actualizada

La carpeta de salida actualizada.

Carpeta

arcpy.management.DownloadRasters(in_image_service, out_folder, {where_clause}, {selection_feature}, {clipping}, {convert_rasters}, {format}, {compression_method}, {compression_quality}, {MAINTAIN_FOLDER})
NombreExplicació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 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_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