ラインの交点からの長さが指定した長さより短いセグメント (ダングル) を削除します。 片方または両方の端点が別のラインと接していないラインの、交点からの長さが指定した長さより短いセグメント (ダングル) だけが削除されます。
このツールは品質管理タスクを目的としています。たとえば、適切なスナップ環境が設定されていない状態でフィーチャをデジタイズした場合、このツールを使用してトポロジ エラーを修正します。
![[ラインの切詰め (Trim Line)] の図](GUID-CD720D82-086D-4F11-BFB4-AF2B0767BBB8-web.png "[ラインの切詰め (Trim Line)] の図")
このツールを実行すると、入力データが変更されます。詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。
片方または両方の端点が別のラインと接していないラインが切詰められます。 この条件を満たすラインには次の 2 種類があります。
[ダングルの長さ] が指定されていない場合、ダングル (片方または両方の端点が別のラインと接していないラインのセグメント) は長さに関わらず交点の位置ですべて削除されます。
[短いフィーチャの削除] オプションを使用した場合、全体の長さが [ダングルの長さ] で指定されている長さ以下の独立したフィーチャもすべて削除されます。 このオプションを使用しない場合、ダングルだけが削除されます。
フィーチャが選択されているフィーチャ レイヤーまたはフィーチャクラスを入力として使用した場合、選択されているフィーチャだけが切詰められます。 削除すべきダングルが存在するかどうかはレイヤーまたはフィーチャクラス内のすべてのフィーチャを基に判定されますが、切詰められるのは選択されているフィーチャだけです。
このツールでは、ジオデータベース フィーチャクラス内の長さ以外のフィーチャ属性は変更されません。
| ラベル | 説明 | データ タイプ |
入力フィーチャ | 切詰める入力ライン フィーチャ。 | Feature Layer |
ダングルの長さ (オプション) | [ダングルの長さ] で指定した長さ以下で、かつ別のラインとの交点で終了していないセグメント (ダングル) が削除されます。 [ダングルの長さ] が指定されていない場合、ダングル (片方または両方の端点が別のラインと接していないラインのセグメント) は長さに関わらず交点の位置ですべて削除されます。 | Linear Unit |
短いフィーチャの削除 (オプション) | ダングル長より短い独立したセグメントを削除するかどうかを指定します。
| Boolean |
| ラベル | 説明 | データ タイプ |
| 更新された入力フィーチャ | 更新された入力フィーチャ。 | Feature Class |
arcpy.edit.TrimLine(in_features, {dangle_length}, {delete_shorts})| 名前 | 説明 | データ タイプ |
in_features | 切詰める入力ライン フィーチャ。 | Feature Layer |
dangle_length (オプション) | [ダングルの長さ] で指定した長さ以下で、かつ別のラインとの交点で終了していないセグメント (ダングル) が削除されます。 [ダングルの長さ] が指定されていない場合、ダングル (片方または両方の端点が別のラインと接していないラインのセグメント) は長さに関わらず交点の位置ですべて削除されます。 | Linear Unit |
delete_shorts (オプション) | ダングル長より短い独立したセグメントを削除するかどうかを指定します。
| Boolean |
| 名前 | 説明 | データ タイプ |
| out_feature_class | 更新された入力フィーチャ。 | Feature Class |
次の Python ウィンドウ スクリプトは、TrimLine 関数の使用方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TrimLine_edit("majorrds.shp", "15 Feet", "DELETE_SHORT")適切なスナップ環境が設定されていない状態でデジタイズされた道路の中心線をクリーンナップします。
# Name: ExtendLine.py
# Description: Clean up street centerlines that were digitized without
# having set proper snapping environments
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Make backup copy of streets feature class, since modification with
# the Editing tools below is permanent
streets = "majorrds.shp"
streetsBackup = "C:/output/Output.gdb/streetsBackup"
arcpy.CopyFeatures_management(streets, streetsBackup)
# Trim street lines to clean up dangles
arcpy.TrimLine_edit(streets, "10 Feet", "KEEP_SHORT")
# Extend street lines to clean up dangles
arcpy.ExtendLine_edit(streets, "15 Feet", "EXTENSION")