描述
在两线交点处创建桥护栏和面掩膜来指示地下通道。
插图
使用方法
需要使用笔划制图表达符号化的相交线要素作为输入。
此工具与创建天桥工具相同,只是在此工具中,表达式参数从带制图表达的输入下层要素参数中选择,而在创建天桥工具中,则从带制图表达的输入上层要素参数中选择。
如果是自叠置要素,则带制图表达的输入上层要素图层可以与带制图表达的输入下层要素图层相同。 当输入上层要素和输入下层要素制图表达相同时,进一步优化要素选择时需要 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 |
代码示例
CreateUnderpass 示例 1(Python 窗口)
以下 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 示例 2(独立脚本)
此独立脚本显示的是使用 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: 是