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

Synthèse

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

Générer la structure pyramidale

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 liste des formats de fichier de jeu de données raster pris en charge indique quelle spécification est prise en charge par le format JPEG.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données raster en entrée

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
Niveaux de pyramides
(Facultatif)

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
Passer le premier niveau
(Facultatif)

Indique si le premier niveau de la pyramide sera ignoré. En ignorant le premier niveau, vous sollicitez un peu moins d'espace disque, mais les performances sont ralenties à ces échelles.

  • Désactivé : le premier niveau de la pyramide n’est pas ignoré ; il sera créé. Il s’agit de l’option par défaut.
  • Activé : le premier niveau de la pyramide sera ignoré ; il ne sera pas créé.

Boolean
Technique de rééchantillonnage des pyramides
(Facultatif)

Indique la technique de rééchantillonnage qui sera utilisée pour créer les pyramides.

  • La plus procheLa valeur du pixel le plus proche sera utilisée pour affecter une valeur au pixel en sortie lors du rééchantillonnage. Il s’agit de l’option par défaut.
  • BilinéaireLa nouvelle valeur d’un pixel sera basée sur la distance moyenne pondérée des valeurs des centres des quatre pixels en entrée les plus proches.
  • CubiqueLa nouvelle valeur d’un pixel sera basée sur l’action de faire passer une courbe lissée par les centres des 16 pixels en entrée les plus proches.
String
Type de compression pyramidale
(Facultatif)

Spécifie le type de compression qui est utilisé lors de la création de pyramides raster.

  • Par défautSi 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 des 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.
  • Luminance et chrominance JpegUne compression avec perte utilisant les composants d’espace de couleur de luminance (Y) et de chrominance (Cb et Cr) est utilisée pour créer des pyramides.
  • Aucune compression.Les pyramides sont créées sans compression.
String
Qualité de compression (1-100)
(Facultatif)

La qualité de compression est appliquée lors de la création de pyramides avec le type 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
Passer l'élément existant
(Facultatif)

Spécifie si les pyramides seront créées uniquement lorsqu’elles sont manquantes ou si elles seront régénérées même si elles existent.

  • Désactivé : les pyramides sont créées même si elles existent déjà, et les pyramides existantes vont être remplacées. Il s’agit de l’option par défaut.
  • Activée : les pyramides sont créées uniquement si elles n'existent pas déjà.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en entrée mis à jour

Jeu de données raster en sortie.

Jeu de données raster

arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
NomExplicationType 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)

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)

Indique si le premier niveau de la pyramide sera ignoré. 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 n’est pas ignoré ; il sera créé. Il s’agit de l’option par défaut.
  • SKIP_FIRSTLe premier niveau de la pyramide sera ignoré ; il ne sera pas créé.
Boolean
resample_technique
(Facultatif)

Indique la technique de rééchantillonnage qui sera utilisée pour créer les pyramides.

  • NEARESTLa valeur du pixel le plus proche sera utilisée pour affecter une valeur au pixel en sortie lors du rééchantillonnage. Il s’agit de l’option par défaut.
  • BILINEARLa nouvelle valeur d’un pixel sera basée sur la distance moyenne pondérée des valeurs des centres des quatre pixels en entrée les plus proches.
  • CUBICLa nouvelle valeur d’un pixel sera basée sur l’action de faire passer une courbe lissée par les centres des 16 pixels en entrée les plus proches.
String
compression_type
(Facultatif)

Spécifie le type de compression qui est utilisé lors de la création de pyramides raster.

  • DEFAULTSi 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 des 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_YCbCrUne compression avec perte utilisant les composants d’espace de couleur de luminance (Y) et de chrominance (Cb et Cr) est utilisée pour créer des pyramides.
  • NONELes pyramides sont créées sans compression.
String
compression_quality
(Facultatif)

La qualité de compression est appliquée lors de la création de pyramides avec le type 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écifie si les pyramides seront créées uniquement lorsqu’elles sont manquantes ou si elles seront régénérées même si elles existent.

  • OVERWRITELes pyramides sont créées même si elles existent déjà, et les pyramides existantes vont être remplacé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

Sortie obtenue

NomExplicationType 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

Cas particuliers

Pyramide

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

Facteur de traitement parallèle

Uniquement pris en charge pour le format CRF.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes