Construire des pyramides et des statistiques (Gestion des données)

Synthèse

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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Espace de travail ou données en entrée	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
Inclure les sous-répertoires (Facultatif)	Indique si les sous-répertoires sont inclus. Désactivé - N'inclut pas les sous-répertoires. Activé - 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 mosaïques doivent être spécifiées en tant qu'espace de travail en entrée si vous souhaitez inclure les éléments au sein de la mosaïque. Sinon, seules les statistiques associées à la mosaïque sont utilisées.	Boolean
Générer la structure pyramidale (Facultatif)	Spécifiez s'il faut créer des pyramides. Désactivé - Ne crée pas de pyramides. Activé - Crée des pyramides. Il s'agit de l'option par défaut.	Boolean
Calculer les statistiques (Facultatif)	Indiquez si vous souhaitez calculer les statistiques. Désactivée : les statistiques ne sont pas calculées. Activée : les statistiques sont calcules. Il s'agit de l'option par défaut.	Boolean
Inclure des jeux de données sources (Facultatif)	Spécifiez s’il faut calculer des statistiques sur les jeux de données raster source, ou calculer des statistiques sur les éléments raster d’un jeu de données mosaïque. Cette option s'applique uniquement aux mosaïques. Désactivé - 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. Activé : calcule des statistiques sur les données source du jeu de données mosaïque.	Boolean
Champ d’îlot (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
Estimer les statistiques de mosaïque (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. Décochée : les statistiques ne sont pas calculées pour la mosaïque. Il s’agit de l’option par défaut. Cochée : les statistiques sont calculées pour la mosaïque.	Boolean
Pas d’échantillonnage X (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. 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
Pas d'échantillonnage Y (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. 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
Ignorer les valeurs (Facultatif)	Valeurs de pixel à ne pas inclure dans le calcul de statistiques. Par défaut, aucune valeur n'est définie.	Long
Niveaux de pyramides (Facultatif)	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
Passer le premier niveau (Facultatif)	Indique si le premier niveau de la pyramide est 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 est créé. Il s’agit de l’option par défaut. Activé : le premier niveau de la pyramide est ignoré ; il n’est pas créé.	Boolean
Technique de rééchantillonnage des pyramides (Facultatif)	Indique la méthode de rééchantillonnage utilisée pour construire les pyramides. Voisin le plus proche—La valeur du pixel le plus proche est utilisée pour affecter une valeur au pixel en sortie lors du rééchantillonnage. Il s’agit de l’option par défaut. Bilinéaire—La nouvelle valeur d’un pixel repose sur une distance moyenne pondérée des valeurs des centres des quatre pixels en entrée les plus proches. Cubique—La nouvelle valeur d’un pixel repose sur l’ajustement d’une courbe lissée suivant les centres des 16 pixels en entrée les plus proches.	String
Type de compression pyramidale (Facultatif)	Indique le type de compression à utiliser lors de la construction de pyramides raster. Par défaut—Si les données source sont compressées à l’aide d’une compression par ondelettes, des pyramides sont construites avec le type de compression JPEG. Sinon, la compression LZ77 est utilisée. Il s’agit de l’option par défaut. Compression 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. Compression JPEG—L’algorithme de compression JPEG est utilisé pour construire 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 valeur Qualité de compression. Luminance et chrominance JPEG—Une compression avec perte utilisant les composants d’espace de couleur de luminance (Y) et de chrominance (Cb et Cr) est utilisée. Aucune compression.—Les pyramides sont créées sans compression.	String
Qualité de compression (1-100) (Facultatif)	La 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
Passer l'élément existant (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. Activé - Les statistiques ne sont calculées que si elles n'existent pas. Il s’agit de l’option par défaut. Désactivé - Les statistiques sont calculées même si elles existent déjà ; les statistiques existantes sont écrasées.	Boolean
Ensemble de définition (Facultatif)	Expression SQL permettant de sélectionner des jeux de données raster à traiter.	SQL Expression
Mode SIPS (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. Désactivé : les pyramides seront construites à l’aide des méthodes de sous-échantillonnage standard. Il s’agit de l’option par défaut. Activé : les pyramides seront construites à l’aide du traitement SIPS.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Données en entrée mises à jour	Espace de travail en sortie mis à jour.	Text File; Workspace; Raster Layer; Mosaic Layer

Python

arcpy.management.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})

Nom	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)	Indique si les sous-répertoires sont inclus. 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. 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. 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 calculer des statistiques sur les jeux de données raster source, ou calculer des statistiques sur les éléments raster d’un jeu de données 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—Calcule des statistiques sur les données source du jeu de données 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. 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. 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)	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)	Indique si le premier niveau de la pyramide est ignoré. 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 n’est pas ignoré ; il est créé. Il s’agit de l’option par défaut. SKIP_FIRST—Le premier niveau de la pyramide est ignoré ; il n’est pas créé.	Boolean
resample_technique (Facultatif)	Indique la méthode de rééchantillonnage utilisée pour construire les pyramides. NEAREST—La valeur du pixel le plus proche est utilisée pour affecter une valeur au pixel en sortie lors du rééchantillonnage. Il s’agit de l’option par défaut. BILINEAR—La nouvelle valeur d’un pixel repose sur une distance moyenne pondérée des valeurs des centres des quatre pixels en entrée les plus proches. CUBIC—La nouvelle valeur d’un pixel repose sur l’ajustement d’une courbe lissée suivant les centres des 16 pixels en entrée les plus proches.	String
compression_type (Facultatif)	Indique le type de compression à utiliser lors de la construction de pyramides raster. DEFAULT—Si les données source sont compressées à l’aide d’une compression par ondelettes, des pyramides sont construites avec le type de compression JPEG. Sinon, la compression LZ77 est utilisée. Il s’agit de l’option 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 construire 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 valeur Qualité de compression. JPEG_YCBCR—Une compression avec perte utilisant les composants d’espace de couleur de luminance (Y) et de chrominance (Cb et Cr) est utilisée. NONE—Les pyramides sont créées sans compression.	String
compression_quality (Facultatif)	La 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à ; les statistiques existantes sont écrasées.	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. NONE—Les pyramides seront construites à l’aide des méthodes de sous-échantillonnage standard. Il s’agit de l’option par défaut. SIPS_MODE—Les pyramides seront construites à l’aide du traitement SIPS.	Boolean

Sortie obtenue

Nom	Explication	Type de données
out_workspace	Espace de travail en sortie mis à jour.	Text File; Workspace; Raster Layer; Mosaic Layer

Exemple de code

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

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")

Exemple 2 d'utilisation de l'outil BuildPyramidsAndStatistics (script autonome)

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

Facteur de traitement parallèle, Pyramide, Statistiques raster

Cas particuliers

Informations de licence

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