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 son administrados; por lo tanto, 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 dentro de 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.
Sintaxis
AddRastersToMosaicDataset_management (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. | Image Service; Mosaic Layer; String |
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, consulte la lista de formatos de datos de imágenes y ráster 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,...] | Ruta y nombre del archivo, carpeta, dataset ráster, dataset de mosaico, tabla o servicio. No todas las opciones de entrada estarán disponibles. Las opciones disponibles dependen del tipo de ráster seleccionado.
| File; Image Service; LAS Dataset Layer; Layer File; MapServer; Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View; Terrain Layer; WCS Coverage; WMS Map; Workspace |
update_cellsize_ranges (Opcional) | Calcula 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 las columnas minPS y maxPS.
| Boolean |
update_boundary (Opcional) | Genera o actualiza 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) | Define y genera las vistas generales para un dataset de mosaico.
| Boolean |
maximum_pyramid_levels (Opcional) | Define 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 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) | Define el tamaño de celda de pirámide máximo que se utilizará en el dataset de mosaico. | Double |
minimum_dimension (Opcional) | Define 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 cualquier imagen con la palabra sensor en la ruta de acceso del archivo o el nombre de archivo, añada 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) | Explora recursivamente las subcarpetas.
| Boolean |
duplicate_items_action (Opcional) | Se realizará una comprobación para ver si ya se agregaron todos los rásteres, con la ruta y el nombre de archivo originales. Elija la acción que desea llevar a cabo cuando se encuentra 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) | Calcula las estadísticas para cada ráster de origen.
| Boolean |
build_thumbnails (Opcional) | Crea miniaturas para cada ráster de origen.
| Boolean |
operation_description (Opcional) | La descripción que desea utilizar para representar esta 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) | 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) | Se calculan las estadísticas del dataset de mosaico para obtener una representación en pantalla y un procesamiento más rápidos en el nivel de dataset de mosaico.
| Boolean |
aux_inputs [aux_inputs,...] (Opcional) | Es la configuración del tipo de ráster definida en la página Propiedades de tipo de ráster. La configuración indicada en este parámetro sustituirá a la definida en la página Propiedades de tipo de ráster. | Value Table |
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",
"NO_OVERVIEWS", "UPDATE_OVERVIEWS", "2", "#", "#",
"GCS_WGS_1984.prj","*.tif", "SUBFOLDERS", "EXCLUDE_DUPLICATES",
"NO_PYRAMIDS", "NO_STATISTICS", "BUILD_THUMBNAILS",
"Add Landsat L1G", "FORCE_SPATIAL_REFERENCE")
Ejemplo 2 de AddRastersToMosaicDataset (secuencia de comandos independiente)
Esta es una muestra de la secuencia de comandos 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 = "#"
arcpy.AddRastersToMosaicDataset_management(
mdname, rastype, inpath, updatecs, updatebnd, updateovr,
maxlevel, maxcs, maxdim, spatialref, inputdatafilter,
subfolder, duplicate, buildpy, calcstats,
buildthumb, comments, forcesr)
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí