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ámetro | Explicación | Tipo 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.
| 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.
| 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.
| Boolean |
update_overviews (Opcional) | Especifica si se definen y generan vistas generales de un dataset de mosaico.
| 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:
Si desea agregar solo una imagen TIFF, añada un asterisco delante de una extensión de archivo.
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.
O puede utilizar la sintaxis de PERL para crear un filtro de datos.
No se admite la sintaxis PERL siguiente con varias agrupaciones léxicas como parte de la expresión:
Alternativamente, puede usar la sintaxis siguiente:
| String |
sub_folder (Opcional) | Especifica si las subcarpetas se explorarán de forma recursiva.
| 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.
| String |
build_pyramids (Opcional) | Crea pirámides para cada ráster de origen.
| Boolean |
calculate_statistics (Opcional) | Especifica si las estadísticas se calcularán para cada ráster de origen.
| Boolean |
build_thumbnails (Opcional) | Especifica si las vistas en miniatura se crearán para cada ráster de origen.
| 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.
| 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.
| 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.
| 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
| Nombre | Explicación | Tipo de datos |
| out_mosaic_dataset | El dataset de mosaico actualizado. | Capa de mosaico |
Muestra de código
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")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)Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí