ArcGIS Desktop

  • Documentation
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

Append Control Points

  • Summary
  • Usage
  • Syntax
  • Code sample
  • Environments
  • Licensing information

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

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

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

  • Current Workspace

Licensing information

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

Related topics

  • An overview of the Raster toolset
  • Georeferencing a raster automatically
  • Fundamentals of georeferencing a raster dataset
  • Register Raster

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2017 Esri. | Privacy | Legal