更新 COGO (编辑)

摘要

更新启用 COGO 的线要素的 COGO 属性以匹配其线形几何。

将更新以下 COGO 属性：

• Direction
• Distance
• Radius
• Arc Length

方向、距离和半径可以选择性地通过地面到格网校正进行缩放和旋转。

使用情况

警告：

此工具会修改输入数据。 有关详细信息以及避免数据被意外更改的策略，请参阅修改或更新输入数据的工具。

• 输入线要素类必须启用 COGO。

  了解有关为线要素类启用 COGO 的详细信息

参数

对话框

标注	说明	数据类型
输入线要素	将更新的启用 COGO 的线要素。	Feature Layer
更新距离、半径和弧长 (可选)	指定更新输入线的 Distance、Radius 和 Arc Length COGO 属性的方式。 覆盖所有值—所有值（包括 NULL 值）都将更新以匹配形状长度。 这是默认设置。 仅更新 NULL 值—仅更新 NULL 值以匹配形状长度。 使用最小差异更新值—将更新与形状长度相差超过指定容差的值以匹配形状长度。 不更新任何值—值不会更新。	String
最小距离差 (可选)	线形长度与 Distance、Radius 和 Arc Length 字段值之间的最小距离差。 如果距离差大于指定的容差，则将更新Distance、Radius 或 Arc Length 字段中的属性值以匹配线形长度。 默认值是 0 米。	Linear Unit
更新方向 (可选)	指定更新输入的 Direction COGO 属性的方式。 覆盖所有值—所有值（包括 NULL 值）都将更新以匹配形状方向。 这是默认设置。 仅更新 NULL 值—仅更新 NULL 值以匹配形状方向。 使用最小差异更新值—将更新与形状方向相差超过指定容差的值以匹配形状方向。 不更新任何值—值不会更新。	String
最小方向差（秒） (可选)	线形方向与 Direction 字段值之间的最小方向差（以秒为单位）。 如果方向差大于指定的容差，则将更新 Direction 字段中的属性值以匹配线形方向。 默认值为 0。	Double
最小方向横向偏移 (可选)	线形端点与使用 Direction 字段值绘制的线的端点之间允许的最小距离。 横向偏移容差可用于非常长的线，其中方向的微小变化会导致线端点的较大差异。 默认值是 0 米。	Linear Unit
组合比例因子 (可选)	基于地面到格网校正的比例因子，将应用于线形长度。 比例因子可以作为数字提供，也可以派生自使用线属性字段的 Arcade 表达式。 在 Distance、Radius 和 Arc Length 字段中填充的更新距离是形状长度乘以比例因子的结果。	Calculator Expression
方向偏移（秒） (可选)	基于地面到格网校正的旋转，将应用于线形方向。 方向偏移可以作为以秒为单位的数字提供，也可以派生自使用线属性字段的 Arcade 表达式。 在线 Direction 字段中填充的更新方向是按指定方向偏移旋转的线形方向。	Calculator Expression

派生输出

标注	说明	数据类型
更新线要素	更新后的线要素。	Parcel Layer

Python

arcpy.management.UpdateCOGO(in_line_features, {distances_type}, {distance_tolerance}, {direction_type}, {minimum_direction_difference}, {minimum_direction_lateral_offset}, {combined_scale_factor}, {direction_offset})

名称	说明	数据类型
in_line_features	将更新的启用 COGO 的线要素。	Feature Layer
distances_type (可选)	指定更新输入线的 Distance、Radius 和 Arc Length COGO 属性的方式。 OVERWRITE—所有值（包括 NULL 值）都将更新以匹配形状长度。 这是默认设置。 UPDATE_NULL_ONLY—仅更新 NULL 值以匹配形状长度。 USE_MINIMUM_DIFFERENCE—将更新与形状长度相差超过指定容差的值以匹配形状长度。 DO_NOT_UPDATE—值不会更新。	String
distance_tolerance (可选)	线形长度与 Distance、Radius 和 Arc Length 字段值之间的最小距离差。 如果距离差大于指定的容差，则将更新Distance、Radius 或 Arc Length 字段中的属性值以匹配线形长度。 默认值是 0 米。	Linear Unit
direction_type (可选)	指定更新输入的 Direction COGO 属性的方式。 OVERWRITE—所有值（包括 NULL 值）都将更新以匹配形状方向。 这是默认设置。 UPDATE_NULL_ONLY—仅更新 NULL 值以匹配形状方向。 USE_MINIMUM_DIFFERENCE—将更新与形状方向相差超过指定容差的值以匹配形状方向。 DO_NOT_UPDATE—值不会更新。	String
minimum_direction_difference (可选)	线形方向与 Direction 字段值之间的最小方向差（以秒为单位）。 如果方向差大于指定的容差，则将更新 Direction 字段中的属性值以匹配线形方向。 默认值为 0。	Double
minimum_direction_lateral_offset (可选)	线形端点与使用 Direction 字段值绘制的线的端点之间允许的最小距离。 横向偏移容差可用于非常长的线，其中方向的微小变化会导致线端点的较大差异。 默认值是 0 米。	Linear Unit
combined_scale_factor (可选)	基于地面到格网校正的比例因子，将应用于线形长度。 比例因子可以作为数字提供，也可以派生自使用线属性字段的 Arcade 表达式。 在 Distance、Radius 和 Arc Length 字段中填充的更新距离是形状长度乘以比例因子的结果。	Calculator Expression
direction_offset (可选)	基于地面到格网校正的旋转，将应用于线形方向。 方向偏移可以作为以秒为单位的数字提供，也可以派生自使用线属性字段的 Arcade 表达式。 在线 Direction 字段中填充的更新方向是按指定方向偏移旋转的线形方向。	Calculator Expression

派生输出

名称	说明	数据类型
updated_line_features	更新后的线要素。	Parcel Layer

代码示例

UpdateCOGO 示例（Python 窗口）

以下 Python 窗口脚本演示了如何在即时模式下使用 UpdateCOGO 函数更新线 COGO 属性。

import arcpy

arcpy.edit.UpdateCOGO('Lot_Lines', 'USE_MINIMUM_DIFFERENCE', '1 Feet', 
                      'USE_MINIMUM_DIFFERENCE', '20')

环境

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