フィーチャ → ポイント (データ管理ツール)

サマリー

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

図

フィーチャ → ポイントツールの図

使用法

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

パラメーター

Dialog
Python

ラベル	説明	データタイプ
入力フィーチャ	マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。	Feature Layer
出力フィーチャクラス	出力ポイントフィーチャクラス。	Feature Class
インサイド (オプション)	出力ポイントが入力フィーチャ内に配置されるか、または入力フィーチャの重心に配置されるかを指定します。このパラメーターがオフの場合、各出力ポイントの位置は次のようにして決定されます。 Multipoint features—出力ポイントは、マルチポイントに含まれるすべてのポイントの XY 座標の平均値になります。 Polyline features—そのラインフィーチャに含まれるすべてのラインセグメントの中間点の XY 座標の加重平均値に出力ポイントが配置されます。この場合、当該中間点の加重は、対応するラインセグメントの長さになります。パラメトリックカーブ (数式に基づく滑らかな曲線) は、ポイントの挿入により、連続する線分の集りに変換されます。 Polygon features—そのポリゴンの重心に出力ポイントが配置されます。このパラメーターがオンの場合、入力フィーチャの代表点の位置は入力フィーチャに内包されることになり、次のようにして決定されます。 Multipoint features—出力ポイントはそのマルチポイント内のポイントの 1 つに一致します。 Polyline features—出力ポイントはライン上に配置されます。ラインがパラメトリックカーブ (トゥルーカーブ) である場合、出力ポイントはそのラインの中間点に位置します。 Polygon features—出力ポイントはそのポリゴン内部にあります。オン—出力ポイントは入力フィーチャ内に配置されます。オフ—出力ポイントは入力フィーチャの重心に配置されます。出力ポイントは常に入力フィーチャに内包されるとは限りません。これがデフォルトです。	Boolean

ラベル

説明

データタイプ

入力フィーチャ

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

Feature Layer

出力フィーチャクラス

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

Feature Class

インサイド

(オプション)

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

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

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

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

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

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

Boolean

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

名前説明データタイプ

名前	説明	データタイプ
in_features	マルチポイント、ライン、ポリゴン、またはアノテーションのいずれかである入力フィーチャ。	Feature Layer
out_feature_class	出力ポイントフィーチャクラス。	Feature Class
point_location (オプション)	出力ポイントが入力フィーチャ内に配置されるか、または入力フィーチャの重心に配置されるかを指定します。このパラメーターが `CENTROID` に設定された場合、各出力ポイントの位置は次のようにして決定されます。 Multipoint features—出力ポイントは、マルチポイントに含まれるすべてのポイントの XY 座標の平均になります。 Polyline features—そのラインフィーチャに含まれるすべてのラインセグメントの中間点の XY 座標の加重平均値に出力ポイントが配置されます。この場合、当該中間点の加重は、対応するラインセグメントの長さになります。パラメトリックカーブ (数式に基づく滑らかな曲線) は、ポイントの挿入により、連続する線分の集りに変換されます。 Polygon features—そのポリゴンの重心に出力ポイントが配置されます。このパラメーターが `INSIDE` に設定された場合、入力フィーチャの代表点の位置は入力フィーチャに内包されることになり、次のようにして決定されます。 Multipoint features—出力ポイントはそのマルチポイント内のポイントの 1 つに一致します。 Polyline features—出力ポイントはライン上に配置されます。ラインがパラメトリックカーブ (トゥルーカーブ) である場合、出力ポイントはそのラインの中間点に位置します。 Polygon features—出力ポイントはそのポリゴン内部にあります。 `INSIDE`—出力ポイントは入力フィーチャ内に配置されます。 `CENTROID`—出力ポイントは入力フィーチャの重心に配置されます。出力ポイントは常に入力フィーチャに内包されるとは限りません。これがデフォルトです。	Boolean

in_features

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

Feature Layer

out_feature_class

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

Feature Class

point_location

(オプション)

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

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

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

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

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

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

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")

環境

現在のワークスペース, スクラッチワークスペース, 出力データのデフォルト Z 値, M 座標精度, M 許容値, 出力データの M ドメイン, 出力データの Z ドメイン, 出力座標系, 範囲, 出力データに M 値を含む, 出力データに Z 値を含む, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

フィーチャ → ポイント (データ管理ツール)

サマリー

図

使用法

パラメーター

環境

ライセンス情報

関連トピック