在 Standard 或 Advanced 许可等级下可用。
描述
向拓扑添加要素类。
使用方法
新要素类必须与拓扑处于同一要素数据集。
向拓扑中添加新的要素类会使整个拓扑自动变得混乱,因此在完成要素类的添加之后,将需要重新验证拓扑。新增要素可能会在之前没有错误的位置产生错误,具体情况取决于与要素类关联的拓扑规则。
只能向具有相同版本状态的拓扑中添加要素类。例如,可向版本化拓扑中添加版本化要素类,但无法向版本化拓扑中添加非版本化要素类。
如果要添加的要素类中含 z 值,则可通过设置要素类的 z 等级来按高程排列要素类的相对精度。
向拓扑中添加要素类时,必须指定此要素类中的折点相对于其他要素类中的折点的等级。拓扑验证在裂化和聚类要素折点时,如果是选择低等级要素类的折点进行捕捉,则不会移动高等级要素类的折点。最高等级为 1,最多可指定 50 个不同的等级值。
语法
arcpy.management.AddFeatureClassToTopology(in_topology, in_featureclass, xy_rank, z_rank)
参数 | 说明 | 数据类型 |
in_topology | 要素类将参与的拓扑。 | Topology Layer |
in_featureclass | 要向拓扑中添加的要素类。该要素类必须与拓扑处于同一要素数据集。 | Feature Layer |
xy_rank | 此要素类中的要素折点的关联位置精度与参与拓扑的其他要素类中要素折点的关联位置精度之间的相对等级。精度最高的要素类的等级应高于(数字较小,如 1)精度较低的要素类。 | Long |
z_rank | 含 z 值的要素类已将每个折点的高程值嵌入几何。通过设置 z 等级,可影响使用所含 z 测量值精度较低的折点捕捉或聚类含精确 z 值的折点的方式。 | Long |
派生输出
名称 | 说明 | 数据类型 |
out_topology | 已更新的拓扑。 | 拓扑图层 |
代码示例
AddFeatureClassToTopology 示例(独立脚本)
以下独立脚本演示了如何使用 AddFeatureClassToTopology 函数。
# Name: AddFeatureClassToTopology_Example.py
# Description: Adds a feature class to participate in a topology
# Import system modules
import arcpy
arcpy.AddFeatureClassToTopology_management(
r"D:\Calgary\Trans.mdb\Streets\Street_Topo",
r"D:\Calgary\Trans.mdb\Streets\StreetNetwork", 1, 0.1)
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是