描述
通过创建桥护栏和覆盖基础路段的掩膜，可以将相交线以一条线在另一条线下方穿过的方式显示。
插图
使用方法
需要使用符号化相交线要素作为输入。
此工具与创建天桥工具相同，只是在此工具中，Expression 参数从输入下层要素参数中选择，而在创建天桥工具中，则从输入上层要素参数中选择。
-
如果是自叠置要素，则输入上层要素图层可以与输入下层要素图层相同。当“输入上层要素”和“输入下层要素”图层相同时，进一步优化要素选择时需要 SQL 表达式。
语法
arcpy.cartography.CreateUnderpass(in_above_features, in_below_features, margin_along, margin_across, out_underpass_feature_class, out_mask_relationship_class, {where_clause}, {out_decoration_feature_class}, {wing_type}, {wing_tick_length})| 参数 | 说明 | 数据类型 |
in_above_features | 输入线要素图层。该图层所包含的线与输入下层要素参数中的线相交，并被符号化为上层要素。 | Layer |
in_below_features | 输入线要素图层会与输入上层要素参数中的线相交，并被符号化为下层要素。这些要素将被输出地下通道要素类参数中创建的面掩膜。 | Layer |
margin_along |
设置沿输入上层要素参数的掩膜面的长度，方法是以页面单位指定掩膜应超出输入下层要素参数笔划符号宽度的距离。必须指定延伸边距参数，而且其必须大于或等于零。为边距选择页面单位；默认值是磅。 | Linear Unit |
margin_across |
设置穿过输入上层要素参数的掩膜面的宽度，方法是以页面单位指定掩膜应超出输入下层要素参数笔划符号宽度的距离。必须指定覆盖边距参数，而且其必须大于或等于零。为边距选择页面单位；默认值是磅。 | Linear Unit |
out_underpass_feature_class |
为存储掩膜输入下层要素参数的面而创建的输出要素类。 | Feature Class |
out_mask_relationship_class |
为存储地下通道掩膜面和输入下层要素参数的线之间的连接而创建的输出关系类。 | Relationship Class |
where_clause （可选） | 此 SQL 表达式用于选择输入上层要素参数中的要素子集。 使用引号："MY_FIELD"；或者如果要查询个人地理数据库，需将字段用方括号括起：[MY_FIELD] 有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
out_decoration_feature_class （可选） | 为存储护栏要素而创建的输出线要素类。 | Feature Class |
wing_type （可选） | 指定护栏要素的翼类型。
| String |
wing_tick_length （可选） | 以页面单位设置护栏翼的长度。其长度必须大于或等于零；默认长度为 1。为长度选择页面单位（磅、毫米等）；默认单位是磅。此参数不适用于 NONE 翼类型。 | Linear Unit |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CreateUnderpass 工具。
import arcpy
arcpy.env.workspace = "C:\data"
arcpy.env.referenceScale = "50000"
arcpy.CreateUnderpass_cartography("roads.lyr", "railroads.lyr", "2 Points", "1 Points",
"cartography.gdb/transportation/under_mask_fc",
"cartography.gdb/transportation/under_mask_rc", "'RelationshipToSurface' = 3",
"cartography.gdb/transportation/tunnel", "PARALLEL", "1 Points")此独立脚本显示的是使用 CreateUnderpass 工具的示例。
# Name: CreateUnderpass_standalone_script.py
# Description: creates a mask where one feature
# is visually below another feature
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
env.referenceScale = "50000"
# Set local variables
in_above_features = "roads.lyr"
in_below_features = "railroads.lyr"
margin_along = "2 Points"
margin_across = "1 Points"
out_overpass_feature_class = "cartography.gdb/trans/under_mask_fc"
out_mask_relationship_class = "cartography.gdb/trans/under_mask_rc"
where_clause = "'RelationshipToSurface' = 3"
out_decoration_feature_class = "cartography.gdb/trans/tunnel"
wing_type = "PARALLEL"
wing_tick_length = "1 Points"
# Execute Create Underpass
arcpy.CreateUnderpass_cartography(in_above_features,
in_below_features,
margin_along,
margin_across,
out_overpass_feature_class,
out_mask_relationship_class,
where_clause,
out_decoration_feature_class,
wing_type,
wing_tick_length)许可信息
- Basic: 否
- Standard: 否
- Advanced: 是