追加控制点 (数据管理)

摘要

将控制点和现有控制点表结合在一起。

要追加的点可能来自于计算连接点工具、计算控制点工具或点要素类。

使用情况

  • 如果既设置了 Z 值字段名称参数,又设置了输入 DEM 参数,那么 Z 值字段名称的优先级更高。如果既没设置 Z 值字段名称参数,又没设置输入 DEM 参数,那么所有地面控制点 (GCP) 和检测点的 Z 值都将被设置为 0。

  • 在调用追加选项时请注意 - 只有在输入和目标控制点表中的连接点具有相同的变换时此选项才适用。

参数

标注说明数据类型
目标控制点

输入控制点表。这通常是计算连接点工具的输出。

Feature Class; Feature Layer
输入控制点

存储控制点的点要素类。它可以是通过计算控制点工具、计算连接点工具,或具有地面控制点的点要素类所创建的控制点表。

Feature Class; Feature Layer; File; String
Z 值字段名称
(可选)

该字段存储控制点 Z 值。

如果既设置了 Z 值字段名称参数,又设置了输入 DEM 参数,那么将使用 Z 值字段。如果既没设置 Z 值字段名称参数,又没设置输入 DEM 参数,那么所有地面控制点和检测点的 Z 值都将被设置为 0。

Field
标签字段名称
(可选)

输入控制点表中的字段值是唯一的。该字段将被添加到目标控制点表中,标签字段可用于引入与地面控制点相关联的标识符。

Field
输入 DEM
(可选)

DEM 用于获取输入控制点表中控制点的 Z 值。

如果既设置了 Z 值字段名称参数,又设置了输入 DEM 参数,那么将使用 Z 值字段。如果既没设置 Z 值字段名称参数,又没设置输入 DEM 参数,那么所有地面控制点和检测点的 Z 值都将被设置为 0。

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
XY 精度
(可选)

X 和 Y 坐标的输入精度。精度单位与输入控制点的单位相同。

此信息应由数据提供商提供。如果精度信息不可用,请将此可选参数留空。

Double
Z 精度
(可选)

垂直坐标的输入精度。精度单位与输入控制点的单位相同。

此信息应由数据提供商提供。如果精度信息不可用,请将此可选参数留空。

Double
大地水准面
(可选)

参考椭球体高的有理多项式系数 (RPC) 需要进行大地水准面校正。大多数高程数据集均参考海平面正高,因此在这些情况下,需要进行此项校正以将海平面正高转换为椭球体高。

  • 未选中 - 不进行大地水准面校正。只有在已使用椭球体高表示 DEM 的情况下,才能使用此选项。这是默认设置。
  • 选中 - 将进行大地水准面校正以将正高转换为椭球体高(根据 EGM96 大地水准面)。
Boolean
感兴趣区
(可选)

通过在输入控制点表的空间参考中输入最小和最大的 x 和 y 坐标,来定义感兴趣区域的范围。

Envelope; Feature Layer; Feature Class
追加选项
(可选)

指定控制点追加到控制点表的方式。

  • 添加所有点将输入控制点表中的所有点添加到目标控制点表,包括 GCP、检测点和所有连接点。这是默认设置。
  • 仅添加 GCP仅将输入点表中的 GCP 添加到目标控制点表。
  • 添加 GCP 和连接点将与 GCP 明确相关联的 GCP 和连接点添加到目标控制点表。使用此选项时请注意 - 只有在输入和目标控制点表中的连接点具有相同的变换时此选项才适用。如果使用其他校正过程进行计算,则连接点可能不在所需的位置。
String

派生输出

标注说明数据类型
更新的控制点

已更新的控制点。

要素类;要素图层

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}, {area_of_interest}, {append_option})
名称说明数据类型
in_master_control_points

输入控制点表。这通常是计算连接点工具的输出。

Feature Class; Feature Layer
in_input_control_points

存储控制点的点要素类。它可以是通过计算控制点工具、计算连接点工具,或具有地面控制点的点要素类所创建的控制点表。

Feature Class; Feature Layer; File; String
in_z_field
(可选)

该字段存储控制点 Z 值。

如果既设置了 Z 值字段名称参数,又设置了输入 DEM 参数,那么将使用 Z 值字段。如果既没设置 Z 值字段名称参数,又没设置输入 DEM 参数,那么所有地面控制点和检测点的 Z 值都将被设置为 0。

Field
in_tag_field
(可选)

输入控制点表中的字段值是唯一的。该字段将被添加到目标控制点表中,标签字段可用于引入与地面控制点相关联的标识符。

Field
in_dem
(可选)

DEM 用于获取输入控制点表中控制点的 Z 值。

如果既设置了 Z 值字段名称参数,又设置了输入 DEM 参数,那么将使用 Z 值字段。如果既没设置 Z 值字段名称参数,又没设置输入 DEM 参数,那么所有地面控制点和检测点的 Z 值都将被设置为 0。

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
in_xy_accuracy
(可选)

X 和 Y 坐标的输入精度。精度单位与 in_input_control_points 的单位相同。

此信息应由数据提供商提供。如果精度信息不可用,请跳过此可选参数。

Double
in_z_accuracy
(可选)

垂直坐标的输入精度。精度单位与 in_input_control_points 的单位相同。

此信息应由数据提供商提供。如果精度信息不可用,请跳过此可选参数。

Double
Geoid
(可选)

参考椭球体高的有理多项式系数 (RPC) 需要进行大地水准面校正。大多数高程数据集均参考海平面正高,因此在这些情况下,需要进行此项校正以将海平面正高转换为椭球体高。

  • NONE不进行大地水准面校正。只有在已使用椭球体高表示 DEM 的情况下,才能使用 NONE。这是默认设置。
  • GEOID将进行大地水准面校正以将正高转换为椭球体高(根据 EGM96 大地水准面)。
Boolean
area_of_interest
(可选)

通过在输入控制点表的空间参考中输入最小和最大的 x 和 y 坐标,来定义感兴趣区域的范围。

Envelope; Feature Layer; Feature Class
append_option
(可选)

指定控制点追加到控制点表的方式。

  • ALL将输入控制点表中的所有点添加到目标控制点表,包括 GCP、检测点和所有连接点。这是默认设置。
  • GCP仅将输入点表中的 GCP 添加到目标控制点表。
  • GCPSET将与 GCP 明确相关联的 GCP 和连接点添加到目标控制点表。使用此选项时请注意 - 只有在输入和目标控制点表中的连接点具有相同的变换时此选项才适用。如果使用其他校正过程进行计算,则连接点可能不在所需的位置。
String

派生输出

名称说明数据类型
out_master_control_points

已更新的控制点。

要素类;要素图层

代码示例

AppendControlPoints 示例 1(Python 窗口)

这是 AppendControlPoints 工具的 Python 示例。

#===========================
#AppendControlPoints
'''Usage: AppendControlPoints_management(in_master_control_points, 
{in_z_field}, {in_tag_field}, {in_dem}, {in_xy_accuracy}, 
{in_z_accuracy}, {Geoid}, {area_of_interest}, {append_option}
'''

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.management.AppendControlPoints("calval_allpoints_dem1", 
    "C:\test\calval_allpoints_dem1", "Score", "Ways", "calval",1, 2, "NONE", 
"-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218", "GCP")
AppendControlPoints 示例 2(独立脚本)

这是 AppendControlPoints 工具的 Python 脚本示例。

#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"
AOI = "-79.6407162269889 43.4853802421312 -79.094324938576 44.0836924137218"
AppOpt = "GCP"


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

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题