Résumé
Synchronise un jeu de données mosaïque pour le maintenir à jour. Outre la synchronisation des données, vous pouvez également mettre à jour les vues d'ensemble si l'imagerie sous-jacente a changé, générer de nouvelles vues d'ensemble et un nouveau cache, et restaurer la configuration d'origine des éléments de mosaïque. Vous pouvez également supprimer les chemins d'accès aux données source avec cet outil. Pour réparer des chemins, utilisez l’outil Réparer les chemins d’accès des jeux de données mosaïque.
La synchronisation est une opération monodirectionnelle. Les modifications apportées aux données source peuvent être synchronisées dans la table attributaire du jeu de données mosaïque, ce qui l’actualise. Les modifications appliquées à la table attributaire de la mosaïque n'affectent pas les données source.
Utilisation
Vous pouvez utiliser un ensemble de sélection avec cet outil pour limiter les éléments raster mis à jour. Seuls ces éléments sont traités en cas de sélection ou de requête.
La synchronisation peut ajouter de nouveaux éléments, mettre à jour des éléments existants ou en supprimer.
Les éléments obsolètes concernent des rasters source qui ont été modifiés depuis la création de la mosaïque ou depuis sa dernière synchronisation. Il se peut, par exemple, que le géoréférencement ait été mis à jour ou que des pyramides aient été construites.
Étant donné que les éléments raster sont reconstruits, toutes les modifications qui leur ont été apportées depuis la dernière construction sont perdues, comme certaines fonctions ou certains contenus de mise à jour de la table attributaire.
Si vous supprimez des éléments contenant des sources de données rompues, vérifiez que toutes les connexions réseau sont opérationnelles. Cet outil supprime tout élément auquel il est impossible d’accéder.
En outre, vous pouvez créer des pyramides et calculer des statistiques sur les rasters source, ou encore créer des miniatures et un cache raster pour les éléments raster.
Cet outil est particulièrement utile pour garder les mosaïques à jour. Si de nouveaux jeux de données raster ont été ajoutés aux espaces de travail auxquels cette mosaïque accède, les nouveaux jeux de données raster peuvent être ajoutés à la mosaïque. Vous pouvez également mettre à jour les mosaïques alimentées par des tables résidant dans une base de données gérée en externe.
Pour utiliser le paramètre Refresh Aggregate Information (Actualiser les informations d’agrégat), désactivez le paramètre Update Existing Items (Mettre à jour les éléments existants). Pour les jeux de données mosaïque multidimensionnels, le paramètre Actualiser les informations d’agrégat actualise les propriétés multidimensionnelles de la mosaïque en fonction du contenu de la table attributaire du jeu de données mosaïque.
Cet outil peut servir à générer le cache pour un élément de la mosaïque. Les éléments qui peuvent toujours être mis en cache sont créés à partir des données suivantes : fichiers .las, jeu de données LAS et MNT. La fonction Raster en cache permet également de les mettre en cache.
La fragmentation des bases de données et la manipulation fréquente des données peut augmenter considérablement la taille de votre mosaïque. Si la taille de votre base de données augmente en raison de constantes transactions, exécutez l'outil Compacter.
Syntaxe
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)| Paramètre | Explication | Type de données |
in_mosaic_dataset | Jeu de données mosaïque à synchroniser. | Mosaic Layer |
where_clause (Facultatif) | Expression SQL permettant de sélectionner les éléments de mosaïque à synchroniser. Si aucune expression n'est fournie, tous les éléments de mosaïque sont mis à jour. | SQL Expression |
new_items (Facultatif) | Indique si de nouveaux éléments sont inclus lors de la synchronisation, ainsi que les options à utiliser pour mettre à jour les nouveaux éléments. Si vous utilisez cette option, la recherche porte sur les nouvelles données dans l’espace de travail des éléments. Lorsque des données sont ajoutées à la mosaïque, le même type de raster que les autres éléments figurant dans le même espace de travail est utilisé.
| Boolean |
sync_only_stale (Facultatif) | Indique si les éléments du jeu de données mosaïque sont mis à jour uniquement lorsque les jeux de données raster sous-jacents ont été modifiés suite à la synchronisation. Par exemple, la génération de pyramides ou la mise à jour du géoréférencement de rasters influe sur le rendu des vues d'ensemble.
| Boolean |
update_cellsize_ranges (Facultatif) | Indique si les plages des tailles de cellules du jeu de données mosaïque sont recalculées.
| Boolean |
update_boundary (Facultatif) | Indique si la limite qui affiche l’étendue générale du jeu de données mosaïque est reconstruite. Choisissez UPDATE_BOUNDARY si la synchronisation modifie l’étendue du jeu de données mosaïque.
| Boolean |
update_overviews (Facultatif) | Indique si les vues d’ensemble obsolètes sont mises à jour. La vue d’ensemble devient obsolète si des rasters sous-jacents ont été modifiés suite à la synchronisation.
| Boolean |
build_pyramids (Facultatif) | Indique si des pyramides sont construites pour les éléments du jeu de données mosaïque spécifiés. Les pyramides peuvent être construites pour chaque élément raster de la mosaïque. Les pyramides peuvent améliorer la vitesse à laquelle chaque raster est affiché.
Aucune pyramide n'est générée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
calculate_statistics (Facultatif) | Indique si des statistiques sont calculées pour les éléments du jeu de données mosaïque spécifiés. Les statistiques sont obligatoires pour effectuer certaines tâches avec un jeu de données mosaïque, par exemple appliquer un étirement de contraste.
Aucune statistique n'est calculée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
build_thumbnails (Facultatif) | Indique si des miniatures sont construites pour les éléments du jeu de données mosaïque spécifiés. Les miniatures sont de petites images fortement rééchantillonnées qui peuvent être créées pour chaque élément raster dans la définition de la mosaïque. Les miniatures sont accessibles lorsque vous accédez à la mosaïque en tant que service d'imagerie et s'affichent dans la description de l'élément.
Aucune miniature n'est générée pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
build_item_cache (Facultatif) | Indique si un cache est construit pour les éléments du jeu de données mosaïque spécifiés. Vous pouvez construire un cache lorsque vous avez ajouté des données à l’aide des types raster LAS, MNT ou Jeu de données LAS. La fonction Raster en cache permet également de les mettre en cache.
Aucun cache n’est construit pour les éléments qui ont été ajoutés suite à la synchronisation. | Boolean |
rebuild_raster (Facultatif) | Indique si les éléments raster sont reconstruits à partir de la source de données à l’aide du type de raster d’origine.
Cela ne concerne que les éléments qui sont synchronisés. Ce paramètre n’est pas applicable si le paramètre new_items est défini sur UPDATE_WITH_NEW_ITEMS. | Boolean |
update_fields (Facultatif) | Indique si les champs dans la table sont mis à jour. Cela ne concerne que les éléments qui sont synchronisés.
Si vous mettez à jour les champs, vous pouvez déterminer ceux à mettre à jour avec le paramètre fields_to_update. Si vous avez mis certains champs à jour, vous pouvez les supprimer à l’aide du paramètre fields_to_update. | Boolean |
fields_to_update [field_to_update,...] (Facultatif) | Champs à mettre à jour. Ce paramètre est valide uniquement si le paramètre update_fields est défini sur UPDATE_FIELDS. Si vous avez mis certains champs à jour, vérifiez qu’ils ne sont pas répertoriés dans la liste. Le champ RASTER peut être actualisé, même si le paramètre REBUILD_RASTER n’est pas précisé. Toutefois, si REBUILD_RASTER est spécifié, le champ RASTER est reconstruit, même si la valeur du paramètre fields_to_update n’est pas spécifiée. | String |
existing_items (Facultatif) | Indique si les éléments existants du jeu de données mosaïque sont mis à jour. Si vous utilisez ce paramètre, choisissez les paramètres existants à mettre à jour : sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_fields ou fields_to_update.
| Boolean |
broken_items (Facultatif) | Indique si les éléments présentant des liens rompus sont supprimés. Vérifiez que toutes les connexions réseau sont opérationnelles. Cet outil supprime tout élément auquel il est impossible d’accéder.
| Boolean |
skip_existing_items (Facultatif) | Indique si les éléments du jeu de données mosaïque existants sont ignorés ou mis à jour avec les fichiers modifiés sur le disque. Pour utiliser ce paramètre, le paramètre new_items doit être défini sur UPDATE_WITH_NEW_ITEMS.
| Boolean |
refresh_aggregate_info (Facultatif) | Indique si les données qui ont pu être supprimées du jeu de données mosaïque sont incluses. Pour utiliser ce paramètre, le paramètre existing_items doit être défini sur IGNORE_EXISTING_ITEMS.
| Boolean |
estimate_statistics | Indique si les statistiques sur le jeu de données mosaïque sont estimées.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| out_mosaic_dataset | Jeu de données mosaïque mis à jour. | Mosaic Layer |
Exemple de code
Exemple 1 d'utilisation de l'outil SynchronizeMosaicDataset (fenêtre Python)
Il s’agit d’un exemple Python d’utilisation de la fonction 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", "#", "#")
Exemple 2 d'utilisation de l'outil SynchronizeMosaicDataset (script autonome)
Il s’agit d’un exemple de script Python d’utilisation de la fonction 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)
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui