Agregar rásteres a dataset de mosaico (Administración de datos)

Resumen

Agrega datasets ráster a un dataset de mosaico desde varias fuentes, incluidos archivos, carpetas, tablas o servicios web.

Uso

  • Los datos ráster que se agregan no están administrados; si los datos ráster se eliminan o se mueven, el dataset de mosaico se verá afectado.

  • Solo puede agregar rásteres a un dataset de mosaico que se encuentre en una geodatabase. Aquellos que se crean fuera de una geodatabase solo pueden tener el contenido de un dataset de mosaico creado previamente.

  • El parámetro Tipo de ráster identifica los metadatos necesarios para cargar datos en el dataset de mosaico.

    Más información sobre tipos de ráster

    El tipo de ráster es específico para productos de imágenes. Identifica los metadatos, como por ejemplo, georreferenciación, fecha de adquisición y tipo de sensor, junto con un formato de ráster.

  • Las opciones de Plantillas de procesamiento incluyen las funciones que se aplicarán a los elementos que se agreguen al dataset de mosaico y el modo o el orden en que se aplicarán.

  • Para que la visualización y el procesamiento sean más rápidos, es posible generar la caché de píxeles para un dataset de mosaico cuando se selecciona la opción Habilitar caché de píxeles.

Sintaxis

arcpy.management.AddRastersToMosaicDataset(in_mosaic_dataset, raster_type, input_path, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {maximum_pyramid_levels}, {maximum_cell_size}, {minimum_dimension}, {spatial_reference}, {filter}, {sub_folder}, {duplicate_items_action}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {operation_description}, {force_spatial_reference}, {estimate_statistics}, {aux_inputs}, {enable_pixel_cache}, {cache_location})
ParámetroExplicaciónTipo de datos
in_mosaic_dataset

La ruta y el nombre del dataset de mosaico al que se agregarán los datos ráster.

Mosaic Layer
raster_type

El tipo de ráster es específico para productos de imágenes. Identifica los metadatos, como por ejemplo, georreferenciación, fecha de adquisición y tipo de sensor, junto con un formato de ráster.

Para obtener una lista de tipos de ráster y sensores compatibles, consulte Lista de sensores compatibles.

Si utiliza un tipo de ráster LAS, dataset LAS o de terreno, debe usar un archivo .art en el que se especifique el tamaño de celda.

Raster Type
input_path
[input_path,...]

Especifica la ruta y nombre del archivo, carpeta, dataset ráster, dataset de mosaico, tabla o servicio de entrada.

No todas las opciones de entrada estarán disponibles. El tipo de ráster seleccionado determina las opciones disponibles.

  • DatasetSeleccione un dataset geográfico de ArcGIS, como un dataset de mosaico o ráster en una geodatabase o tabla, como entrada.
  • FolderSeleccione una carpeta que contenga varios datasets ráster como entrada. La carpeta puede contener subcarpetas.Esta opción se ve afectada por los parámetros Incluir subcarpetas y Filtro de datos de entrada.
  • FileSeleccione uno o varios datasets ráster almacenados en una carpeta en el disco, un archivo de definición de servicio de imágenes (.ISDef) o un archivo de definición de proceso ráster (.RPDef) como entrada. La lista de archivos ignorará todos los archivos que no se correspondan con el tipo de ráster que se está agregando. No use esta opción con formatos de archivo que sean datasets ráster, como los archivos TIFF o MrSID. En su lugar, utilice el tipo de entrada dataset.
  • ServiceSeleccione un WCS, un mapa, un servicio de imágenes o un archivo de capa de servicio web como entrada.
File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace
update_cellsize_ranges
(Opcional)

Especifica si se calcularán los rangos de tamaño de celda de cada ráster en el dataset de mosaico. Estos valores se escriben en la tabla de atributos, en los campos minPS y maxPS.

  • UPDATE_CELL_SIZESSe calcularán los rangos de tamaño de celda para todos los rásteres en el dataset de mosaico. Esta es la opción predeterminada.
  • NO_CELL_SIZESNo se calcularán los rangos de tamaño de celda.
Boolean
update_boundary
(Opcional)

Especifica si se generará o actualizará el polígono de límite de un dataset de mosaico. De manera predeterminada, el límite fusiona todos los polígonos de huella para crear un único límite que representa la extensión de los píxeles válidos.

  • UPDATE_BOUNDARYSe generará o se actualizará el límite. Esta es la opción predeterminada.
  • NO_BOUNDARYNo se generará ni se actualizará el límite.
Boolean
update_overviews
(Opcional)

Especifica si se definen y generan vistas generales de un dataset de mosaico.

  • UPDATE_OVERVIEWSSe definirán y se generarán las vistas generales.
  • NO_OVERVIEWSNo se definirán ni se generarán las vistas generales. Esta es la opción predeterminada.
