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 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 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 ne calcule pas de statistiques sur la mosaïque, mais simplement sur les rasters qu'elle contient. Pour calculer des statistiques sur la mosaïque, utilisez l'outil Calculer les statistiques.

• La création de pyramides n'est pas nécessaire pour les jeux de données raster compressés par ondelettes, tels que ECW, et MrSID. Ces formats comportent des pyramides internes créées lors du codage.

• Les pas d'échantillonnage et le rééchantillonnage des pyramides peuvent être définis dans les paramètres de stockage de raster de l'environnement de géotraitement.

Syntaxe

BuildPyramidsandStatistics_management (in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {build_on_source})

Paramètre	Explication	Type de données
in_workspace	Espace de travail contenant tous les jeux de données raster à traiter. 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.	Mosaic Dataset; Raster Catalog Layer; Raster Dataset; 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 du paramétrage 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)	Indiquez s'il faut ou non créer des pyramides. NONE —Ne crée pas de pyramides. BUILD_PYRAMIDS —Crée des pyramides. Il s'agit de l'option par défaut.	Boolean
calculate_statistics (Facultatif)	Indiquez s'il faut ou non calculer des statistiques. NONE —Ne calcule pas de statistiques. CALCULATE_STATISTICS —Calcule des 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 du paramétrage par défaut. BUILD_ON_SOURCE —Crée des pyramides et calcule des statistiques sur les données source de la mosaïque.	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
from arcpy import env
env.workspace = "c:/data"
arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
arcpy.BuildPyramidsAndStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
                                            "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

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 Statistics
##Usage: BuildPyramidsAndStatistics_management in_workspace {INCLUDE_SUBDIRECTORIES
##                                                 | NONE} {BUILD_PYRAMIDS | NONE}
##                                                 {CALCULATE_STATISTICS | NONE}
    
try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"

    ##Define parameters for build pyramids and calculate statitics in environment setting
    arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
    arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
    
    ##Build pyramids and calculate statistics for all raster in a folder
    arcpy.BuildPyramidsAndStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
    
    ##Build pyramids and calculate statistics for all raster in a GDB
    arcpy.BuildPyramidsAndStatistics_management("fgdb.gdb", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
    
    ##Build pyramids and calculate statistics for all raster in a Mosaic Dataset
    arcpy.BuildPyramidsAndStatistics_management("fgdb.gdb/md", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

except:
    print "Build Pyramids and Statistics example failed."
    print arcpy.GetMessages()

Environnements

Pyramide, Statistiques raster, Espace de travail courant, Espace de travail temporaire

Informations de licence

ArcView : Oui

ArcEditor : Oui

ArcInfo : Oui