Summary
Generate or update seamlines for your mosaic dataset. Seamlines are used to sort overlapping imagery and produce a smoother-looking mosaic.
You can use this tool to do the following:
- Generate seamlines for all items in the mosaic dataset.
- Generate seamlines for items selected using a query or by an area of interest.
- Update existing seamlines if items are added or removed from the mosaic dataset.
Usage
The seamlines are generated so that 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 do so before building seamlines. Color correction is especially important if the Computation Method is set to RADIOMETRY, as color is taken into account when seamlines are built.
The Sort Method and Sort Ascending parameters are disabled if Update Existing Seamlines option is checked on.
To remove seamlines, right-click the mosaic dataset in ArcCatalog or the Catalog window and click Remove > Remove Seamlines.
Syntax
arcpy.management.BuildSeamlines(in_mosaic_dataset, cell_size, {sort_method}, {sort_order}, {order_by_attribute}, {order_by_base_value}, {view_point}, {computation_method}, {blend_width}, {blend_type}, {request_size}, {request_size_type}, {blend_width_units}, {area_of_interest}, {where_clause}, {update_existing}, {min_region_size}, {min_thinness_ratio}, {max_sliver_size})
Parameter | Explanation | Data Type |
in_mosaic_dataset | Select the mosaic dataset on which to build seamlines. | Mosaic Layer |
cell_size [cell_size,...] | Generate seamlines for raster datasets that fall within the following range of spatial resolutions. You can leave this parameter empty and the tool will automatically create seamlines at the appropriate levels. The units for this parameter are the same as the spatial reference of the input mosaic dataset. | Double |
sort_method (Optional) | Set a rule to determine which raster will be used to generate seamlines when images overlap.
| String |
sort_order (Optional) | Choose whether to sort the rasters in ascending order or descending order.
| Boolean |
order_by_attribute (Optional) | Order the raster datasets based on this field when the sort method is BY_ATTRIBUTE. The default attribute is ObjectID. | Field |
order_by_base_value (Optional) | Sort the rasters by their difference between this value and their value in the order_by_attribute parameter. | Variant |
view_point (Optional) | Set the coordinate location to use when sort_method is CLOSEST_TO_VIEWPOINT. | Point |
computation_method (Optional) | Choose how to build seamlines.
The Sort Method parameter applies to each computation 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) | Determine how to blend one image into another, over the seamlines. Options are to blend inside the seamlines, outside the seamlines, or both inside and outside.
| String |
request_size (Optional) | Specify the number of columns and rows for resampling. The maximum value is 5,000. Increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset but also increases the processing time. | Long |
request_size_type (Optional) | Set the units for the Request Size.
| String |
blend_width_units (Optional) | Specify the unit of measurement for blend width.
| String |
area_of_interest (Optional) | Build seamlines on all the rasters that intersect this polygon. To select an area of interest, use an input feature class. | Feature Set |
where_clause (Optional) | SQL expression to build seamlines on specific raster datasets within the mosaic dataset. | SQL Expression |
update_existing (Optional) | Update seamlines that are affected by the addition or deletion of the mosaic dataset items.
This parameter is ignored if seamlines do not exist. | Boolean |
min_region_size (Optional) | Specify the minimum region size, in pixel units. Any polygons smaller than this specified threshold will be removed in the seamline result. The default is 100 pixels. This parameter value should be smaller than the sliver area, which is (max_sliver_size) * (max_sliver_size). | Long |
min_thinness_ratio (Optional) | Define how thin a polygon can be, before it is considered a sliver. This is based on a scale from 0 to 1.0, where a value of 0.0 represents a polygon that is almost a straight line, and a value of 1.0 represents a polygon that is a circle. Slivers are removed when building seamlines. | Double |
max_sliver_size (Optional) | Specify the maximum size a polygon can be to still be considered a sliver. This parameter is specified in pixels and is based on the request_size, not the spatial resolution of the source raster. Any polygon that is less than the square of this value is considered a sliver. Any regions that are less than (max_sliver_size)2 are considered slivers. Slivers are removed when building seamlines. | Long |
Derived Output
Name | Explanation | Data Type |
out_mosaic_dataset | The updated mosaic dataset. | Mosaic Layer |
Code sample
BuildSeamlines example 1 (Python window)
This is a Python sample for BuildSeamlines.
import arcpy
arcpy.BuildSeamlines_management("c:/data/Seamlines.gdb/md", "40",
"NORTH_WEST", "#", "#", "#", "#",
"RADIOMETRY", "5", "INSIDE", "#",
"#", "GROUND_UNITS")
BuildSeamlines example 2 (stand-alone script)
This is a Python script sample for BuildSeamlines.
# Build seamlines using the NORTH_WEST sort method
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "Seamlines.gdb/md"
cellsize = "40"
sortmethod = "NORTH_WEST"
sortorder = "#"
orderattribute = "#"
orderbase = "#"
viewpnt = "#"
computemethod = "RADIOMETRY"
blendwidth = "5"
blendtype = "INSIDE"
requestsize = "#"
arcpy.BuildSeamlines_management(
mdname, cellsize, sortmethod, sortorder, orderattribute,
orderbase, viewpnt, computemethod, blendwidth, blendtype,
requestsize)
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes