ArcMap

Append Control Points

Summary

Combines control points to an existing control point table.

The points to be appended are the results from either the Compute Tie Points tool, the Compute Control Points tool, or a point feature class.

Usage

  • If both the Z Value Field Name and the Input DEM parameters are set, the Z Value Field Name takes priority. If neither the Z Value Field Name nor the Input DEM parameter is set, the z-value is set to 0 for all ground control points (GCP) and check points.

Syntax

arcpy.management.AppendControlPoints(in_master_control_points, in_input_control_points, {in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, {in_z_accuracy}, {Geoid})
ParameterExplanationData Type
in_master_control_points

The input control point table. This is usually the output from the Compute Tie Points tool.

Feature Class; Feature Layer
in_input_control_points

A point feature class that stores control points. It could be the control point table created from the Compute Control Points tool, the Compute Tie Points tool, or a point feature class that has ground control points.

Feature Class; Feature Layer; File; String
in_z_field
(Optional)

The field that stores the control point z-values.

If both the Z Value Field Name and the Input DEM parameters are set, the Z value field is used. If neither the Z Value Field Name nor the Input DEM parameter is set, the z-value is set to 0 for all ground control points and check points.

Field
in_tag_field
(Optional)

A field in the input control point table that has a unique value. This field will be added to the target control point table, where the tag field can be used to bring in identifiers associated with ground control points.

Field
in_dem
(Optional)

A DEM to use to obtain the z-value for the control points in the input control point table.

If both the Z Value Field Name and Input DEM parameters are set, the Z value field is used. If neither the Z Value Field Name nor the Input DEM parameter is set, the z-value is set to 0 for all ground control points and check points.

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
in_xy_accuracy
(Optional)

The input accuracy for the X and Y coordinates. The accuracy is in the same units as the in_input_control_points.

This information should be provided by the data provider. If the accuracy information is not available, skip this optional parameter.

Double
in_z_accuracy
(Optional)

The input accuracy for the vertical coordinates. The accuracy is in the units of the in_input_control_points.

This information should be provided by the data provider. If the accuracy information is not available, skip this optional parameter.

Double
Geoid
(Optional)

The geoid correction is required by rational polynomial coefficients (RPC) that reference ellipsoidal heights. Most elevation datasets are referenced to sea level orthometric heights, so this correction would be required in these cases to convert to ellipsoidal heights.

  • NONE —No geoid correction is made. Use NONE only if your DEM is already expressed in ellipsoidal heights. This is the default.
  • GEOID —A geoid correction will be made to convert orthometric heights to ellipsoidal heights (based on EGM96 geoid).
Boolean

Derived Output

NameExplanationData Type
out_master_control_points

The updated control points.

Feature Class; Feature Layer

Code sample

AppendControlPoints example 1 (Python window)

This is a Python sample for the AppendControlPoints tool.

import arcpy
arcpy.AppendControlPoints_management(
     "c:/BD/BD.gdb/tiePts", "c:/BD/BD.gdb/controlPts",
     "", "c:/BD/BD.gdb/dem")
AppendControlPoints example 2 (stand-alone script)

This is a Python script sample for the AppendControlPoints tool.

#append control points

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

#append the control points and tie points
target = "BD.gdb/tiePoints"
in_controlPoints = "BD.gdb/controlPoints"
dem = "BD.gdb/dem"

arcpy.AppendControlPoints_management(target, in_controlPoints, "", dem)

Environments

Licensing information

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

Related topics