Résumé
Crée des pyramides raster pour votre jeu de données raster.
Cet outil permet également de supprimer des pyramides. Pour supprimer des pyramides, attribuez la valeur 0 au paramètre Pyramids Levels (Niveaux de pyramides).
Illustration
Utilisation
La création de pyramids améliore les performances d'affichage des jeux de données raster.
Vous n'avez à générer les pyramides qu'une seule fois par jeu de données. Les pyramides sont utilisées à chaque fois que vous affichez le jeu de données raster.
Les pyramides ne sont pas créées pour les jeux de données raster ayant moins de 1 024 pixels dans l'enregistrement ou la colonne. Les pyramides ne sont pas nécessaires puisque le jeu de données raster est suffisamment petit, et la création de pyramides ne contribue pas à augmenter les performances.
Il n'est pas nécessaire de créer des pyramides pour les jeux de données raster compressés par ondelettes, tels que ECW et MrSID. Ces formats ont des pyramides internes créées au moment du codage.
Vous pouvez choisir le type de compression pour votre fichier de pyramide vue d'ensemble, dans les paramètres d'environnement de stockage de données raster. La compression crée un plus petit fichier .ovr. Le format IMAGINE et d'anciennes versions d'ArcGIS créent des fichiers de jeu de données (.rrd) de résolution réduite, pour lesquels la compression n'est pas disponible.
La compression de pyramide par défaut utilise le type de compression optimal en fonction du type de données. Vous pouvez choisir manuellement la méthode LZ77, JPEG ou aucune compression.
La compression JPEG peut être utilisée uniquement avec les formats de fichier qui peuvent stocker les données selon les spécifications JPEG. La rubrique Formats de fichier pris en charge pour les jeux de données raster répertorie les spécifications prises en charge par le format JPEG.
Syntaxe
arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})| Paramètre | Explication | Type de données |
in_raster_dataset | Le jeu de données raster pour lequel vous souhaitez créer des pyramides. L'entrée doit avoir plus de 1024 enregistrements et 1024 colonnes. | Raster Dataset; Raster Layer |
pyramid_level (Facultatif) | Choisissez le nombre de couches de jeux de données à faible résolution devant être créées. La valeur par défaut est -1, laquelle permet de créer des pyramides complètes. La valeur 0 correspond à aucun niveau de pyramide. Pour supprimer des pyramides, attribuez la valeur 0 au nombre de niveaux. Le nombre maximal de niveaux de pyramide que vous pouvez spécifier est 29. Les valeurs supérieures ou égales à 30 reviendront à la valeur -1, ce qui créera un ensemble complet de pyramides. | Long |
SKIP_FIRST (Facultatif) | Choisissez si vous souhaitez ignorer le premier niveau de la pyramide. En ignorant le premier niveau, vous sollicitez un peu moins d'espace disque, mais les performances sont ralenties à ces échelles.
| Boolean |
resample_technique (Facultatif) | Méthode de rééchantillonnage utilisée pour créer vos pyramides.
| String |
compression_type (Facultatif) | Type de compression à utiliser lors de la création de pyramides raster.
| String |
compression_quality (Facultatif) | Qualité de compression à appliquer lors de la création de pyramides avec la méthode de compression JPEG. La valeur doit être comprise entre 0 et 100. Les valeurs plus proches de 100 produisent une image de qualité supérieure, mais le taux de compression est inférieur. | Long |
skip_existing (Facultatif) | Spécifiez s'il convient de créer des pyramides uniquement lorsqu'elles sont manquantes ou de les régénérer même si elles existent.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| out_raster | Jeu de données raster en sortie. | Jeu de données raster |
Exemple de code
Exemple 1 d'utilisation de l'outil BuildPyramids (fenêtre Python)
Il s’agit d'un exemple Python d'utilisation de l'outil BuildPyramids.
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
Exemple 2 d’utilisation de l’outil BuildPyramids (script autonome)
Il s’agit d'un exemple de script Python d'utilisation de l'outil BuildPyramids.
#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BatchBuildPyramids_management(
inras, pylevels, skipfirst, resample, compress,
quality, skipexist)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui