创建地下通道 (制图)
摘要
通过创建桥护栏和覆盖基础路段的掩膜，可以将相交线以一条线在另一条线下方穿过的方式显示。
插图
 |
Creating underpass with different wing types |
用法
-
需要使用笔划制图表达符号化的相交线要素作为输入。
此工具与创建天桥工具相同，只是在此工具中，where_clause 参数从输入带制图表达的下层要素参数中选择，而在“创建天桥”工具中，则从输入带制图表达的上层要素参数中选择。
-
如果是自叠置要素，则输入带制图表达的上层要素图层可以与输入带制图表达的下层要素图层相同。当“输入上层要素”和“输入下层要素”制图表达相同时，进一步优化要素选择时需要 SQL 表达式。
语法
| 参数 | 说明 | 数据类型 |
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] 在 Python 窗口中，将 {where_clause} 用括号括起可以确保正确地解释空格（参数之间的分隔符）。 有关 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
from arcpy import env
env.workspace = "C:\data"
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)