Synchroniser une mosaïque (Gestion des données)

Récapitulatif

Cet outil permet de créer ou de mettre à jour chaque élément raster de la mosaïque et de mettre à jour les champs affectés de la table attributaire à l'aide du type de raster et des options utilisés lors de son ajout initial.

La synchronisation est une opération monodirectionnelle : les modifications des données source peuvent être synchronisées dans la table attributaire de la mosaïque, tandis que les modifications effectuées dans la table attributaire n'affectent pas les données source (mais elles peuvent être écrasées par la synchronisation).

RemarqueRemarque :

Les modifications apportées lors de la synchronisation ne peuvent pas être annulées. Par conséquent, il est conseillé de créer une copie de sauvegarde si vous avez modifié des données de mosaïque pouvant être écrasées.

Utilisation

Syntaxe

SynchronizeMosaicDataset_management (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})
ParamètreExplicationType de données
in_mosaic_dataset

Chemin et nom de la mosaïque.

Mosaic Layer
where_clause
(Facultatif)

A l'aide du SQL, vous pouvez définir une requête ou utiliser le Générateur de requêtes pour créer une requête.

SQL Expression
new_items
(Facultatif)

Choisissez s'il faut synchroniser votre mosaïque avec les éléments ajoutés récemment. Si vous choisissez cette option, la recherche porte sur les nouvelles données dans l'espace de travail de l'élément. 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é.

Si vous optez pour la mise à jour avec les nouveaux éléments, vous pouvez choisir de mettre à jour les plages de tailles de cellules, une limite ou des vues d'ensemble.

  • NO_NEW_ITEMSAucun nouvel élément n'est ajouté. Il s'agit de l'option par défaut.
  • UPDATE_WITH_NEW_ITEMSPermet de mettre à jour la mosaïque avec les nouveaux éléments dans les espaces de travail où sont stockés les éléments de mosaïque existants.
Boolean
sync_only_stale
(Facultatif)

Choisissez s'il faut mettre à jour tous les principaux éléments ou uniquement ceux qui sont obsolètes.

Un élément est considéré comme obsolète si les fichiers source correspondants utilisés pour construire les valeurs raster sont modifiés après la création de l'élément. Il se peut, par exemple, que le géoréférencement ait été mis à jour ou que des pyramides aient été construites.

  • SYNC_STALEPermet de mettre à jour uniquement les éléments obsolètes. Il s'agit de l'option par défaut.
  • SYNC_ALLPermet de mettre à jour tous les éléments sélectionnés de la mosaïque.
Boolean
update_cellsize_ranges
(Facultatif)

Choisissez s'il faut mettre à jour les plages de tailles de cellules.

  • UPDATE_CELL_SIZESLes plages de tailles de cellules sont recalculées pour toute la mosaïque, mais seuls les éléments dont la visibilité est incorrecte sont mis à jour. Il s'agit de l'option par défaut.
  • NO_CELL_SIZES Les plages de tailles de cellules ne sont pas recalculées.
Boolean
update_boundary
(Facultatif)

Choisissez s'il faut mettre à jour la limite.

  • UPDATE_BOUNDARY La limite est régénérée après la synchronisation de la mosaïque. Il s'agit de l'option par défaut.
  • NO_BOUNDARY La limite n'est pas régénérée.
Boolean
update_overviews
(Facultatif)

Choisissez s'il faut mettre à jour les vues d'ensemble obsolètes. La vue d'ensemble devient obsolète si des rasters sous-jacents ont été modifiés.

  • NO_OVERVIEWS Les vues d'ensemble ne sont pas régénérées. Il s'agit de l'option par défaut.
  • UPDATE_OVERVIEWS Les vues d'ensemble affectées sont régénérées après la synchronisation de la mosaïque.
Boolean
build_pyramids
(Facultatif)

Choisissez s'il faut construire des pyramides pour les éléments de 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é.

  • NO_PYRAMIDSAucune pyramide n'est générée. Il s'agit de l'option par défaut.
  • BUILD_PYRAMIDS Des pyramides sont générées pour tous les éléments raster spécifiés par cet outil.

Aucune pyramide n'est construite pour les nouveaux éléments qui sont ajoutés dans la même instance d'exécution de cet outil.

Boolean
calculate_statistics
(Facultatif)

