Résumé
Permet de définir comment générer les vues d'ensemble des mosaïques. Les paramètres sélectionnés à l’aide de cet outil sont utilisés par l’outil Générer les aperçus.
Utilisation
Cet outil est utilisé lorsque vous devez définir des paramètres spécifiques pour générer vos vues d'ensemble, tels que
- Définition de l'emplacement vers lequel écrire les fichiers
- Définition d'une étendue différente de la limite
- Définition des propriétés des images de vue d'ensemble, telles que les méthodes de rééchantillonnage ou de compression
- Définition de la vue d'ensemble du facteur d'échantillonnage
Utilisez l'outil Générer les aperçus pour générer les aperçus une fois définis avec cet outil.
Vous pouvez utiliser une classe d'entités surfaciques pour définir l'emprise de la vue d'ensemble. Si vous ne voulez pas utiliser tous les polygones de la classe d’entités, vous pouvez effectuer une sélection dans la couche de la table des matières ou utiliser un outil tel que Sélectionner une couche par attributs ou Sélectionner une couche par emplacement pour sélectionner les polygones souhaités.
La taille de tuile par défaut est 128 par 128. La taille de tuile peut être modifiée dans les paramètres d'environnement.
L'exécution de cet outil peut être longue si la limite contient un grand nombre de sommets.
Syntaxe
arcpy.management.DefineOverviews(in_mosaic_dataset, {overview_image_folder}, {in_template_dataset}, {extent}, {pixel_size}, {number_of_levels}, {tile_rows}, {tile_cols}, {overview_factor}, {force_overview_tiles}, {resampling_method}, {compression_method}, {compression_quality})| Paramètre | Explication | Type de données |
in_mosaic_dataset | Mosaïque dans laquelle vous voulez générer les vues d'ensemble. | Mosaic Layer |
overview_image_folder (Facultatif) | Dossier ou géodatabase où stocker les vues d'ensemble. | Workspace |
in_template_dataset (Facultatif) | Jeu de données raster ou classe d'entités utilisés pour définir l'étendue des vues d'ensemble. | Raster Layer; Feature Layer |
extent (Facultatif) | Définissez l'étendue à l'aide des coordonnées x et y minimales et maximales. Elle est spécifié comme espace délimité dans l'ordre suivant : x-minimum x-maximum y-minimum y-maximum. La limite de la mosaïque va permettre de déterminer l'étendue des vues d'ensemble si vous ne définissez aucune étendue. | Envelope |
pixel_size (Facultatif) | Si vous préférez ne pas utiliser toutes les pyramides du raster, spécifiez une taille de pixel de base à laquelle vos vues d'ensemble seront générées. Les unités de ce paramètre sont identiques à celles de la référence spatiale de la mosaïque. | Double |
number_of_levels (Facultatif) | Spécifiez le nombre de niveaux de vues d'ensemble qui vont être générés. La valeur -1 détermine automatiquement une valeur optimale. | Long |
tile_rows (Facultatif) | Définissez le nombre de lignes (en pixels) pour chaque tuile. Si vous utilisez des valeurs plus élevées, les vues d'ensemble seront moins nombreuses mais plus volumineuses. En outre, vous devrez probablement régénérer des vues d'ensemble de niveau inférieur. En revanche, si vous spécifiez une valeur inférieure, vous obtiendrez davantage de fichiers moins volumineux. | Long |
tile_cols (Facultatif) | Définissez le nombre de colonnes (en pixels) pour chaque tuile. Si vous utilisez des valeurs plus élevées, les vues d'ensemble seront moins nombreuses mais plus volumineuses. En outre, vous devrez probablement régénérer des vues d'ensemble de niveau inférieur. En revanche, si vous spécifiez une valeur inférieure, vous obtiendrez davantage de fichiers moins volumineux. | Long |
overview_factor (Facultatif) | Définissez un ratio pour déterminer la taille de la prochaine vue d'ensemble. Par exemple, si la taille de cellule du premier niveau est égale à 10 et que le facteur d'aperçu est de 3, alors la taille de pixel de la prochaine vue d'ensemble sera de 30. | Long |
force_overview_tiles (Facultatif) | Génère des vues d'ensemble à tous les niveaux ou uniquement à des niveaux supérieurs aux niveaux de pyramides existants.
| Boolean |
resampling_method (Facultatif) | Choisissez un algorithme pour agréger les valeurs de pixel dans les vues d'ensemble.
| String |
compression_method (Facultatif) | Définit le type de compression des données pour stocker les images de vue d'ensemble.
| String |
compression_quality (Facultatif) | Choisissez une valeur comprise entre 1 et 100. Les valeurs plus élevées génèrent des sorties de meilleure qualité, mais elles créent des fichiers plus volumineux. | Long |
Sortie dérivée
| 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 DefineOverviews (fenêtre Python)
Il s'agit d'un exemple de script Python pour DefineOverviews.
import arcpy
arcpy.DefineOverviews_management("c:/workspace/fgdb.gdb/md01",
"c:/temp", "#", "#", "30", "6", "4000",
"4000", "2", "CUBIC", "JPEG", "50")
Exemple 2 d'utilisation de l'outil DefineOverviews (script autonome)
Ceci est un exemple de script Python pour DefineOverviews.
#Define Overviews to the default location
#Define Overviews for all levels - ignore the primary Raster pyramid
#Define Overviews compression and resampling method
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.DefineOverviews_management("DefineOVR.gdb/md", "#", "#", "#", "#",
"#", "#", "#", "#", "FORCE_OVERVIEW_TILES",
"BILINEAR", "JPEG", "50")
Environnements
Informations de licence
- Basic: Non
- Standard: Oui
- Advanced: Oui