Boolean
maximum_pyramid_levels
(Opcional)

La cantidad máxima de niveles de pirámide que se utilizarán en el dataset de mosaico. Por ejemplo, un valor de 2 solo utilizará los primeros dos niveles de la pirámide del ráster de origen. Si este parámetro se deja en blanco o se escribe el valor -1, se generarán pirámides para todos los niveles.

Este valor puede afectar a la visualización y a la cantidad de vistas generales que se generarán.

Long
maximum_cell_size
(Opcional)

El tamaño de celda de pirámide máximo que se utilizará en el dataset de mosaico.

Double
minimum_dimension
(Opcional)

Las dimensiones mínimas de una pirámide ráster que se utilizarán en el dataset de mosaico.

Long
spatial_reference
(Opcional)

Sistema de referencia espacial de los datos de entrada.

Se debe especificar si los datos no tienen un sistema de coordenadas; de otro modo, se utilizará el sistema de coordenadas del dataset de mosaico. También se puede utilizar para invalidar el sistema de coordenadas de los datos de entrada.

Spatial Reference
filter
(Opcional)

Un filtro para los datos que se agregan al dataset de mosaico. Puede utilizar expresiones SQL para crear el filtro de datos. Los comodines para el filtro funcionan en la ruta completa de los datos de entrada.

La siguiente sentencia SQL seleccionará las filas en las que los siguientes ID de objetos coinciden:

  • OBJECTID IN (19745, 19680, 19681, 19744, 5932, 5931, 5889, 5890, 14551, 14552, 14590, 14591)

Si desea agregar solo una imagen TIFF, añada un asterisco delante de una extensión de archivo.

  • *.TIF

Si desea agregar alguna imagen con la palabra sensor en la ruta de acceso del archivo o el nombre de archivo, agregue un asterisco delante y detrás de la palabra sensor.

  • *sensor2009*

O puede utilizar la sintaxis de PERL para crear un filtro de datos.

  • REGEX:.*1923.*|.*1922.*

  • REGEX:.*192[34567].*|.*194.*|.*195.*

No se admite la sintaxis PERL siguiente con varias agrupaciones léxicas como parte de la expresión:

  • REGEX:.* map_mean_.*(?:(?:[a-z0-9]*)_pptPct_(?:[0-9]|1[0-2]*?)_2[0-9]_*\w*).img

Alternativamente, puede usar la sintaxis siguiente:

  • REGEX:.*map_mean_*[a-z0-9]*_pptPct_([0-9]|1[0-2])_2[0-9]*_\w*.img

String
sub_folder
(Opcional)

Especifica si las subcarpetas se explorarán de forma recursiva.

  • SUBFOLDERSSe explorarán todas las subcarpetas en busca de datos. Esta es la opción predeterminada.
  • NO_SUBFOLDERSSolo se explorará la carpeta de nivel superior en busca de datos.
Boolean
duplicate_items_action
(Opcional)

Especifica cómo se manejarán los rásteres duplicados. Se realizará una comprobación para determinar si ya se ha agregado cada ráster, usando la ruta y el nombre de archivo originales. Elija la acción que desea llevar a cabo cuando se encuentren una ruta y un nombre de archivo duplicados.

  • ALLOW_DUPLICATESSe agregarán todos los rásteres, incluso si ya existen dentro del dataset de mosaico. Esta es la opción predeterminada.
  • EXCLUDE_DUPLICATESNo se agregarán los rásteres duplicados.
  • OVERWRITE_DUPLICATESLos rásteres duplicados sobrescribirán el existente.
String
build_pyramids
(Opcional)

Crea pirámides para cada ráster de origen.

  • NO_PYRAMIDSNo se crearán pirámides. Esta es la opción predeterminada.
  • BUILD_PYRAMIDSSe crearán pirámides.
Boolean
calculate_statistics
(Opcional)

Especifica si las estadísticas se calcularán para cada ráster de origen.

  • NO_STATISTICSNo se calcularán las estadísticas. Esta es la opción predeterminada.
  • CALCULATE_STATISTICSSe calcularán las estadísticas.
Boolean
build_thumbnails
(Opcional)

Especifica si las vistas en miniatura se crearán para cada ráster de origen.

  • NO_THUMBNAILSNo se crearán vistas en miniatura. Esta es la opción predeterminada.
  • BUILD_THUMBNAILSSe crearán vistas en miniatura.
Boolean
operation_description
(Opcional)

La descripción utilizada para representar la operación de agregado de datos ráster. Se agregará a la tabla de tipo de ráster que se puede utilizar como parte de una búsqueda o como una referencia en otra oportunidad.

String
force_spatial_reference
(Opcional)

