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, catálogos de ráster, 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.
-
Sólo puede agregar rásteres a un dataset de mosaico que se encuentre dentro de una geodatabase. Aquellos que se crean fuera de una geodatabase sólo pueden tener el contenido de un catálogo de ráster o de un dataset de mosaico creado previamente.
El tipo de ráster identifica los metadatos necesarios para cargar datos en el dataset de mosaico.
Sintaxis
| 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, consulte la lista de formatos de datos de imágenes y ráster compatibles. Si utiliza un tipo de ráster LAS, dataset de LAS o de terreno, debe usar un archivo *.ART, en el que se especifica el tamaño de celda. | Raster Type |
input_path [input_path,...] |
Ruta y nombre de archivo, carpeta, dataset ráster, catálogo de 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; Workspace; Raster Dataset; Mosaic Dataset; Table; Raster Layer; Raster Catalog Layer; Mosaic Layer; Terrain Layer; WCS Coverage; Image Service; MapServer; WMS Map; Dataset; Layer File; Terrain; LAS Dataset Layer |
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. Por defecto, 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 calor puede afectar la visualización y 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. Si desea agregar solo una imagen TIFF, puede agregar un asterisco antes de una extensión de archivo.
Si desea agregar cualquier imagen con la palabra sensor en la ruta de archivo o el nombre de archivo, debe agregar un asterisco antes y después de la palabra sensor.
O puede utilizar la sintaxis de PERL para crear un filtro de datos.
| 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 para todos los rásteres al cargar datos en el dataset de mosaico.
| Boolean |
Ejemplo 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",
"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")
Esta es una muestra de 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)