Créer des pyramides par lot (Gestion des données)

Synthèse

Crée des pyramides pour plusieurs jeux de données raster.

Utilisation

  • La création de pyramides par lot est utile lorsque vous disposez d’un grand répertoire de jeux de données raster dépourvus de pyramides.

  • 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, JPEG2000 et MrSID. Ces formats ont des pyramides internes créées au moment du codage.

  • 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 sont inutiles puisque le jeu de données raster est suffisamment petit : la création de pyramides ne contribue pas à améliorer les performances.

  • Vous pouvez choisir un type de compression pour le fichier de pyramide vue d’ensemble, dans les environnements 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) à 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.

Paramètres

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

Jeux de données raster pour lesquels les pyramides raster vont être créées.

Chaque entrée doit comporter plus de 1024 lignes et 1024 colonnes.

Raster Dataset
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.

Long
Ignorer 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 méthode de rééchantillonnage utilisée pour construire les pyramides.

  • NEARESTLa nouvelle valeur d’une cellule dépend de la cellule la plus proche lors du rééchantillonnage. Il s’agit de l’option par défaut.
  • BILINEARLa nouvelle valeur d’une cellule dépend de la distance moyenne pondérée des valeurs des centres des quatre cellules en entrée les plus proches.
  • CUBICLa nouvelle valeur d’une cellule est déterminée par l’ajustement d’une courbe lissée suivant les valeurs des centres des 16 cellules en entrée les plus proches.
String
Type de compression pyramidale
(Facultatif)

Indique le type de compression à utiliser lors de la construction des pyramides.

  • DEFAULTSi les données source sont compressées à l’aide d’une compression par ondelettes, les pyramides sont construites avec une compression de type JPEG. Sinon, la compression LZ77 est utilisée. Il s’agit de l’option 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 la création 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.
  • NONELes pyramides sont créées sans compression.
String
Qualité de compression
(Facultatif)

La qualité de compression qui est utilisé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)

Indique si les pyramides sont créées uniquement si elles n’existent pas ou même si elles existent déjà.

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

Sortie obtenue

ÉtiquetteExplicationType de données
Construction des pyramides par lot réussie

Indique si l’outil a réussi ou non.

Boolean

arcpy.management.BatchBuildPyramids(Input_Raster_Datasets, {Pyramid_levels}, {Skip_first_level}, {Pyramid_resampling_technique}, {Pyramid_compression_type}, {Compression_quality}, {Skip_Existing})
NomExplicationType de données
Input_Raster_Datasets
[Input_Raster_Datasets,...]

Jeux de données raster pour lesquels les pyramides raster vont être créées.

Chaque entrée doit comporter plus de 1024 lignes et 1024 colonnes.

Raster Dataset
Pyramid_levels
(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.

Long
Skip_first_level
(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
Pyramid_resampling_technique
(Facultatif)

Indique la méthode de rééchantillonnage utilisée pour construire les pyramides.

  • NEARESTLa nouvelle valeur d’une cellule dépend de la cellule la plus proche lors du rééchantillonnage. Il s’agit de l’option par défaut.
  • BILINEARLa nouvelle valeur d’une cellule dépend de la distance moyenne pondérée des valeurs des centres des quatre cellules en entrée les plus proches.
  • CUBICLa nouvelle valeur d’une cellule est déterminée par l’ajustement d’une courbe lissée suivant les valeurs des centres des 16 cellules en entrée les plus proches.
String
Pyramid_compression_type
(Facultatif)

Indique le type de compression à utiliser lors de la construction des pyramides.

  • DEFAULTSi les données source sont compressées à l’aide d’une compression par ondelettes, les pyramides sont construites avec une compression de type JPEG. Sinon, la compression LZ77 est utilisée. Il s’agit de l’option 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 la création 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.
  • NONELes pyramides sont créées sans compression.
String
Compression_quality
(Facultatif)

La qualité de compression qui est utilisé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)

Indique si les pyramides sont créées uniquement si elles n’existent pas ou même si elles existent déjà.

  • OVERWRITELes pyramides sont construites même si elles existent déjà et 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 et les pyramides existantes sont ignorées.
Boolean

Sortie obtenue

NomExplicationType de données
Batch_Build_Pyramids_Succeeded

Indique si l’outil a réussi ou non.

Boolean

Exemple de code

Exemple 1 d'utilisation de la fonction BatchBuildPyramids (fenêtre Python)

Il s’agit d’un exemple Python d’utilisation de la fonction BatchBuildPyramids.

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 la fonction BatchBuildPyramids (script autonome)

Il s’agit d’un exemple de script Python d’utilisation de la fonction BatchBuildPyramids.

#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.

Rubriques connexes