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
BuildSeamlines_management (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})
Parameter | Explanation | Data Type |
in_mosaic_dataset | Select the mosaic dataset on which to build seamlines. | Mosaic Layer |
cell_size (Optional) | 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 field. | 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 of the rasters that intersect this polygon. To select an area of interest, use an input feature class. | Feature Set |
where_clause SQL Expression (Optional) | SQL expression to build seamlines on specific raster datasets within the mosaic dataset. | SQL Expression |
update_existing (Optional) | Update new seamlines and regenerate existing seamlines that are affected by the addition or deletion of the mosaic dataset items.
This parameter is ignored if seamlines do not exist. | Boolean |
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
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: Yes
- ArcGIS Desktop Advanced: Yes