Especifica el sistema de coordenadas. Utilice el sistema de coordenadas que se especifica en el parámetro spatial_reference para todos los rásteres al cargar datos en el dataset de mosaico.

  • NO_FORCE_SPATIAL_REFERENCEEl sistema de coordenadas de todos los datos ráster se usará al cargar datos. Esta es la opción predeterminada.
  • FORCE_SPATIAL_REFERENCEEl sistema de coordenadas especificado en el parámetro spatial_reference se usará para cada ráster al cargar datos.
Boolean
estimate_statistics
(Opcional)

Especifica si se estiman estadísticas en el dataset de mosaico para obtener una representación en pantalla y un procesamiento más rápidos a nivel de dataset de mosaico.

  • NO_STATISTICSNo se estimarán las estadísticas. Las estadísticas generadas para cada elemento del dataset de mosaico se usarán para la visualización y el procesamiento. Esta es la opción predeterminada.
  • ESTIMATE_STATISTICSLas estadísticas se estimarán a nivel del dataset de mosaico. Utilizará la distribución de píxeles para mostrar el dataset de mosaico en lugar de la distribución del elemento de origen en el dataset de mosaico.
Boolean
aux_inputs
[aux_inputs,...]
(Opcional)

La configuración del tipo de ráster que se definirá en la página Propiedades de tipo de ráster. La configuración de este parámetro sustituirá a la definida en la página Propiedades de tipo de ráster.

Value Table
enable_pixel_cache
(Opcional)

Especifica si la caché de píxeles se generará para que la visualización y procesamiento del dataset de mosaico sean más rápidas.

  • NO_PIXEL_CACHENo se generará la caché de píxeles. Esta es la opción predeterminada.
  • USE_PIXEL_CACHESe generará la caché de píxeles.
Boolean
cache_location
(Opcional)

La ubicación de la caché de píxeles. Si no se define ninguna ubicación, la caché se escribe en C:\Users\<Username>\AppData\Local\ESRI\rasterproxies\.

Una vez definida la ubicación, no es necesario redefinir la ruta al agregar nuevos rásteres al dataset de mosaico. Tan solo es necesario activar el parámetro Habilitar caché de píxeles (enable_pixel_cache = "USE_PIXEL_CACHE" en Python) al agregar los nuevos datos.

Folder; String

Salida derivada

NombreExplicaciónTipo de datos
out_mosaic_dataset

El dataset de mosaico actualizado.

Capa de mosaico

Muestra de código

Ejemplo 1 de AddRastersToMosaicDataset (ventana de Python)

Esta es una muestra de Python para la herramienta AddRastersToMosaicDataset.

import arcpy
arcpy.AddRastersToMosaicDataset_management(
     "c:/data/AddMD.gdb/md_landsat", "Landsat 7 ETM+", 
     "c:/data/landsat7etm", "UPDATE_CELL_SIZES", "UPDATE_BOUNDARY",
     "UPDATE_OVERVIEWS", "2", "#", "#", "GCS_WGS_1984.prj",
     "*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
     "NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS", 
     "Add Landsat L1G", "FORCE_SPATIAL_REFERENCE",
     "NO_STATISTICS", "", "USE_PIXEL_CACHE", 
r"C:\test\cachelocation")
Ejemplo 2 de AddRastersToMosaicDataset (script independiente)

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

#Add Raster Dataset type Raster to FGDB Mosaic Dataset
#Calculate Cell Size Ranges and Build Boundary
#Build Overviews for Mosaic Dataset upon the 3rd level Raster Dataset pyramid
#Apply TIFF file filter
#Build Pyramids for the source datasets

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
mdname = "AddMD.gdb/md_rasds"
rastype = "Raster Dataset"
inpath = "c:/data/rasds"
updatecs = "UPDATE_CELL_SIZES"
updatebnd = "UPDATE_BOUNDARY"
updateovr = "UPDATE_OVERVIEWS"
maxlevel = "2"
maxcs = "#"
maxdim = "#"
spatialref = "#"
inputdatafilter = "*.tif"
subfolder = "NO_SUBFOLDERS"
duplicate = "EXCLUDE_DUPLICATES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildthumb = "NO_THUMBNAILS"
comments = "Add Raster Datasets"
forcesr = "#"
estimatestats = "ESTIMATE_STATISTICS"
auxilaryinput = ""
enablepixcache = "USE_PIXEL_CACHE"
cachelocation = "c:\\test\\cachelocation"

arcpy.AddRastersToMosaicDataset_management(
     mdname,  rastype, inpath, updatecs, updatebnd, updateovr,
     maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
     subfolder, duplicate, buildpy, calcstats, 
     buildthumb, comments, forcesr, estimatestats
auxilaryinput, enablepixcache, cachelocation)

Información de licenciamiento

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

Temas relacionados