Resumen
Sincroniza un dataset de mosaico para mantenerlo actualizado. Además de sincronizar los datos, puede actualizar las vistas generales si la imagen subyacente ha cambiado, generar nuevas vistas generales y caché y restaurar la configuración original de los elementos del dataset de mosaico. Con esta herramienta también puede eliminar rutas a los datos de origen. Para reparar rutas, utilice la herramienta Reparar rutas de dataset de mosaico.
La sincronización es una operación de una vía: los cambios en los datos de origen se pueden sincronizar con la tabla de atributos del dataset de mosaico, actualizando por tanto la tabla de atributos del dataset de mosaico. Los cambios de la tabla de atributos del dataset de mosaico no afectarán a los datos de origen.
Uso
Puede utilizar un conjunto de selección con esta herramienta para limitar los elementos ráster que se actualizan. Cuando hay una selección o consulta, solo se procesarán esos elementos.
La sincronización puede agregar nuevos elementos, actualizar elementos existentes o quitar elementos.
Los elementos obsoletos son los rásteres de origen que se han cambiado desde que se creó el dataset de mosaico o desde la última vez que se sincronizó. Por ejemplo, puede que se haya actualizado la georreferenciación o se hayan construido pirámides.
Debido a que los elementos ráster reconstruirán, se perderá cualquier modificación realizada en ellos desde la última vez que se compilaron, como, por ejemplo, funciones de edición o el contenido de la tabla de atributos.
Si quita elementos que tienen fuentes de datos dañadas, asegúrese de que todas las conexiones de red estén funcionando correctamente. Esta herramienta eliminará los elementos a los que no se pueda acceder.
Esta herramienta también puede crear pirámides y calcular estadísticas de rásteres de origen, así como crear vistas en miniatura y una caché de rásteres para los elementos ráster.
Esta herramienta es particularmente útil para mantener los datasets de mosaico actualizados. Si se han agregado nuevos datasets ráster a los espacios de trabajo a los que tiene acceso este dataset de mosaico, los nuevos datasets ráster se pueden agregar al dataset de mosaico. Los datasets de mosaico que se completan con tablas que residen en una base de datos administrada externamente también se pueden actualizar con esta herramienta.
Para usar el parámetro Actualizar información agregada, desactive el parámetro Actualizar elementos existentes. En el caso de datasets de mosaico multidimensionales, el parámetro Actualizar información agregada refresca las propiedades multidimensionales del mosaico en función del contenido de la tabla de atributos del dataset de mosaico.
Esta herramienta se puede utilizar para generar la caché para un elemento en el dataset de mosaico. Los elementos que siempre se pueden almacenar en la caché se crean a partir de los siguientes datos: archivos .las, datasets LAS y terrenos. Los elementos también se pueden almacenar en caché utilizando la función Ráster almacenado en caché.
La fragmentación de la base de datos y la manipulación de datos frecuentes puede aumentar enormemente el tamaño del dataset de mosaico. Si el tamaño de la base de datos se incrementa debido a la realización constante de transacciones, ejecute la herramienta Compactar.
Sintaxis
arcpy.management.SynchronizeMosaicDataset(in_mosaic_dataset, {where_clause}, {new_items}, {sync_only_stale}, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {build_item_cache}, {rebuild_raster}, {update_fields}, {fields_to_update}, {existing_items}, {broken_items}, {skip_existing_items}, {refresh_aggregate_info}, estimate_statistics)| Parámetro | Explicación | Tipo de datos |
in_mosaic_dataset | El dataset de mosaico que se sincronizará. | Mosaic Layer |
where_clause (Opcional) | Una expresión SQL para seleccionar qué elementos del dataset de mosaico se sincronizarán. Si no facilita ninguna expresión, se actualizan todos los elementos del dataset de mosaico. | SQL Expression |
new_items (Opcional) | Especifica si se incluirán nuevos elementos al sincronizar, así como las opciones que se deben utilizar para actualizar los nuevos elementos. Si elige utilizar esta opción, se buscará en el espacio de trabajo del elemento para encontrar nuevos datos. Cuando se agregan datos al dataset de mosaico, se utilizará el mismo tipo de ráster que se utiliza para los otros elementos del mismo espacio de trabajo.
| Boolean |
sync_only_stale (Opcional) | Especifica si los elementos del dataset de mosaico se actualizarán solo cuando los datasets ráster subyacentes se hayan modificado debido a la sincronización. Por ejemplo, la creación de pirámides o la actualización de la georreferenciación de los rásteres afectará al renderizado de las vistas generales.
| Boolean |
update_cellsize_ranges (Opcional) | Especifica si se recalcularán los rangos de tamaño de celda del dataset de mosaico.
| Boolean |
update_boundary (Opcional) | Especifica si se reconstruirá el límite que muestra la extensión completa del dataset de mosaico. Elija UPDATE_BOUNDARY si la sincronización cambiará la extensión del dataset de mosaico.
| Boolean |
update_overviews (Opcional) | Especifica si se actualizarán las vistas generales obsoletas. La vista general se vuelve obsoleta si se modifica cualquier ráster subyacente debido a la sincronización.
| Boolean |
build_pyramids (Opcional) | Especifica si se construirán pirámides para los elementos de dataset de mosaico especificados. Se pueden construir pirámides para cada elemento ráster del dataset de mosaico. Las pirámides pueden mejorar la velocidad en que se visualiza cada ráster.
No se crearán pirámides para los elementos que se agregaron debido a la sincronización. | Boolean |
calculate_statistics (Opcional) | Especifica si se calcularán estadísticas para los elementos de dataset de mosaico especificados. Las estadísticas son necesarias para un dataset de mosaico a la hora de realizar determinadas tareas, como aplicar un aumento de contraste.
No se calcularán estadísticas para los elementos que se agregaron debido a la sincronización. | Boolean |
build_thumbnails (Opcional) | Especifica si se construirán vistas en miniatura para los elementos de dataset de mosaico especificados. Las vistas en miniatura son pequeñas imágenes, altamente remuestreadas, que se pueden crear para cada elemento ráster en la definición de mosaico. Se puede acceder a las vistas en miniatura cuando se accede al dataset de mosaico como un servicio de imagen y se visualizarán como parte de la descripción de elemento.
No se crearán miniaturas para los elementos que se agregaron debido a la sincronización. | Boolean |
build_item_cache (Opcional) | Especifica si se generará una caché para los elementos de dataset de mosaico especificados. Se puede generar una caché cuando ha agregado los datos mediante los tipos de ráster LAS, Terreno o Dataset LAS. Los elementos también se pueden almacenar en caché utilizando la función Ráster almacenado en caché.
No se generará una caché para los elementos que se agregaron debido a la sincronización. | Boolean |
rebuild_raster (Opcional) | Especifica si se volverán a generar los elementos ráster desde la fuente de datos utilizando el tipo de ráster original.
Esto solo afecta los elementos que se sincronizarán. Este parámetro no se aplica si el parámetro new_items está establecido como UPDATE_WITH_NEW_ITEMS. | Boolean |
update_fields (Opcional) | Especifica si se actualizarán los campos de la tabla. Esto solo afecta los elementos que se sincronizarán.
Si actualiza los campos, puede controlar qué campos se actualizan con el parámetro fields_to_update. Si edita alguno de los campos, puede anular la selección con el parámetro Campos a actualizarfields_to_update. | Boolean |
fields_to_update [field_to_update,...] (Opcional) | Los campos que se actualizarán. Este parámetro solo es válido si el parámetro update_fields está establecido en UPDATE_FIELDS. Si edita alguno de los campos, asegúrese de que no están en la lista. El campo RASTER se puede refrescar, incluso aunque no se haya especificado REBUILD_RASTER. Sin embargo, si se especifica REBUILD_RASTER se reconstruye el campo RASTER, incluso si el valor del parámetro fields_to_update no está especificado. | String |
existing_items (Opcional) | Especifica si se actualizarán los elementos existentes en el dataset de mosaico. Si utiliza este parámetro, elija qué parámetros existentes desea actualizar: sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields o fields_to_update.
| Boolean |
broken_items (Opcional) | Especifica si se quitarán los elementos con vínculos dañados. Asegúrese de que todas las conexiones de red funcionen correctamente. Esta herramienta eliminará los elementos a los que no se pueda acceder.
| Boolean |
skip_existing_items (Opcional) | Especifica si los elementos del dataset de mosaico existentes se omitirán o actualizarán con los archivos modificados del disco. Para usar este parámetro, el parámetro new_items se debe definir como UPDATE_WITH_NEW_ITEMS.
| Boolean |
refresh_aggregate_info (Opcional) | Especifica si se incluirán los datos que se hayan podido eliminar del dataset de mosaico. Para usar este parámetro, el parámetro existing_items se debe definir como IGNORE_EXISTING_ITEMS.
| Boolean |
estimate_statistics | Especifica si se estimarán estadísticas en el dataset de mosaico.
| Boolean |
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 SynchronizeMosaicDataset (ventana de Python)
Esta es una muestra de Python para la función SynchronizeMosaicDataset.
import arcpy
arcpy.SynchronizeMosaicDataset_management(
"c:/data/syncmd.gdb/md", "Year>1999", "NO_NEW_ITEMS", "SYNC_STALE",
"#", "#", "#", "NO_PYRAMIDS", "NO_STATISTICS", "NO_THUMBNAILS",
"NO_ITEM_CACHE", "NO_RASTER", "NO_FIELDS", "#", "#")
Ejemplo 2 de SynchronizeMosaicDataset (script independiente)
Esta es una muestra de script de Python para la función SynchronizeMosaicDataset.
# Synchronize source and add new data
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "syncmd.gdb/mdnew"
query = "#"
updatenew = "UPDATE_WITH_NEW_ITEMS"
syncstale = "SYNC_STALE"
updatecs = "#"
updatebnd = "#"
updateovr = "#"
buildpy = "NO_PYRAMIDS"
calcstats = "NO_STATISTICS"
buildthumb = "NO_THUMBNAILS"
buildcache = "NO_ITEM_CACHE"
updateras = "NO_RASTER"
updatefield = "NO_FIELDS"
fields = "#"
arcpy.SynchronizeMosaicDataset_management(
mdname, query, updatenew, syncstale, updatecs, updatebnd,
updateovr, buildpy, calcstats, buildthumb, buildcache,
updateras, updatefield, fields)
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí