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, Compute Control Points tool, or a point feature class.
Usage
If both the Z Value Field Name and the Input DEM parameters are set, then the Z value field takes priority. If neither the Z Value Field Name or Input DEM parameters are set, then the Z value is set to 0 for all ground control points (GCPs) and check points.
Syntax
AppendControlPoints_management (in_master_control_points, in_input_control_points, {in_z_field}, {in_tag_field}, {in_dem})
Parameter | Explanation | Data 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 |
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, then the Z value field is used. If neither the Z Value Field Name nor Input DEM parameters are set, then 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, then the Z value field is used. If neither the Z Value Field Name nor Input DEM parameters are set, then the Z value is set to 0 for all ground control points and check points. | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster 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
- ArcGIS Desktop Basic: No
- ArcGIS Desktop Standard: Yes
- ArcGIS Desktop Advanced: Yes