| 标注 | 说明 | 数据类型 |
输入上层要素 | 输入线要素图层。该图层所包含的线与输入下层要素参数中的线相交，并被符号化为上层要素。 | Layer |
输入下层要素 | 输入线要素图层会与输入上层要素参数中的线相交，并被符号化为下层要素。 这些要素将被输出地下通道要素类参数中创建的面掩膜。 | Layer |
延伸边距 |
设置沿输入上层要素参数的掩膜面的长度，方法是以页面单位指定掩膜应超出输入下层要素参数笔划符号宽度的距离。 必须指定延伸边距参数，而且其必须大于或等于零。 选择页边距单位；默认值为磅。 | Linear Unit |
覆盖边距 |
设置穿过输入上层要素参数的掩膜面的宽度，方法是以页面单位指定掩膜应超出输入下层要素参数笔划符号宽度的距离。 必须指定覆盖边距参数，而且其必须大于或等于零。 选择页边距单位；默认值为磅。 | Linear Unit |
输出地下通道要素类 |
为存储掩膜输入下层要素参数的面而创建的输出要素类。 | Feature Class |
输出掩膜关系类 |
为存储地下通道掩膜面和输入下层要素参数的线之间的连接而创建的输出关系类。 | Relationship Class |
表达式 (可选) | 此 SQL 表达式用于选择输入上层要素参数中的要素子集。 使用引号（例如“MY_FIELD”），或者如果要查询个人地理数据库，需将字段用方括号括起（例如 [MY_FIELD]）。 有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
输出整饰要素类 (可选) | 为存储护栏要素而创建的输出线要素类。 | Feature Class |
翼类型 (可选) | 指定护栏要素的翼类型。
| String |
翼梢长度 (可选) | 护栏翼长度（页面单位）。 其长度必须大于或等于零；默认长度为 1。 为长度选择页面单位（磅、毫米等）；默认单位是磅。 此参数不适用于 NONE 翼类型值。 | Linear Unit |
摘要
在两线交点处创建桥护栏和面掩膜来指示地下通道。
插图
使用情况
需要使用符号化相交线要素作为输入。
此工具与创建天桥工具相同，只是在此工具中，表达式参数从输入下层要素参数中选择，而在创建天桥工具中，则从输入上层要素参数中选择。
-
如果是自叠置要素，则输入上层要素图层可以与输入下层要素图层相同。 当输入上层要素和输入下层要素图层相同时，进一步优化要素选择时需要 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: 是