ArcMap

Compute Tie Points

Summary

Computes the tie points between overlapped mosaic dataset items. The tie points can then be used to compute the adjustments for the mosaic dataset.

Usage

  • The tie points can be combined with control points using the Append Control Points tool.

  • The tie points and the optional control points are then used as the inputs for the Compute Adjustments tool.

  • If you have a mosaic dataset with a lot of items, you will want to avoid using the Output Image Features parameter, since your result will take a very long time to process.

Syntax

ComputeTiePoints_management (in_mosaic_dataset, out_control_points, {similarity}, {in_mask_dataset}, {out_image_features}, density, distribution)
ParameterExplanationData Type
in_mosaic_dataset

The input mosaic dataset that will be used to create tie points.

Mosaic Layer; Mosaic Dataset
out_control_points

The output control point table. This table will contain the tie points created by this tool.

Feature Class
similarity
[similarity,...]
(Optional)

Choose the tolerance level for your matching tie points.

  • LOW —The similarity tolerance for the matching pairs will be low. This option will produce the most matching pairs, but some of the matches may have a higher level of error.
  • MEDIUM —The similarity tolerance for the matching pairs will be medium. This is the default.
  • HIGH —The similarity tolerance for the matching pairs will be high. This option will produce the least number of matching pairs, but each matching pair will have a lower level of error.
String
in_mask_dataset
(Optional)

A polygon feature class that is used to exclude areas that you do not want in the computation of control points.

A field with a name of mask can control the inclusion or exclusion of areas. A value of 1 indicates that the areas defined by the polygons (inside) will be excluded from the computation. A value of 2 indicates the defined polygons (inside) will be included in the computation while areas outside of the polygons will be excluded.

Feature Layer
out_image_features
(Optional)

The output image feature points table. This will be saved as a polygon feature class. This output can be quite large.

Feature Class
density

The number of tie points to be created.

  • LOW —This produces the fewest number of points.
  • MEDIUM —This is the default.
  • HIGH —This produces the most points.
String
distribution

Determines whether the output points will have a regular or random distribution.

  • RANDOM —Randomly generated points are better for overlapping areas with irregular shapes.
  • REGULAR —Generates points based on a fixed pattern.
String

Code sample

ComputeTiePoints example 1 (Python window)

This is a Python sample for the ComputeTiePoints tool.

import arcpy
arcpy.ComputeTiePoints_management("c:/workspace/BD.gdb/redQB", 
     "c:/workspace/BD.gdb/redQB_tiePoints", "MEDIUM")
ComputeTiePoints example 2 (stand-alone script)

This is a Python script sample for the ComputeTiePoints tool.

#compute tie points

import arcpy
arcpy.env.workspace = "c:/workspace"

#Compute tie points for a mosaic dataset
mdName = "BD.gdb/redlandsQB"
out_tiePoint = "BD.gdb/redlandsQB_tiePoints"

arcpy.ComputeTiePoints_management(mdName, out_tiePoint, "MEDIUM")

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes

Related topics