Skip to main content

Build Seamlines (Data Management Tools)

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.

Parameters

Label Explanation Data type

Mosaic Dataset

Select the mosaic dataset on which to build seamlines.

Mosaic Layer

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.

  • Northwest—Select the raster datasets that have center points closest to the northwest corner of the boundary. This is the default.

  • Closest to viewpoint—Select raster datasets based on a user-defined location and a nadir location for the raster datasets using the Viewpoint tool.

  • By attribute—Select raster datasets based on an attribute from the footprint attribute table. Commonly used attributes include acquisition date, cloud cover, or viewing angle.

String

Sort Ascending

(Optional)

Choose whether to sort the rasters in ascending order or descending order.

  • Checked—Sort the rasters in ascending order. This is the default.

  • Unchecked—Sort the rasters in descending order.

Boolean

Sort Attribute

(Optional)

Order the raster datasets based on this field when the sort method is By Attribute. The default attribute is ObjectID.

Field

Sort Base Value

(Optional)

Sort the rasters by their difference between this value and their value in the Sort 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.

  • Geometry—Generate seamlines for overlapping areas based on the intersection of footprints. Areas with no overlapping imagery will merge the footprints. This is the default.

  • Radiometry—Generate seamlines based on the spectral patterns of features within the imagery.

  • Copy footprint—Generate seamlines directly from the footprints.

  • Copy to sibling—Apply the seamlines from another mosaic dataset. The mosaic datasets have to be in the same group. For example, the extent of the panchromatic band does not always match the extent of the multispectral band. This option makes sure they share the same seamline.

  • Edge detection—Generate seamlines over intersecting areas based on the edges of features in the area.

  • Voronoi—Generate seamlines using the area Voronoi diagram.

  • Disparity—Generate seamlines based on the disparity images of stereo pairs. This method can avoid seamlines cutting through buildings.

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.

  • Both—Blend using pixels on either side of the seamlines. For example, if the Blend Width is 10 pixels, then five pixels will be blended on the inside and outside of the seamline. This is the default.

  • Inside—Blend inside of the seamline.

  • Outside—Blend outside of the seamline.

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.

  • Pixels—Modify the request size based on the pixel size.This is the default option and resamples the closest image based on the raster pixel size.

  • Pixel scaling factor—Modify the request size by specifying a scaling factor. This option resamples the closest image by multiplying the raster pixel size (from cell size level table) with the pixel size factor.

String

Blend Width Units

(Optional)

Specify the unit of measurement for blend width.

  • Pixels—Measure using the number of pixels. This is the default.

  • Ground units—Measure using the same units as the mosaic dataset.

String

Area of Interest

(Optional)

Build seamlines on all the rasters that intersect this polygon. To specify an area of interest, browse to a feature class, or create a polygon graphic on the display.

Feature Set

Query Definition

(Optional)

SQL expression to build seamlines on specific raster datasets within the mosaic dataset.

SQL Expression

Update Existing Seamlines

(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.

  • Checked—Only update items without seamlines. If any new items overlap with the previously created seamlines, the existing seamlines may be affected.

  • Unchecked—Regenerates seamlines for all items and ignores existing seamlines, if any. This is the default.

Boolean

Minimum 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 defined as (Maximum Sliver Size) * (Maximum Sliver Size).

Long

Minimum 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

Maximum 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 (Maximum Sliver Size)2 are considered slivers.

Slivers are removed when building seamlines.

Long

Derived output

Label Explanation Data type

Updated Mosaic Dataset

The updated mosaic dataset.

Mosaic Layer

Environments

Parallel Processing Factor

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes