Générer la structure pyramidale (Gestion des données)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Crée des pyramides raster pour un jeu de données raster.

Cet outil permet également de supprimer des pyramides. Pour supprimer des pyramides, attribuez la valeur 0 au paramètre Niveaux de pyramides.

Illustration

Générer la structure pyramidale

Utilisation

Syntaxe

BuildPyramids_management (in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
ParamètreExplicationType de données
in_raster_dataset

Jeu de données raster en entrée.

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 de 29. Les valeurs supérieures ou égales à 30 retourneront à 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.

  • NONELe premier niveau de la pyramide est créé. Il s'agit de l'option par défaut.
  • SKIP_FIRSTLe premier niveau de la pyramide n'est pas créé.
Boolean
resample_technique
(Facultatif)

Méthode de rééchantillonnage utilisée pour créer vos pyramides.

  • NEARESTLa méthode de rééchantillonnage du voisin le plus proche utilise la valeur de la cellule la plus proche pour affecter une valeur à la cellule en sortie lors du rééchantillonnage. Il s'agit de l'option par défaut.
  • BILINEARLa méthode de rééchantillonnage interpolation bilinéaire détermine la nouvelle valeur d'une cellule en fonction d'une distance moyenne pondérée des valeurs des centres des quatre cellules en entrée les plus proches.
  • CUBICLa méthode de rééchantillonnage de convolution cubique détermine la nouvelle valeur d'une cellule en ajustant une courbe lissée suivant les valeurs des centres des 16 cellules en entrée les plus proches.
String
compression_type
(Facultatif)

Type de compression à utiliser lors de la création de pyramides raster.

  • DEFAUTSi les données source sont compressées à l'aide d'une compression par ondelettes, des pyramides sont créées avec la compression de type JPEG ; sinon, la compression LZ77 est utilisée. Il s'agit de la méthode de compression par défaut.
  • LZ77L'algorithme de compression LZ77 est utilisé pour créer les pyramides. La méthode LZ77 peut être appliquée à tout type de données.
  • JPEGL'algorithme de compression JPEG est utilisé pour créer les pyramides. Ce type de compression ne s'applique qu'aux données conformes à la spécification de compression JPEG. Si vous choisissez JPEG, vous pouvez également définir la qualité de compression.
  • JPEG_YCbCrCompression avec perte utilisant les composants d'espace de couleur de luminance (Y) et de chrominance (Cb et Cr).
  • NONELes pyramides sont créées sans compression.
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.

  • OVERWRITELes pyramides sont créées même si elles existent déjà. Par conséquent, les pyramides existantes sont écrasées. Il s'agit de l'option par défaut.
  • SKIP_EXISTINGLes pyramides sont créées uniquement si elles n'existent pas déjà.
Boolean

Exemple de code

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

Ceci est un exemple Python pour BuildPyramids.

import arcpy
arcpy.BuildPyramids_management(
     "C:/data/image.tif", "3", "NONE", 
     "BILINEAR", "JPEG", "50", "SKIP_EXISTING")
Exemple 2 d'utilisation de l'outil BuildPyramids (fenêtre autonome)

Ceci est un exemple de script Python pour BuildPyramids.

#Build Pyramids for single Raster Dataset
#Define the type and compression of pyramids in the tool
#Skip if dataset already has pyramids

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

inras = "image.tif"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BuildPyramids_management(inras, pylevel, skipfirst, resample, 
                               compress, quality, skipexist)

Environnements

Pyramid

Le niveau de pyramide, la compression pyramidale et la méthode de rééchantillonnage ne s'appliquent pas au format IMG.

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Oui
ArcGIS for Desktop Standard: Oui
ArcGIS for Desktop Advanced: Oui
6/5/2014