Résumé
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.
Si l'espace de travail inclut une mosaïque, seules les statistiques associées à la mosaïque sont comprises, mais pas les statistiques associées aux éléments au sein de la mosaïque.
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(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}, {where_clause}, {sips_mode})
Paramètre | Explication | Type de données |
in_workspace | Espace de travail contenant tous les jeux de données raster ou toutes les mosaïques à traiter. Si l'espace de travail inclut une mosaïque, seules les statistiques associées à la mosaïque sont comprises, mais pas les statistiques associées aux éléments au sein de la mosaïque. | Text File; Workspace; Raster Layer; Mosaic Layer |
include_subdirectories (Facultatif) | Spécifiez s'il faut inclure les sous-répertoires.
Si l'espace de travail inclut une mosaïque, seules les statistiques associées à la mosaïque sont comprises, mais pas les statistiques associées aux éléments au sein de la mosaïque. | Boolean |
build_pyramids (Facultatif) | Spécifiez s'il faut créer des pyramides.
| Boolean |
calculate_statistics (Facultatif) | Indiquez si vous souhaitez calculer les 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 raster source, ou calculer des statistiques sur les éléments raster d'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 échantillons. Un pas d'échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d'échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d'échantillonnage peut uniquement s'étendre de la valeur 1 au nombre de colonnes/lignes du raster. Un pas d'échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d'échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d'échantillonnage peut uniquement s'étendre de la valeur 1 au nombre de colonnes/lignes du raster. 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. Un pas d'échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d'échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d'échantillonnage peut uniquement s'étendre de la valeur 1 au nombre de colonnes/lignes du raster. Un pas d'échantillonnage contrôle la partie du raster qui est utilisée dans le calcul des statistiques. La valeur en entrée indique le pas d'échantillonnage horizontal ou vertical : la valeur 1 utilise chaque pixel et la valeur 2 utilise un pixel sur deux. Le pas d'échantillonnage peut uniquement s'étendre de la valeur 1 au nombre de colonnes/lignes du raster. 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 29. Toute valeur de 30 ou plus permet de créer 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 |
where_clause (Facultatif) | Expression SQL permettant de sélectionner des jeux de données raster à traiter. | SQL Expression |
sips_mode (Facultatif) | Indique si la construction de fichiers de pyramides doit être activée à l’aide des algorithmes et processus clé définis dans la norme SIPS (Softcopy Image Processing Standard), NGA.STND.0014.
| Boolean |
Sortie dérivée
Nom | Explication | Type de données |
out_workspace | Espace de travail en sortie mis à jour. | Fichier texte ; Espace de travail ; Couche raster ; Couche de mosaïque |
Exemple de code
Il s’agit d'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")
Il s’agit d'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
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?