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 catálogo de ráster o 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.
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})| 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 metadatos como, por ejemplo, georreferenciación, fecha de adquisición y tipo de sensor, junto con un formato de ráster. 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. Para obtener una lista de tipos de ráster, consulte la lista de formatos de datos de imágenes y ráster compatibles. | 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; Map Server; Mosaic Layer; Raster Catalog 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:
Para agregar solo una imagen TIFF, agregue un asterisco delante de una extensión de archivo.
Para agregar una 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.
También puede utilizar la sintaxis 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 |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_mosaic_dataset | El dataset de mosaico actualizado. | Mosaic Layer |
Muestra de código
Ejemplo 1 de AddRastersToMosaicDataset (ventana de Python)
Esta es una muestra de Python para la función 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 de script de Python para la función 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 = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí