Générer les aperçus (Gestion des données)—ArcGIS Pro

Synthèse

Définit et génère des aperçus sur une mosaïque.

Utilisation

Cet outil respecte les paramètres de mosaïque par défaut, les propriétés non définies sur une couche de mosaïque. Par exemple, l'outil n'accepte pas les modifications apportées aux propriétés des couches, telles que le nombre de canaux, la méthode de mosaïquage, l'étendue ou la requête. Ces propriétés sont déterminées par la mosaïque et par ses propriétés par défaut.
Vous devez activer l'option Définir les tuiles d'aperçus manquantes ou Générer les aperçus, ou les deux.
Le premier niveau d'aperçu est créé sur la résolution maximale de la mosaïque. Chaque niveau suivant repose sur le dernier niveau d'aperçu généré.
Pour mieux contrôler la définition des aperçus, utilisez d'abord l'outil Définir les aperçus.
Par défaut, les aperçus générés pour les mosaïques dans une géodatabase fichier sont stockés dans un dossier <gdbname>.Overviews, au même endroit que la géodatabase contenant la mosaïque. Les aperçus générés pour les mosaïques sur la géodatabase d'entreprise sont stockés au sein de la géodatabase contenant la mosaïque. Vous pouvez modifier ces emplacements en utilisant l'outil Définir les aperçus et en indiquant un emplacement.
Vous ne pouvez pas générer d'aperçus pour une mosaïque référencée.

Paramètres

Étiquette	Explication	Type de données
Mosaïque	Mosaïque dans laquelle vous voulez générer les aperçus.	Mosaic Layer
Ensemble de définition (Facultatif)	Instruction SQL permettant de sélectionner certains rasters au sein de la mosaïque. L'aperçu des rasters sélectionnés sera généré.	SQL Expression
Définir les tuiles d'aperçus manquantes (Facultatif)	Identifiez quand les aperçus sont nécessaires et définissez-les. Activé : identifie automatiquement quand les aperçus sont nécessaires et les définit. Il s’agit de l’option par défaut. Désactivé : ne définit aucun nouvel aperçu.	Boolean
Générer les aperçus (Facultatif)	Générez tous les aperçus qui doivent être créés ou recréés. Sont compris les aperçus manquants et obsolètes. Activé : génère tous les aperçus, notamment ceux qui existent déjà. Il s’agit de l’option par défaut. Désactivé : génère uniquement les aperçus qui ont été définis mais pas encore générés.	Boolean
Générer uniquement les images d'aperçu manquantes (Facultatif)	Utilisez cette option si les aperçus ont été définis mais pas générés. Cochée : les aperçus qui ont été définis mais pas encore générés sont créés. Il s’agit de l’option par défaut. Non cochée : les aperçus qui ont été définis mais pas encore générés ne sont pas créés.	Boolean
Générer uniquement les images d'aperçus obsolètes (Facultatif)	Les aperçus deviennent obsolètes lorsque vous modifiez les jeux de données raster sous-jacents ou leurs propriétés. Activé : identifie et régénère les aperçus obsolètes. Il s’agit de l’option par défaut. Désactivé : ne régénère pas les aperçus obsolètes.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Mosaïque mise à jour	Jeu de données mosaïque mis à jour.	Couche de mosaïque

arcpy.management.BuildOverviews(in_mosaic_dataset, {where_clause}, {define_missing_tiles}, {generate_overviews}, {generate_missing_images}, {regenerate_stale_images})

Nom	Explication	Type de données
in_mosaic_dataset	Mosaïque dans laquelle vous voulez générer les aperçus.	Mosaic Layer
where_clause (Facultatif)	Instruction SQL permettant de sélectionner certains rasters au sein de la mosaïque. L'aperçu des rasters sélectionnés sera généré.	SQL Expression
define_missing_tiles (Facultatif)	Identifiez quand les aperçus sont nécessaires et définissez-les. DEFINE_MISSING_TILES—Identifie automatiquement quand les aperçus sont nécessaires et les définit. Il s’agit de l’option par défaut. NO_DEFINE_MISSING_TILES— Ne définit aucun nouvel aperçu.	Boolean
generate_overviews (Facultatif)	Générez tous les aperçus qui doivent être créés ou recréés. Sont compris les aperçus manquants et obsolètes. GENERATE_OVERVIEWS—Génère tous les aperçus, notamment ceux qui existent déjà. Il s’agit de l’option par défaut. NO_GENERATE_OVERVIEWS—Génère uniquement les aperçus qui ont été définis mais pas encore générés.	Boolean
generate_missing_images (Facultatif)	Utilisez cette option si les aperçus ont été définis mais pas générés. GENERATE_MISSING_IMAGES—Génère les aperçus qui ont été définis mais pas encore générés. Il s’agit de l’option par défaut. IGNORE_MISSING_IMAGES— Ne génère pas les aperçus qui ont été définis mais pas encore générés.	Boolean
regenerate_stale_images (Facultatif)	Les aperçus deviennent obsolètes lorsque vous modifiez les jeux de données raster sous-jacents ou leurs propriétés. REGENERATE_STALE_IMAGES—Identifie et régénère les aperçus obsolètes. Il s’agit de l’option par défaut. IGNORE_STALE_IMAGES— Ne régénère pas les aperçus obsolètes.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_mosaic_dataset	Jeu de données mosaïque mis à jour.	Couche de mosaïque

Exemple de code

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

Il s'agit d'un exemple de script Python pour BuildOverviews.

import arcpy
arcpy.BuildOverviews_management(
     "C:/Workspace/Overviews.gdb/md", "OBJECTID<5", "DEFINE_MISSING_TILES", 
     "NO_GENERATE_OVERVIEWS", "IGNORE_MISSING_IMAGES", "IGNORE_STALE_IMAGES")

Exemple 2 d'utilisation de l'outil BuildOverviews (script autonome)

Ceci est un exemple de script Python pour BuildOverviews.

# Define Overviews for selected items only

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

    
arcpy.BuildOverviews_management("Overviews.gdb/md", "OBJECTID<5", 
                                "DEFINE_MISSING_TILES",
                                "NO_GENERATE_OVERVIEWS", "#", "#")