Exportar elementos de dataset de mosaico (Administración de datos)

Resumen

Guarda una copia de imágenes procesadas en un dataset de mosaico en una carpeta especificada y en formato de archivos ráster.

Hay dos flujos de trabajo comunes que utilizan esta herramienta:

  • Exporte cada elemento seleccionado de un dataset de mosaico a un nuevo archivo. Esto permite tener cada elemento procesado como un archivo independiente. Debe establece el valor NoData adecuado para los elementos exportados para que no haya bordes oscuros.
  • Exporte cada imagen seleccionada dentro de un dataset de mosaico de serie temporal basado en un área de interés. Esto permite exportar solo el área de interés de cada intervalo de tiempo.

Uso

  • De forma predeterminada, todos los elementos se exportan a la carpeta especificada. Utilice el parámetro Definición de consulta o seleccione interactivamente registros concretos en el dataset de mosaico para exportar un subconjunto de las imágenes.

  • Las imágenes se exportarán con todo el procesamiento de las cadenas de funciones aplicadas. Solo se aplican las cadenas de funciones en el nivel de elemento; las cadenas de funciones en el nivel de dataset de mosaico se ignoran. Esta herramienta no exporta las imágenes de origen sin procesar.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de mosaico

El dataset de mosaico que contiene las imágenes a exportar.

Mosaic Layer
Carpeta de salida

La carpeta donde se guardarán las imágenes.

Folder
Nombre de base de salida
(Opcional)

Un prefijo para agregar el nombre de cada elemento después de copiarlo. El prefijo irá seguido por el valor Object ID de la tabla de huellas del dataset de mosaico.

Si no se establece ningún nombre de base, se utilizará el texto que haya en el campo Name del elemento de dataset de mosaico.

String
Definición de consulta
(Opcional)

Expresión SQL que se usará para guardar las imágenes seleccionadas en el dataset de mosaico.

SQL Expression
Formato de salida
(Opcional)

Especifica el formato que se utilizará para los datasets ráster de salida.

  • TIFFSe utilizará el formato TIFF. Esta es la opción predeterminada.
  • Cloud Optimized GeoTIFFSe utilizará el formato Cloud Optimized GeoTIFF.
  • BMPSe utilizará el formato BMP.
  • ENVI DATSe utilizará el formato ENVI DAT.
  • Esri BILSe utilizará el formato BIL de Esri.
  • Esri BIPSe utilizará el formato BIP de Esri.
  • Esri BSQSe utilizará el formato BSQ de Esri.
  • GIFSe utilizará el formato GIF.
  • Cuadrícula de EsriSe utilizará el formato de cuadrícula de Esri.
  • ERDAS IMAGINESe utilizará el formato ERDAS IMAGINE.
  • JPEG 2000Se utilizará el formato JPEG 2000.
  • JPEGSe utilizará el formato JPEG.
  • PNGSe utilizará el formato PNG.
  • Formato de ráster de nubeSe utilizará el formato de ráster de nube.
  • Formato de metarrásterSe utilizará el formato metarráster.
String
Valor NoData
(Opcional)

Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida.

Se recomienda que especifique un valor NoData si las imágenes de salida se recortarán.

String
Tipo de recorte
(Opcional)

Especifica la extensión de salida de los datasets ráster. Si elige una extensión o clase de entidad que cubra un área mayor que los datos ráster, la salida tendrá la extensión mayor.

  • Sin recorteLa salida no se recortará. Esta es la opción predeterminada.
  • Recortar a la extensiónSe utilizará una extensión para recortar la salida.
  • Clase de entidad de recorteSe utilizará una extensión de clase de entidad para recortar la salida.
String
Plantilla de recorte
(Opcional)

La clase de entidad o el cuadro de delimitación que se utilizará para limitar 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
Tamaño de celda
(Opcional)

Las dimensiones horizontal (x) y vertical (y) de las celdas de salida.

Si no se especifica el tamaño de celda, se utilizará la resolución espacial de la entrada.

Point
Exportar imágenes a espacio de imagen
(Opcional)

Especifica si los elementos ráster se exportarán en el espacio de mapa o en el espacio de imagen.

  • Desactivado: los elementos ráster se exportarán en el espacio de mapa. Esta es la opción predeterminada.
  • Activado: los elementos ráster se exportarán en el espacio de imagen.

Boolean
Eliminar distorsiones de imagen
(Opcional)

Especifica si se eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen.

  • Desactivado: no se eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen. Esta es la opción predeterminada.
  • Activado: se eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Carpeta de salida actualizada

La carpeta de salida actualizada.

Folder

