| 标注 | 说明 | 数据类型 |
输入上层要素 | 输入线要素图层。该图层所包含的线与输入下层要素参数值中的线相交，并被符号化为上层要素。 | Layer |
输入下层要素 | 输入线要素图层。该图层所包含的线与输入上层要素参数值中的线相交，并被符号化为下层要素。 这些要素将被输出地下通道要素类参数值中创建的面掩膜。 | Layer |
延伸边距 |
沿输入上层要素参数值的掩膜面的长度，即掩膜将延伸超出输入下层要素参数值笔划符号宽度的距离（以页面单位表示）。 此参数值必须大于或等于零。 为边距选择页面单位（磅、毫米等）；默认单位是磅。 | Linear Unit |
覆盖边距 |
穿过输入上层要素参数值的掩膜面的宽度，即掩膜将延伸超出输入上层要素参数值笔划符号宽度的距离（以页面单位表示）。 此参数值必须大于或等于零。 为边距选择页面单位（磅、毫米等）；默认单位是磅。 | Linear Unit |
输出地下通道要素类 |
为存储掩膜输入下层要素参数值的面而创建的输出要素类。 | Feature Class |
输出掩膜关系类 |
为存储地下通道掩膜面和输入下层要素参数值的线之间的连接而创建的输出关系类。 | Relationship Class |
表达式 (可选) | 此 SQL 表达式用于根据输入上层要素参数值选择要素子集。 对于字段名称，请使用引号，例如 "MY_FIELD"。 有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
输出整饰要素类 (可选) | 为存储护栏要素而创建的输出线要素类。 | Feature Class |
翼类型 (可选) | 指定将用于护栏要素的翼类型。
| String |
翼梢长度 (可选) | 护栏翼长度（页面单位）。 其长度必须大于或等于零；默认长度为 1。 为长度选择页面单位（磅、毫米等）；默认单位是磅。 当翼类型参数设置为未创建翼梢时，此参数不适用。 | Linear Unit |
摘要
在两线交点处创建桥护栏和面掩膜来指示地下通道。
插图
使用情况
需要使用符号化相交线要素作为输入。
如果为自重叠要素，则相同的输入可用于输入上层要素和输入下层要素参数值。 如果输入上层要素和输入下层要素参数值相同，则进一步优化要素选择时需要 SQL 表达式。 当使用 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 | 输入线要素图层。该图层所包含的线与 in_below_features 参数值中的线相交，并被符号化为上层要素。 | Layer |
in_below_features | 输入线要素图层。该图层所包含的线与 in_above_features 参数值中的线相交，并被符号化为下层要素。 这些要素将被 out_underpass_feature_class 参数值中创建的面掩膜。 | Layer |
margin_along |
沿 in_above_features 参数值的掩膜面的长度，即掩膜将延伸超出 in_below_features 参数值笔划符号宽度的距离（以页面单位表示）。 此参数值必须大于或等于零。 为边距选择页面单位（磅、毫米等）；默认单位是磅。 | Linear Unit |
margin_across |
穿过 in_above_features 参数值的掩膜面的宽度，即掩膜将延伸超出 in_above_features 参数值笔划符号宽度的距离（以页面单位表示）。 此参数值必须大于或等于零。 为边距选择页面单位（磅、毫米等）；默认单位是磅。 | Linear Unit |
out_underpass_feature_class |
为存储掩膜 in_below_features 参数值的面而创建的输出要素类。 | Feature Class |
out_mask_relationship_class |
为存储地下通道掩膜面和 in_below_features 参数值的线之间的连接而创建的输出关系类。 | Relationship Class |
where_clause (可选) | 此 SQL 表达式用于根据 in_above_features 参数值选择要素子集。 对于字段名称，请使用引号，例如 "MY_FIELD"。 有关 SQL 语法的详细信息，请参阅在 ArcGIS 中使用的查询表达式的 SQL 参考。 | SQL Expression |
out_decoration_feature_class (可选) | 为存储护栏要素而创建的输出线要素类。 | Feature Class |
wing_type (可选) | 指定将用于护栏要素的翼类型。
| String |
wing_tick_length (可选) | 护栏翼长度（页面单位）。 其长度必须大于或等于零；默认长度为 1。 为长度选择页面单位（磅、毫米等）；默认单位是磅。 当 wing_type 参数设置为 NONE 时，此参数不适用。 | Linear Unit |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CreateUnderpass 函数。
import arcpy
arcpy.env.workspace = "C:\data"
arcpy.env.referenceScale = "50000"
arcpy.cartography.CreateUnderpass("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: 是