Choisissez s'il faut calculer les statistiques pour les éléments de mosaïque spécifiés. Des statistiques peuvent être calculées pour chaque élément raster de la mosaïque. Les statistiques sont obligatoires pour effectuer certaines tâches avec votre mosaïque, par exemple appliquer un étirement de contraste.

  • NO_STATISTICSLes statistiques ne sont pas calculées. Il s'agit de l'option par défaut.
  • CALCULATE_STATISTICS Les statistiques sont calculées pour tous les éléments raster spécifiés par cet outil.

Aucune statistique n'est générée pour les nouveaux éléments qui sont ajoutés dans la même instance d'exécution de cet outil.

Boolean
build_thumbnails
(Facultatif)

Choisissez s'il faut créer des miniatures pour les éléments de 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 disponibles lorsque vous accédez à la mosaïque en tant que service d'imagerie et s'affichent avec les métadonnées (Description d'élément).

  • NO_THUMBNAILSAucune miniature n'est créée ou mise à jour. Il s'agit de l'option par défaut.
  • BUILD_THUMBNAILSDes miniatures sont générées ou mises à jour pour tous les éléments raster spécifiés par cet outil.

Aucune miniature n'est créée pour les nouveaux éléments qui sont ajoutés dans la même instance d'exécution de cet outil.

Boolean
build_item_cache
(Facultatif)

Choisissez s'il faut construire un cache pour les éléments de mosaïque spécifiés. Vous pouvez créer un cache lorsque vous avez ajouté des données à l'aide des types de raster LAS, MNT ou Jeu de données LAS. La fonction Raster en cache permet également de les mettre en cache.

  • NO_ITEM_CACHEAucun cache n'est créé ni mis à jour. Il s'agit de l'option par défaut.
  • BUILD_ITEM_CACHELe cache est généré ou mis à jour pour tous les éléments raster spécifiés par cet outil.

Aucun cache n'est généré pour les nouveaux éléments qui sont ajoutés dans la même instance d'exécution de cet outil.

Boolean
rebuild_raster
(Facultatif)

Choisissez s'il faut régénérer les éléments raster à partir de la source de données à l'aide du type de raster d'origine.

  • REBUILD_RASTERPermet de régénérer les rasters à partir des données source. Toutes les modifications apportées aux éléments sélectionnés dans la mosaïque sont perdues. Il s'agit de l'option par défaut.
  • NO_RASTERLes rasters ne sont pas régénérés. Les autres champs principaux sont réinitialisés si l'option update_aux_fields est sélectionnée.

Cela ne concerne que les éléments qui seront synchronisés. Ce paramètre ne s'applique pas si UPDATE_WITH_NEW_ITEMS a été sélectionné.

Boolean
update_fields
(Facultatif)

Choisissez s'il faut mettre à jour les champs de la table. Cela ne concerne que les éléments qui seront synchronisés.

  • UPDATE_FIELDSPermet de mettre à jour les champs à partir des fichiers source. Il s'agit de l'option par défaut.
  • NO_FIELDSLes champs de la table ne sont pas réinitialisés à partir de la source.

Si vous choisissez la mise à jour des champs, vous pouvez déterminer ceux que vous voulez mettre à jour en les sélectionnant dans le paramètre fields_to_update. Si vous avez mis certains champs à jour, vous pouvez les désélectionner dans le paramètre fields_to_update.

Boolean
fields_to_update
[field_to_update,...]
(Facultatif)

Spécifiez les 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, assurez-vous qu'ils ne sont pas répertoriés dans la liste.

La colonne RASTER peut être actualisée, même si le mot-clé REBUILD_RASTER n'est pas utilisé. Mais si REBUILD_RASTER est utilisé, la colonne RASTER est régénérée, même si ce champ n'est pas spécifié.

String
existing_items
(Facultatif)

Indiquez si vous souhaitez mettre à jour les éléments de votre mosaïque.

Si vous choisissez cette option, vous pouvez ensuite spécifier les paramètres que vous souhaitez mettre à jour : sync_only_stale, build_pyramids, calculate_statistics, build_thumbnails, build_item_cache, update_raster, update_fields ou fields_to_update.

  • UPDATE_EXISTING_ITEMSLes éléments existants sont mis à jour avec les paramètres que vous avez choisis de mettre à jour. Il s'agit de l'option par défaut.
  • IGNORE_EXISTING_ITEMSLes éléments existants ne sont pas mis à jour.
Boolean
broken_items
(Facultatif)

Indiquez si vous souhaitez supprimer les liens rompus.

