Batch Build Pyramids (Data Management)

Summary

Builds pyramids for multiple raster datasets.

Usage

• Building pyramids improves the display performance of raster datasets.

• Batch building of pyramids is useful when you have a large directory of raster datasets that do not have pyramids or to build pyramids on the items of a raster catalog (drag them into the dialog box).

• Wavelet compressed raster datasets, such as ECW, and MrSID, do not need to have pyramids built. These formats have internal pyramids that are created upon encoding.

• Pyramids will not be built for raster datasets that have less than 1024 pixels in the row or column. Pyramids are not needed since the raster dataset is small enough, and building pyramids will not help increase the performance.

• Pyramids cannot be built for raster catalogs, but they can be built for each raster catalog item.

• You can choose the compression type for your overview pyramid file, in the Raster Storage Environment Settings. Compression will create a smaller .ovr file. The IMAGINE format and older versions of ArcGIS will create reduced resolution dataset (.rrd) files, where compression is not available.

• The default pyramid compression will use the optimal compression type, given the type of data. You can manually choose to have LZ77, JPEG, or no compression.

• JPEG compression can only be used with file formats that can store data according to the JPEG specifications.

Syntax

BatchBuildPyramids_management (Input_Raster_Datasets)

Parameter	Explanation	Data Type
Input_Raster_Datasets [input_raster_dataset,...]	The input raster datasets that you want to build raster pyramids for. Each input should have more than 1024 rows and 1024 columns.	Raster Dataset

Code Sample

BatchBuildPyramids example 1 (Python window)

This is a Python sample for BatchBuildPyramids.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.BatchBuildPyramids_management("image1.tif;image2.img;image3.bmp")

BatchBuildPyramids example 2 (stand-alone window)

This is a Python script sample for BatchBuildPyramids.

##====================================
##Batch Build Pyramids
##Usage: BatchBuildPyramids_management Input_Raster_Datasets;Input_Raster_Datasets...

try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"
    
    ##Build Pyramids for multiple raster datasets
    arcpy.BatchBuildPyramids_management("image1.tif;image2.img;fgdb.gdb/image3")

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

Environments

Current Workspace, Pyramid

Pyramid

The pyramid level, pyramid compression, and resampling method does not apply to the IMG format.

Licensing Information

ArcView: Yes

ArcEditor: Yes

ArcInfo: Yes