arcpy.management.ExportMosaicDatasetItems(in_mosaic_dataset, out_folder, {out_base_name}, {where_clause}, {format}, {nodata_value}, {clip_type}, {template_dataset}, {cell_size}, {image_space}, {remove_distortion})
NombreExplicaciónTipo de datos
in_mosaic_dataset

El dataset de mosaico que contiene las imágenes a exportar.

Mosaic Layer
out_folder

La carpeta donde se guardarán las imágenes.

Folder
out_base_name
(Opcional)

Un prefijo para agregar el nombre de cada elemento después de copiarlo. El prefijo irá seguido por el valor Object ID de la tabla de huellas del dataset de mosaico.

Si no se establece ningún nombre de base, se utilizará el texto que haya en el campo Name del elemento de dataset de mosaico.

String
where_clause
(Opcional)

Expresión SQL que se usará para guardar las imágenes seleccionadas en el dataset de mosaico. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
format
(Opcional)

Especifica el formato que se utilizará para los datasets ráster de salida.

  • TIFFSe utilizará el formato TIFF. Esta es la opción predeterminada.
  • Cloud Optimized GeoTIFFSe utilizará el formato Cloud Optimized GeoTIFF.
  • BMPSe utilizará el formato BMP.
  • ENVISe utilizará el formato ENVI DAT.
  • Esri BILSe utilizará el formato BIL de Esri.
  • Esri BIPSe utilizará el formato BIP de Esri.
  • Esri BSQSe utilizará el formato BSQ de Esri.
  • GIFSe utilizará el formato GIF.
  • GRIDSe utilizará el formato de cuadrícula de Esri.
  • IMAGINE IMAGESe utilizará el formato ERDAS IMAGINE.
  • JP2Se utilizará el formato JPEG 2000.
  • JPEGSe utilizará el formato JPEG.
  • PNGSe utilizará el formato PNG.
  • CRFSe utilizará el formato de ráster de nube.
  • MRFSe utilizará el formato metarráster.
String
nodata_value
(Opcional)

Todos los píxeles con el valor especificado se establecerán como NoData en el dataset ráster de salida.

Se recomienda que especifique un valor NoData si las imágenes de salida se recortarán.

String
clip_type
(Opcional)

Especifica la extensión de salida de los datasets ráster. Si elige una extensión o clase de entidad que cubra un área mayor que los datos ráster, la salida tendrá la extensión mayor.

  • NONELa salida no se recortará. Esta es la opción predeterminada.
  • EXTENTSe utilizará una extensión para recortar la salida.
  • FEATURE_CLASSSe utilizará una extensión de clase de entidad para recortar la salida.
String
template_dataset
(Opcional)

La clase de entidad o el cuadro de delimitación que se utilizará para limitar 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
cell_size
(Opcional)

Las dimensiones horizontal (x) y vertical (y) de las celdas de salida.

Si no se especifica el tamaño de celda, se utilizará la resolución espacial de la entrada.

Point
image_space
(Opcional)

Especifica si los elementos ráster se exportarán en el espacio de mapa o en el espacio de imagen.

  • MAPSPACELos elementos ráster se exportarán en el espacio de mapa. Esta es la opción predeterminada.
  • IMAGESPACELos elementos ráster se exportarán en el espacio de imagen.
Boolean
remove_distortion
(Opcional)

Especifica si se eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen.

  • REMOVEDSe eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen.
  • NOTREMOVENo se eliminará la distorsión de la lente del ráster exportado en el espacio de la imagen. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
derived_out_folder

La carpeta de salida actualizada.

Folder

Muestra de código

Ejemplo 1 de ExportMosaicDatasetItems (ventana de Python)

Esta es una muestra de Python para la función ExportMosaicDatasetItems.

import arcpy
arcpy.ExportMosaicDatasetItems_management(
     "c:/workspace/exportmditems.gdb/export_all_items", 
     "c:/workspace/export_all_items_out", 
     "allitems", "", "TIFF", "", "NONE", "", "")
Ejemplo 2 de ExportMosaicDatasetItems (script independiente)

Esta es una muestra de script de Python para la función ExportMosaicDatasetItems.

#Export Mosaic Dataset items
                                                                       
import arcpy
arcpy.env.workspace = "c:/workspace"
    
#export mosaic dataset items using feature class as clipping extent
imdname = "exportmditem.gdb/exportmd" 
outfolder = "c:/workspace/outfolder"
basename = "Landsat8"
query = "OBJECTID = 1"
out_format = "TIFF"
nodata_value = "#"
cliptype = "FEATURE_CLASS"
clip_featureclass = "c:/workspace/featureclassdb.gdb/clip_FC"
cell_size = "#"

arcpy.ExportMosaicDatasetItems_management(imdname, outfolder, basename, 
     query, out_format, nodata_value, cliptype, clip_featureclass, cell_size)

Información de licenciamiento

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