Assurez-vous que toutes vos connexions réseau sont opérationnelles. Cet outil supprimera tout élément auquel il est impossible d'accéder.

  • IGNORE_BROKEN_ITEMSLes éléments présentant des liens rompus ne sont pas supprimés de la mosaïque. Il s'agit de l'option par défaut.
  • REMOVE_BROKEN_ITEMSLes éléments présentant des liens rompus sont supprimés de la mosaïque.
Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil SynchronizeMosaicDataset (fenêtre Python)

Il s'agit d"un exemple en Python d'utilisation de l'outil 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 en Python d'utilisation de l'outil SynchronizeMosaicDataset.

#============================
#Synchronize Mosaic Dataset
'''Usage: SynchronizeMosaicDataset_management(in_mosaic_dataset, {where_clause}, {NO_NEW_ITEMS |
                                              UPDATE_WITH_NEW_ITEMS}, {SYNC_STALE | SYNC_ALL},
                                              {UPDATE_CELL_SIZES | NO_CELL_SIZES}, {UPDATE_BOUNDARY |
                                              NO_BOUNDARY}, {NO_OVERVIEWS | UPDATE_OVERVIEWS},
                                              {NO_PYRAMIDS | BUILD_PYRAMIDS}, {NO_STATISTICS |
                                              CALCULATE_STATISTICS}, {NO_THUMBNAILS |
                                              BUILD_THUMBNAILS}, {NO_ITEM_CACHE | BUILD_ITEM_CACHE},
                                              {UPDATE_RASTER | NO_RASTER}, {UPDATE_FIELDS | NO_FIELDS},
                                              {fields_to_update;fields_to_update...},
                                              {UPDATE_EXISTING_ITEMS | IGNORE_EXISTING_ITEMS},
                                              {IGNORE_BROKEN_ITEMS | REMOVE_BROKEN_ITEMS})
'''

try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"

    # Synchronize source and add new data
    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)

    # Synchronize data item after Year 1999
    # Add new data if available from the source
    # Do not update fields from source raster
    mdname = "syncmd.gdb/md"
    query = "Year>1999"
    updatenew = "NO_NEW_ITEMS"
    syncstale = "SYNC_STALE"
    updatecs = "#"
    updatebnd = "#"
    updateovr = "#"
    buildpy = "#"
    calcstats = "#"
    buildthumb = "BUILD_THUMBNAILS"
    buildcache = "#"
    updateras = "NO_RASTER"
    updatefield = "NO_FIELDS"
    fields = "#"

    arcpy.SynchronizeMosaicDataset_management(mdname, query, updatenew, syncstale,
                                              updatecs, updatebnd, updateovr, buildpy,
                                              calcstats, buildthumb, buildcache,
                                              updateras, updatefield, fields)


    # Synchronize LAS mosaic dataset and build cache
    # Rebuild raster item from source data and do not update Point Spacing
    mdname = "syncmd.gdb/lasmd"
    query = "#"
    updatenew = "NO_NEW_ITEMS"
    syncstale = "SYNC_ALL"
    updatecs = "#"
    updatebnd = "#"
    updateovr = "#"
    buildpy = "#"
    calcstats = "#"
    buildthumb = "BUILD_THUMBNAILS"
    buildcache = "BUILD_ITEM_CACHE"
    updateras = "UPDATE_RASTER"
    updatefield = "UPDATE_FIELDS"
    fields = "PointCount;Version;ZMax;ZMin"

    arcpy.SynchronizeMosaicDataset_management(mdname, query, updatenew, syncstale,
                                              updatecs, updatebnd, updateovr, buildpy,
                                              calcstats, buildthumb, buildcache,
                                              updateras, updatefield, fields)


    # Remove broken items from mosaic dataset
    mdname = "syncmd.gdb/mdbroken"
    query = "#"
    updatenew = "NO_NEW_ITEMS"
    syncstale = "SYNC_STALE"
    updatecs = "#"
    updatebnd = "#"
    updateovr = "#"
    buildpy = "#"
    calcstats = "#"
    buildthumb = "#"
    buildcache = "#"
    updateras = "#"
    updatefield = "#"
    fields = "#"
    updateexist = "IGNORE_EXISTING_ITEMS"
    removebroken = "REMOVE_BROKEN_ITEMS"

    arcpy.SynchronizeMosaicDataset_management(mdname, query, updatenew, syncstale,
                                              updatecs, updatebnd, updateovr, buildpy,
                                              calcstats, buildthumb, buildcache,
                                              updateras, updatefield, fields, updateexist,
                                              removebroken)



except:
    print "Synchronize Mosaic Dataset example failed."
    print arcpy.GetMessages()

Environnements

Thèmes connexes

9/12/2013