Build Boundary (Data Management)

Summary

Generates the boundary polygon for a mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels. The boundary of the mosaic dataset is updated to exclude any areas where mosaic dataset items have been removed.

Illustration

Usage

• Boundaries can only be generated for mosaic datasets stored within a geodatabase.

• If you modify the shape of the boundary polygon (using editing tools), you can use this tool to recreate the original (unmodified) boundary.

• If you modify the shape of the boundary polygon (using editing tools), you can use this tool to rebuild the boundary to its unmodified shape.

• Use the Append To Existing Boundary option to only update the boundary where newly added footprints exist. Since the entire boundary is not recalculated, it will save time.

Syntax

BuildBoundary_management (in_mosaic_dataset, {where_clause}, {append_to_existing})

Parameter	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset for which the boundary will be calculated.	Mosaic Dataset
where_clause (Optional)	Enter an SQL query if you would like to create a subset of the data, based on attributes.	SQL Expression
append_to_existing (Optional)	When footprints have been selected, this option determines how the boundary will be modified. OVERWRITE —Removes any existing boundary, then creates a newly computed boundary. APPEND —Appends the perimeter of footprints to the existing boundary. This can save time when adding additional raster data to the mosaic dataset, as the entire boundary will not be recalculated. If there are rasters selected, the boundary will be recalculated to include only the selected footprints. This is the default.	Boolean

Code Sample

BuildBoundary example (Python window)

This is a Python sample for the BuildBoundary tool.

import arcpy
arcpy.BuildBoundary_management("c:/workspace/fGDB.gdb/md","APPEND")

Build Boundary example 2 (stand-alone window)

This is a Python script for the BuildBoundary tool.

##===========================
##Build Boundary
##Usage: BuildBoundary_management in_mosaic_dataset {OVERWRITE | APPEND}

try:
    import arcpy
    arcpy.env.workspace = r"C:\Workspace"
    
    #Build boundary using the appending mode
    arcpy.BuildBoundary_management("Boundary.gdb/md","APPEND")    
except:
    print "Build Boundary example failed."
    print arcpy.GetMessages()

Environments

Extent

Licensing Information

ArcView: No

ArcEditor: Yes

ArcInfo: Yes