Append Control Points (Data Management)

Summary

Combines control points to an existing control point table.

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.

Parameters

Dialog

Label	Explanation	Data Type
Target Control Points		Feature Class; Feature Layer
Input Control Points		Feature Class; Feature Layer; File; String
Z Value Field Name (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
Tag Field Name (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
Input 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
XY Accuracy (Optional)	The input accuracy for the X and Y coordinates. The accuracy is in the same units as the Input Control Points. This information should be provided by the data provider. If the accuracy information is not available, leave this optional parameter blank.	Double
Z Accuracy (Optional)	The input accuracy for the vertical coordinates. The accuracy is in the units of the Input Control Points. This information should be provided by the data provider. If the accuracy information is not available, leave this optional parameter blank.	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. Unchecked—No geoid correction is made. Use this option only if your DEM is already expressed in ellipsoidal heights. This is the default. Checked—A geoid correction will be made to convert orthometric heights to ellipsoidal heights (based on EGM96 geoid).	Boolean

Derived Output

Label	Explanation	Data Type
Updated Control Points	The updated control points.	Feature Class; Feature Layer

Python

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})

Name	Explanation	Data Type
in_master_control_points		Feature Class; Feature Layer
in_input_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

Name	Explanation	Data Type
out_master_control_points	The updated control points.	Feature Class; Feature Layer

Environments

This tool does not use any geoprocessing environments.