Construire des pyramides et des statistiques (Gestion des données)
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. Il peut également créer des pyramides et calculer des statistiques pour tous les éléments dans un catalogue d'images ou une mosaïque.
Utilisation
-
La création de pyramids 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 des données raster pour l'affichage.
-
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
| Paramètre | Explication | Type 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.
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.
| Boolean |
calculate_statistics (Facultatif) |
Indiquez s'il faut ou non calculer des statistiques.
| 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.
| 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.
| Boolean |
x_skip_factor (Facultatif) |
Nombre de pixels horizontaux entre les échantillons. Cette valeur doit être supérieure à zéro et inférieure ou égale au nombre de colonnes du jeu de données 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 des 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 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.
| Boolean |
resample_technique (Facultatif) |
Méthode de rééchantillonnage utilisée pour créer vos pyramides.
| String |
compression_type (Facultatif) |
Type de compression à utiliser lors de la création de pyramides raster.
| 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.
| Boolean |
Exemple de code
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")
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)