Aide

Construire des pyramides et des statistiques

Récapitulatif

Parcourt une structure de dossiers, en créant des pyramides et en calculant des statistiques pour tous les jeux de données raster qu'il contient. Cet outil peut également créer des pyramides et calculer les statistiques de tous les éléments d'une mosaïque.

Utilisation

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

  • Le calcul des statistiques permet aux applications ArcGIS d'étirer et de symboliser correctement les données raster à afficher.

  • Tous les formats raster pris en charge seront traités.

  • Les catalogues d'images et mosaïques doivent être spécifiés en tant qu'espace de travail en entrée. Si l'espace de travail inclut un catalogue d'images ou une mosaïque, ces éléments ne seront pas inclus lors de l'exécution de l'outil.

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

Syntaxe

BuildPyramidsAndStatistics_management (in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
ParamètreExplicationType de données
in_workspace

Espace de travail contenant tous les jeux de données raster à traiter, une mosaïque ou un catalogue d'images.

Si l'espace de travail inclut un catalogue d'images ou une mosaïque, ces éléments ne seront pas inclus lors de l'exécution de l'outil.

Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace
include_subdirectories
(Facultatif)

Spécifiez s'il faut inclure les sous-répertoires.

  • NONE —N'inclut pas les sous-répertoires.
  • INCLUDE_SUBDIRECTORIES —Inclut tous les jeux de données raster contenus dans les sous-répertoires lors du chargement. Il s'agit de l'option par défaut.

Les catalogues d'images et mosaïques doivent être spécifiés en tant qu'espace de travail en entrée. Si l'espace de travail inclut un catalogue d'images ou une mosaïque, ces éléments ne seront pas inclus lors de l'exécution de l'outil.

Boolean
build_pyramids
(Facultatif)

Spécifiez s'il faut créer des pyramides.

  • NONE —Ne crée pas de pyramides.
  • BUILD_PYRAMIDS —Génère les pyramides. Il s'agit de l'option par défaut.
Boolean
calculate_statistics
(Facultatif)

Indiquez si vous souhaitez calculer les statistiques.

  • NONE —Les statistiques ne sont pas calculées.
  • CALCULATE_STATISTICS —Calculez les statistiques. Il s'agit de l'option par défaut.
Boolean
BUILD_ON_SOURCE
(Facultatif)

Spécifiez s'il faut créer des pyramides et calculer des statistiques sur les jeux de données de raster source ou calculer des statistiques sur les éléments raster dans une mosaïque. Cette option s'applique uniquement aux mosaïques.

  • NONE —Les statistiques seront calculées pour chaque élément raster dans la mosaïque (sur chaque enregistrement dans la table attributaire). Toutes fonctions ajoutées à l'élément raster seront appliquées avant de générer les statistiques. Il s'agit de l'option par défaut.
  • BUILD_ON_SOURCE —Crée des pyramides et calcule des statistiques sur les données source de la mosaïque.
Boolean
block_field
(Facultatif)

Nom du champ dans une table attributaire de mosaïques utilisé pour identifier les éléments à prendre en compte lors des calculs et des opérations.

String
estimate_statistics
(Facultatif)

Spécifiez s'il convient de calculer des statistiques pour la mosaïque (pas pour les rasters qu'elle contient). Les statistiques sont dérivées des statistiques existantes calculées pour chaque raster dans la mosaïque.

  • NONE —Les statistiques ne sont pas calculées pour la mosaïque. Il s'agit de l'option par défaut.
  • ESTIMATE_STATISTICS —Les statistiques sont calculées pour la mosaïque.
Boolean
x_skip_factor
(Facultatif)

Nombre de pixels horizontaux entre échantillons.

Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de colonnes du raster. La valeur par défaut est égale à 1 ou au dernier pas d'échantillonnage utilisé.

Long
y_skip_factor
(Facultatif)

Nombre de pixels verticaux entre les échantillons.

Cette valeur doit être supérieure à 0 et inférieure ou égale au nombre de lignes du raster. La valeur par défaut est égale à 1 ou à la valeur du dernier pas d'échantillonnage y utilisé.

Long
ignore_values
[ignore_value,...]
(Facultatif)

Valeurs de pixel à ne pas inclure dans le calcul de statistiques.

Par défaut, aucune valeur n'est définie.

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

Le nombre maximal de niveaux de pyramide que vous pouvez spécifier est de 29. Les valeurs supérieures ou égales à 30 créent 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.

  • NONE —Le premier niveau de la pyramide est créé. Il s'agit de l'option par défaut.
  • SKIP_FIRST —Le 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.

  • NEAREST —La 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.
  • BILINEAR —La 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.
  • CUBIC —La 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.

  • DEFAULT —Si 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.
  • LZ77 —L'algorithme de compression LZ77 est utilisé pour créer les pyramides. La méthode LZ77 peut être appliquée à tout type de données.
  • JPEG —L'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_YCBCR —Compression avec perte utilisant les composants d'espace de couleur de luminance (Y) et de chrominance (Cb et Cr).
  • NONE —Les 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 calculer des statistiques uniquement lorsqu'elles sont manquantes ou de les régénérer même si elles existent.

  • SKIP_EXISTING —Les statistiques ne sont calculées que si elles n'existent pas déjà. Il s'agit de l'option par défaut.
  • OVERWRITE —Les statistiques sont calculées même si elles existent déjà. Par conséquent, les statistiques existantes sont écrasées.
Boolean

Exemple de code

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

Ceci est un exemple Python d'utilisation de l'outil BuildPyramidsAndStatistics.

import arcpy
arcpy.BuildPyramidsAndStatistics_management(
     "C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
     "CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField", 
     "ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
     "BILINEAR", "JPEG", "50", "OVERWRITE")
Exemple 2 d'utilisation de l'outil BuildPyramidsAndStatistics (script autonome)

Ceci est un exemple de script Python d'utilisation de l'outil BuildPyramidsAndStatistics.

#Build pyramids and calculate statistics for all raster in a folder

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

inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BuildPyramidsAndStatistics_management(
     inws, includedir, buildpy, calcstats, buildsource, blockfield,
     estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
     resample, compress, quality, skipexist)

Environnements

Informations de licence

  • ArcGIS for Desktop Basic: Oui
  • ArcGIS for Desktop Standard: Oui
  • ArcGIS for Desktop Advanced: Oui

Thèmes connexes

Vous avez un commentaire à formuler concernant cette rubrique ?