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

Résumé

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

Utilisation

  • La création de pyramids améliore les performances d'affichage des jeux de données raster.

  • La création de pyramides par lots est utile lorsque vous avez un grand répertoire de jeux de données raster qui n'ont pas de pyramides ou pour créer des pyramides sur les éléments d'une mosaïque (faites-les glisser dans la boîte de dialogue).

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

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

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

Syntaxe

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

Jeux de données raster pour lesquels vous souhaitez créer des pyramides raster.

Chacun entrée doit avoir plus de 1024 enregistrements et 1024 colonnes.

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

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

Type de compression à utiliser 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 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.
  • 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

Sortie dérivée

NomExplicationType de données
Batch_Build_Pyramids_Succeeded

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

Booléen

Exemple de code

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

Il s’agit d'un exemple Python d'utilisation de l'outil 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 l'outil BatchBuildPyramids (script autonome)

Il s’agit d'un exemple de script Python d'utilisation de l'outil 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

Pyramide

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

Informations de licence

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

Rubriques connexes