Build Seamlines (Data Management)
Summary
Automatically generates seamlines for your mosaic dataset.
Usage
The seamlines are generated, so there is one seamline per footprint.
-
You cannot build seamlines for a referenced mosaic dataset.
If you plan on color correcting your mosaic dataset, it is recommended that you color correct before building seamlines, if the computation method is Radiometry. The color correction will be taken into account when seamlines are built.
To remove seamlines, right-click the mosaic dataset in ArcCatalog or the Catalog window and click Remove > Remove Seamlines.
Syntax
| Parameter | Explanation | Data Type |
in_mosaic_dataset |
Path and name of the mosaic dataset. | Mosaic Layer |
cell_size (Optional) |
The cell size is used to determine the rasters for which seamlines are generated. This is often used when there are various resolutions of data in a mosaic dataset and you want seamlines generated for only one level. For example, if you mix a high-resolution data source with a low-resolution data source you can specify a cell size that fits within the range of one of these data sources. If you have multiple LOWPS (low pixel size) values, or if you are not sure what cell size to specify, leave this parameter empty. The tool will automatically create seamlines at the appropriate levels. The units for this parameter is in the same units as the spatial reference of the mosaic dataset. | Double |
sort_method (Optional) |
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.
| String |
sort_order (Optional) |
Choose whether to sort the rasters in ascending order or descending order.
| Boolean |
order_by_attribute (Optional) |
The attribute field to order rasters when the sort method is BY_ATTRIBUTE. The default attribute is ObjectID. | Field |
order_by_base_value (Optional) |
The rasters are sorted based on the difference between their value and the value from the Sort Attribute field. | Variant |
view_point (Optional) |
The coordinate location to use when the sort method is CLOSEST_TO_VIEWPOINT. | Point |
computation_method (Optional) |
Choose which computation method to use while building the seamlines.
The sort order is applied with each method. | String |
blend_width (Optional) |
Blending (feathering) occurs along a seamline between pixels where there are overlapping rasters. The blend width defines how many pixels will be blended. If the blend width value is 10, and you use BOTH as the blend type, then 5 pixels will be blended on the inside and outside of the seamline. If the value is 10, and the blend type is INSIDE, then 10 pixels will be blended on the inside of the seamline. | Double |
blend_type (Optional) |
Blending (feathering) occurs along a seamline between pixels where there are overlapping rasters. The blend type defines where the blending will occur along the seamline.
| String |
request_size (Optional) |
The size to which the raster will be resampled when it is examined using this process. The value (such as 1,000) defines the dimension of rows and columns. The maximum value is 5,000. The default values for the Request Size changes based on the option selected in the Request Size Type. The default values are 1000 for PIXELS and 5 for the PIXELSIZE_FACTOR. You can increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset and thereby increases the processing time. | Long |
request_size_type (Optional) |
The Request Size Type will modify the request size based on the pixel or the pixel size factor selected. Based on the selected request size type, the default values for the Request Size changes using which the raster will be resampled.
| String |
Code Sample
This is a Python sample for BuildSeamlines.
import arcpy
arcpy.BuildSeamlines_management("c:/data/Seamlines.gdb/md", "40",
"NORTH_WEST", "#", "#", "#", "#",
"RADIOMETRY", "5", "INSIDE", "#", "#")
This is a Python script sample for BuildSeamlines.
#===========================
#Build Seamlines
'''Usage: BuildSeamlines_management(in_mosaic_dataset, {cell_size;cell_size...},
{NORTH_WEST | CLOSEST_TO_VIEWPOINT | BY_ATTRIBUTE},
{ASCENDING | DESCENDING}, {order_by_attribute},
{order_by_base_value}, {view_point}, {RADIOMETRY |
GEOMETRY | COPY_FOOTPRINT | COPY_TO_SIBLING},
{blend_width}, {BOTH | INSIDE | OUTSIDE}, {request_size}, {request_size_type}, {PIXEL | PIXELSIZE_FACTOR})
'''
try:
import arcpy
arcpy.env.workspace = "C:/Workspace"
# Build seamlines through three different methods
# Build seamlines use NORTH_WEST
# Define cell size to 40
# Build radiometry seamlines
mdname = "Seamlines.gdb/md"
cellsize = "40"
sortmethod = "NORTH_WEST"
sortorder = "#"
orderattribute = "#"
orderbase = "#"
viewpnt = "#"
computemethod = "RADIOMETRY"
blendwidth = "5"
blendtype = "INSIDE"
requestsize = "#"
requestsizetype = "#"
arcpy.BuildSeamlines_management(mdname, cellsize, sortmethod, sortorder, orderattribute, \
orderbase, viewpnt, computemethod, blendwidth, \
blendtype, requestsize, requestsizetype)
# Build Seamlines use ATTRIBUTE
# Automatically determine the cell size
# Build geometry seamlines
mdname = "Seamlines.gdb/md"
cellsize = "#"
sortmethod = "BY_ATTRIBUTE"
sortorder = "DESCENDING"
orderattribute = "OBJECTID"
orderbase = "1"
viewpnt = "#"
computemethod = "GEOMETRY"
blendwidth = "#"
blendtype = "#"
requestsize = "#"
requestsizetype = "#"
arcpy.BuildSeamlines_management(mdname, cellsize, sortmethod, sortorder, orderattribute, \
orderbase, viewpnt, computemethod, blendwidth, \
blendtype, requestsize, requestsizetype)
# Build Seamlines use VIEW_POINT
# Copy Footprint as seamline feature
mdname = "Seamlines.gdb/md"
cellsize = "#"
sortmethod = "CLOSEST_TO_VIEWPOINT"
sortorder = "#"
orderattribute = "#"
orderbase = "#"
viewpnt = "-12699965 3896282"
computemethod = "COPY_FOOTPRINT"
blendwidth = "#"
blendtype = "#"
requestsize = "#"
requestsizetype = "#"
arcpy.BuildSeamlines_management(mdname, cellsize, sortmethod, sortorder, orderattribute, \
orderbase, viewpnt, computemethod, blendwidth, \
blendtype, requestsize, requestsizetype)
except:
print "Build Seamlines example failed."
print arcpy.GetMessages()