フィーチャ → ポイント (Feature To Point) (データ管理)

サマリー

入力フィーチャの重心から生成される、または入力フィーチャ内に配置されているポイントを含むフィーチャクラスを作成します。

フィーチャ → ポイント (Feature to Point) ツールの図

使用法

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

パラメーター

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

マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。

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

出力ポイント フィーチャクラス。

Feature Class
インサイド
(オプション)

出力ポイントが入力フィーチャ内に配置されるか、または入力フィーチャの重心に配置されるかを指定します。

  • オフ - 出力ポイントは入力フィーチャの重心に配置されます。 出力ポイントは常に入力フィーチャに内包されるとは限りません。 これがデフォルトです。
  • オン - 出力ポイントは入力フィーチャ内に配置されます。

[インサイド] パラメーターがオフの場合、各出力ポイントの位置は次のようにして決定されます。

  • マルチポイント フィーチャ - 出力ポイントは、マルチポイントに含まれるすべてのポイントの XY 座標の平均値になります。
  • ポリライン フィーチャ - そのライン フィーチャに含まれるすべてのライン セグメントの中間点の XY 座標の加重平均値に出力ポイントが配置されます。この場合、当該中間点のウェイトは、対応するライン セグメントの長さになります。 パラメトリック カーブ (数式に基づく滑らかな曲線) は、ポイントの挿入により、連続する線分の集りに変換されます。
  • ポリゴン フィーチャ - そのポリゴンの重心に出力ポイントが配置されます。

[インサイド] パラメーターがオンの場合、入力フィーチャの代表点の位置は入力フィーチャに内包されることになり、次のようにして決定されます。

  • マルチポイント フィーチャ - 出力ポイントはそのマルチポイント内のポイントの 1 つに一致します。
  • ポリライン フィーチャ - 出力ポイントはライン上に配置されます。 ラインがパラメトリック カーブ (トゥルー カーブ) である場合、出力ポイントはそのラインの中間点に位置します。
  • ポリゴン フィーチャ - 出力ポイントはそのポリゴン内部にあります。

Boolean

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
名前説明データ タイプ
in_features

マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。

Feature Layer
out_feature_class

出力ポイント フィーチャクラス。

Feature Class
point_location
(オプション)

出力ポイントが入力フィーチャ内に配置されるか、または入力フィーチャの重心に配置されるかを指定します。

  • CENTROID出力ポイントは入力フィーチャの重心に配置されます。 出力ポイントは常に入力フィーチャに内包されるとは限りません。 これがデフォルトです。
  • INSIDE出力ポイントは入力フィーチャ内に配置されます。

point_location パラメーターが CENTROID に設定された場合、各出力ポイントの位置は次のようにして決定されます。

  • マルチポイント フィーチャ - 出力ポイントは、マルチポイントに含まれるすべてのポイントの XY 座標の平均値になります。
  • ポリライン フィーチャ - そのライン フィーチャに含まれるすべてのライン セグメントの中間点の XY 座標の加重平均値に出力ポイントが配置されます。この場合、当該中間点のウェイトは、対応するライン セグメントの長さになります。 パラメトリック カーブ (数式に基づく滑らかな曲線) は、ポイントの挿入により、連続する線分の集りに変換されます。
  • ポリゴン フィーチャ - そのポリゴンの重心に出力ポイントが配置されます。

point_location パラメーターが INSIDE に設定された場合、入力フィーチャの代表点の位置は入力フィーチャに内包されることになり、次のようにして決定されます。

  • マルチポイント フィーチャ - 出力ポイントはそのマルチポイント内のポイントの 1 つに一致します。
  • ポリライン フィーチャ - 出力ポイントはライン上に配置されます。 ラインがパラメトリック カーブ (トゥルー カーブ) である場合、出力ポイントはそのラインの中間点に位置します。
  • ポリゴン フィーチャ - 出力ポイントはそのポリゴン内部にあります。

Boolean

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
FeatureToPoint の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、スクリプト環境で FeatureToPoint 関数を適用する方法を示した単純な例です。

# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

#  Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"

# Use FeatureToPoint function to find a point inside each park
arcpy.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")