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

サマリー

入力フィーチャを代表する位置に生成されたポイントを含むフィーチャクラスを作成します。

図

使用法

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

• ダイアログ ボックスの [インサイド] オプションがオフの場合 (point_location パラメーターが CENTROID に設定されている)、出力ポイントの位置は次のようにして決定されます。

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

  ダイアログ ボックスの [インサイド] オプションがオンの場合 (point_location パラメーターが INSIDE に設定されている)、入力フィーチャの代表点の位置は入力フィーチャに内包されることになり、次のようにして決定されます。

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。	Feature Layer
出力フィーチャクラス	出力ポイント フィーチャクラス。	Feature Class
インサイド (オプション)	出力ポイントの位置として、入力フィーチャの象徴的中心を使用するか、入力フィーチャに内包される位置を使用するかを指定します。 オフ - 出力ポイントの位置として、入力フィーチャの象徴的中心を使用します。 この位置は常に入力フィーチャに内包されるとは限りません。 これがデフォルトです。 オフ - 出力ポイントの位置として、入力フィーチャに内包される位置を使用します。	Boolean

Python

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})

名前	説明	データ タイプ
in_features	マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。	Feature Layer
out_feature_class	出力ポイント フィーチャクラス。	Feature Class
point_location (オプション)	出力ポイントの位置として、入力フィーチャの象徴的中心を使用するか、入力フィーチャに内包される位置を使用するかを指定します。 CENTROID—出力ポイントの位置として、入力フィーチャの象徴的中心を使用します。 このポイントの位置は常に入力フィーチャに内包されるとは限りません。 これがデフォルトです。 INSIDE—出力ポイントの位置として、入力フィーチャに内包される位置を使用します。	Boolean

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToPoint_management("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.FeatureToPoint_management(inFeatures, outFeatureClass, "INSIDE")

環境

現在のワークスペース, テンポラリ ワークスペース, 出力データのデフォルト Z 値, M 座標精度, M 許容値, 出力データの M ドメイン, 出力データの Z ドメイン, 出力座標系, 範囲, 出力に M 値がある, 出力に Z 値がある, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes