Build Seamlines (Data Management)

Summary

Automatically generates seamlines for your mosaic dataset.

Usage

• The seamlines are generated from the footprints, with one seamline per footprint.

• You cannot build seamlines for a referenced mosaic dataset.

• To remove seamlines, right-click the mosaic dataset in ArcCatalog or the Catalog window and click Remove > Remove Seamlines.

Syntax

BuildSeamlines_management (in_mosaic_dataset, {cell_size}, sort_method, order_by_attribute, {order_by_base_value}, {sort_order}, {view_point})

Parameter	Explanation	Data Type
in_mosaic_dataset	Path and name of the mosaic dataset.	Mosaic Layer
cell_size (Optional)	The cell size affects the granularity at which the seamlines will be calculated. This can affect the length of time it takes to generate the seamline. If this value is the same as the raster's cell size, it will take longer than if it is set to a larger cell size.	Double
sort_method	The sort method is similar to the mosaic method in that it defines the order in which the rasters will be fused together to generate the image used to create the seamlines. NORTH_WEST —Orders rasters in a view-independent way where rasters with their centers most northwest are displayed on top. This is the default. CLOSEST_TO_VIEWPOINT —Orders rasters based on a user-defined location and nadir location for the rasters using the Viewpoint tool. BY_ATTRIBUTE —Orders rasters based on an attribute and its difference from a base value.	String
order_by_attribute	The attribute fielded to order rasters when the sort method is BY_ATTRIBUTE. The default attribute is ObjectID.	String
order_by_base_value (Optional)	The rasters are sorted based on the difference between their value and the value from the Sort Attribute field.	Double
sort_order (Optional)	When using the BY_ATTRIBUTE sort method, the rasters will be sorted in ascending order as defined by the Sort Attribute. ASCENDING — The rasters will be sorted in ascending order. This is the default. DESCENDING — The rasters will be sorted in descending order.	Boolean
view_point (Optional)	The coordinate location to use when the sort method is CLOSEST_TO_VIEWPOINT.	Point

Code Sample

BuildSeamlines example 1 (Python window)

This is a Python sample for BuildSeamlines.

import arcpy
arcpy.BuildSeamlines_management("c:/workspace/fgdb.gdb/md", "40", \
                                "NORTH_WEST", "#", "#", "#", "#")

BuildSeamlines example 2 (stand-alone window)

This is a Python script sample for BuildSeamlines.

##===========================
##Build Seamlines
##Usage: BuildSeamlines_management in_mosaic_dataset {cell_size} NORTH_WEST
##                                 | CLOSEST_TO_VIEWPOINT | BY_ATTRIBUTE order_by_attribute
##                                 {order_by_base_value} {ASCENDING | DESCENDING}
##                                 {view_point}

try:
    import arcpy
    arcpy.env.workspace = r"C:\Workspace"
    # Build Seamlines through three different methods
    # Build Seamlines use NORTH_WEST
    arcpy.BuildSeamlines_management("Seamlines.gdb/md", "40", "NORTH_WEST",\
                                    "#", "#", "#", "#")
    
    # Build Seamlines use BY_ATTRIBUTE
    arcpy.BuildSeamlines_management("Seamlines.gdb/md", "#", "BY_ATTRIBUTE",\
                                    "OBJECTID", "1", "DESCENDING", "#")
    
    # Build Seamlines use VIEW_POINT
    arcpy.BuildSeamlines_management("Seamlines.gdb/md", "#", "CLOSEST_TO_VIEWPOINT",\
                                    "#", "#", "#", "-12699965 3896282")
    
    
except:
    print "Build Seamlines example failed."
    print arcpy.GetMessages()

Environments

Extent

Licensing Information

ArcView: No

ArcEditor: Yes

ArcInfo: Yes