更新 COGO (编辑工具)
汇总
更新启用 COGO 的线要素的 COGO 属性以匹配其线形几何。
将更新以下 COGO 属性:
Direction
Distance
Radius
Arc Length
方向、距离和半径可以选择性地通过地面到格网校正进行缩放和旋转。
用法
参数
|
标注
|
说明
|
数据类型
|
|
输入线要素
|
将更新的启用 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
|
arcpy.edit.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
|
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 UpdateCOGO 函数更新线 COGO 属性。
import arcpy
arcpy.edit.UpdateCOGO('Lot_Lines', 'USE_MINIMUM_DIFFERENCE', '1 Feet',
'USE_MINIMUM_DIFFERENCE', '20')
环境
此工具不使用任何地理处理环境。
许可信息