アンダーパスの作成 (Create Underpass) (カートグラフィ)—ArcMap

概要
図
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

ライン交差部にブリッジパラペットおよびポリゴンマスクを作成してアンダーパス (低路交差) を示します。

図

[アンダーパスの作成 (Create Underpass)] ツールのオプションの図 — 下の青色のラインフィーチャが上の赤色のラインフィーチャと交差する位置で、下の青色のラインフィーチャを隠すためのマージンの寸法から、黄色のポリゴンマスクが作成されます。角度付きのウィングティックを含む灰色のブリッジパラペット装飾も作成されます。

使用法

入力としてストロークリプレゼンテーションでシンボル表示した交差ラインフィーチャが必要です。
[アンダーパスの作成 (Create Underpass)] ツールは [オーバーパスの作成 (Create Overpass)] ツールとほぼ同じです。異なる点は、[アンダーパスの作成 (Create Underpass)] ツールでは [式] パラメーターが同ツールにある [リプレゼンテーションを持つ入力フィーチャ (下部)] パラメーターから選択を行い、[オーバーパスの作成 (Create Overpass)] ツールにある [リプレゼンテーションを持つ入力フィーチャ (上部)] パラメーターからも選択を行うという点です。
自己オーバーラップフィーチャの例では、[リプレゼンテーションを持つ入力フィーチャ (上部)] レイヤーは [リプレゼンテーションを持つ入力フィーチャ (下部)] レイヤーと一致している場合があります。入力 (上部) および入力 (下部) のリプレゼンテーションが一致している場合、フィーチャの選択範囲を絞り込むには 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	[リプレゼンテーションを持つ入力フィーチャ (下部)] パラメーターのストロークシンボルの幅を超えてマスクが延在するようにページ単位の距離を指定して、[リプレゼンテーションを持つ入力フィーチャ (上部)] パラメーターの横方向に沿ったマスクポリゴンの長さを設定します。 [横の余白] パラメーターには、0 以上の値を指定する必要があります。余白のページ単位を選択します。デフォルトはポイントです。	Linear Unit
margin_across	[リプレゼンテーションを持つ入力フィーチャ (下部)] パラメーターのストロークシンボルの幅を超えてマスクが延在するようにページ単位の距離を指定して、[リプレゼンテーションを持つ入力フィーチャ (上部)] パラメーターの縦方向に沿ったマスクポリゴンの幅を設定します。 [縦の余白] パラメーターには、0 以上の値を指定する必要があります。余白のページ単位を選択します。デフォルトはポイントです。	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 (オプション)	パラペットフィーチャのウィングスタイルを指定します。 ANGLED —パラペットのウィングティックが、 [入力フィーチャ (上部)] パラメーターと [入力フィーチャ (下部)] パラメーターの間で角度をなします。これがデフォルトです。 PARALLEL —アンダーパスウィングのウィングティックが、[入力フィーチャ (下部)] パラメーターに対して平行になります。 NONE —ウィングティックがパラペット上に作成されません。	String
wing_tick_length (オプション)	ページ単位でのパラペットウィングの長さです。長さには 0 以上の値を指定する必要があります。デフォルトの長さは 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: はい

概要

図

使用法

構文

コードのサンプル

CreateUnderpass (アンダーパスの作成) の例 1 (Python ウィンドウ)

CreateUnderpass (アンダーパスの作成) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

CreateUnderpass (アンダーパスの作成) の例 2 (スタンドアロンスクリプト)