ラインに沿ってポイントを生成 (Generate Points Along Lines) (データ管理)

サマリー

固定間隔またはフィーチャの長さのパーセンテージ基準でラインまたはポリゴンに沿ってポイント フィーチャを作成します。

使用法

  • 入力フィーチャの属性は、出力フィーチャクラス内に保持されます。その出力フィーチャクラスに追加された新しいフィールド ORIG_FID は、入力フィーチャ ID に設定されます。

    [累積距離およびシーケンス フィールドの追加] パラメーターがオンの場合は、以下のフィールドが追加されます。

    • ORIG_LEN- ラインの始点からラインに沿ったポイントまでの累積距離。 距離の値は [入力フィーチャ] 値の空間参照の単位で追加されます。
    • ORIG_SEQ- 各入力ラインから作成されるポイント順の各ポイントのシーケンス番号。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

ポイントに変換されるラインまたはポリゴン フィーチャ。

Feature Layer
出力フィーチャクラス

入力フィーチャから作成されるポイント フィーチャクラス。

Feature Class
ポイントの配置

ポイントの作成に使用する方法を指定します。

  • パーセンテージによる指定[パーセンテージ] パラメーター値を使用して、パーセントを基準にフィーチャに沿ってポイントを配置します。
  • 距離による指定[距離] パラメーター値を使用して、一定の間隔でラインに沿ってポイントを配置します。 これがデフォルトです。
String
距離
(オプション)

フィーチャの始点からの間隔。指定した間隔に基づいてポイントが配置されます。

Linear Unit
パーセンテージ
(オプション)

フィーチャの始点からのパーセンテージ。指定したパーセンテージに基づいてポイントが配置されます。 たとえば、パーセンテージを 40 にすると、フィーチャの距離全体の 40 パーセントと 80 パーセントの位置にポイントが配置されます。

Double
端点を含める
(オプション)

フィーチャの始点と終点に追加ポイントを含めるかどうかを指定します。

  • オン - フィーチャの始点と終点に追加ポイントを含めます。
  • オフ - フィーチャの始点と終点に追加ポイントを含めません。 これがデフォルトです。
Boolean
累積距離およびシーケンス フィールドの追加
(オプション)

累積距離およびシーケンス フィールドを出力に追加するかどうかを指定します。

  • オン - 累積距離 (ORIG_LEN) およびシーケンス (ORIG_SEQ) フィールドが出力に追加されます。 距離の値は [入力フィーチャ] 値の空間参照の単位で追加されます。
  • オフ - 累積距離またはシーケンス フィールドが出力に追加されません。 これがデフォルトです。
Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})
名前説明データ タイプ
Input_Features

ポイントに変換されるラインまたはポリゴン フィーチャ。

Feature Layer
Output_Feature_Class

入力フィーチャから作成されるポイント フィーチャクラス。

Feature Class
Point_Placement

ポイントの作成に使用する方法を指定します。

  • PERCENTAGEPercentage パラメーター値を使用して、パーセントを基準にフィーチャに沿ってポイントを配置します。
  • DISTANCEDistance パラメーター値を使用して、一定の間隔でラインに沿ってポイントを配置します。 これがデフォルトです。
String
Distance
(オプション)

フィーチャの始点からの間隔。指定した間隔に基づいてポイントが配置されます。

Linear Unit
Percentage
(オプション)

フィーチャの始点からのパーセンテージ。指定したパーセンテージに基づいてポイントが配置されます。 たとえば、パーセンテージを 40 にすると、フィーチャの距離全体の 40 パーセントと 80 パーセントの位置にポイントが配置されます。

Double
Include_End_Points
(オプション)

フィーチャの始点と終点に追加ポイントを含めるかどうかを指定します。

  • END_POINTSフィーチャの始点と終点に追加ポイントを含めます。
  • NO_END_POINTSフィーチャの始点と終点に追加ポイントを含めません。 これがデフォルトです。
Boolean
Add_Chainage_Fields
(オプション)

累積距離およびシーケンス フィールドを出力に追加するかどうかを指定します。

  • ADD_CHAINAGE累積距離 (ORIG_LEN) およびシーケンス (ORIG_SEQ) フィールドが出力に追加されます。 距離の値は Input_Features 値の空間参照の単位で追加されます。
  • NO_CHAINAGE累積距離およびシーケンス フィールドが出力に追加されません。 これがデフォルトです。
Boolean

コードのサンプル

GeneratePointsAlongLines の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで GeneratePointsAlongLines 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.management.GeneratePointsAlongLines('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)
GeneratePointsAlongLines の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、GeneratePointsAlongLines 関数を使用する方法を示します。

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Run GeneratePointsAlongLines by distance
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Run GeneratePointsAlongLines by percentage
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

関連トピック