ティーセン ポリゴンの作成 (Create Thiessen Polygons) (解析)

Advanced のライセンスで利用可能。

概要

ポイント フィーチャからティーセン ポリゴンを作成します。

各ティーセン ポリゴンにはポイント入力フィーチャが 1 つだけ含まれます。それぞれのポイント入力フィーチャについて、それが距離的に最も近いポイント入力フィーチャである範囲がティーセン ポリゴンとなります。

Thiessen illustration

使用法

  • このツールは、入力ポイント フィーチャに含まれる領域を、ティーセン (近接) ゾーンに分割するために使用されます。それぞれの入力ポイントについて、それが距離的に最も近い入力ポイントである範囲がティーセン ゾーンとなる領域全体を表します。

  • 詳細:

    ティーセン ポリゴンを作成するための理論的な背景は以下のとおりです。

    • S が座標空間またはユークリッド空間のポイントのセット (x,y)、p がその空間の任意のポイントである場合、p に最も近い S のポイントは 1 つある (ポイント p が 2 つ以上の S のポイントから等距離にある場合を除く)。
    • 単一の近接ポリゴン (Voronoi セル) は S 内の単一ポイントに最も近いすべてのポイント p によって定義される。つまり、すべてのポイント p から S のあらゆる他のポイントまでの距離よりも、S の所定のポイントまでの距離が短い場合の合計面積。
  • ティーセン近接ポリゴンは、次のようにして構築されます。

    • すべてのポイントが、ドローネ基準に一致する TIN (Triangulated Irregular Network) に構造化されます。
    • 各三角形エッジの垂直二等分線が生成され、ティーセン ポリゴンのエッジを形成します。二等分線が交差する位置によって、ティーセン ポリゴンの頂点の位置が決まります。
  • 出力ティーセン ポリゴン フィーチャクラスの外側の境界線は、ポイント入力フィーチャに 10 %を加えた範囲です。範囲環境が特定の範囲ウィンドウに設定されている場合、このツールは外側の境界線を設定するのに環境設定を使用します。

  • 注意:

    このツールが使用するドローネ三角形分割法は投影座標系で使用した場合に最も効果的であるため、地理座標系のデータに使用すると、予想外の結果になる可能性があります。

構文

arcpy.analysis.CreateThiessenPolygons(in_features, out_feature_class, {fields_to_copy})
パラメーター説明データ タイプ
in_features

ティーセン ポリゴンの生成元となるポイント入力フィーチャ。

Feature Layer
out_feature_class

ポイント入力フィーチャから生成されるティーセン ポリゴンを含む、出力フィーチャクラス。

Feature Class
fields_to_copy
(オプション)

入力フィーチャのどのフィールドを出力フィーチャクラスへ渡すかを指定します。

  • ONLY_FID入力フィーチャの FID フィールドのみを出力フィーチャクラスへ渡します。これがデフォルトです。
  • ALL入力フィーチャのすべてのフィールドを出力フィーチャクラスへ渡します。
String

コードのサンプル

CreateThiessenPolygons (ティーセン ポリゴンの作成) の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで CreateThiessenPolygons (ティーセン ポリゴンの作成) ツールを使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.CreateThiessenPolygons_analysis("schools", "c:/output/output.gdb/thiessen1", "ALL")
CreateThiessenPolygons (ティーセン ポリゴンの作成) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、CreateThiessenPolygons (ティーセン ポリゴンの作成) 関数を使用する方法を示しています。

# Name: CreateThiessenPolygons_Example2.py
# Description: Creates Thiessen polygons
 
# Import system modules
#
import arcpy
from arcpy import env
 
# Set environment settings
#
env.workspace = "C:/data/data.gdb"
 
# Set local variables
#
inFeatures = "schools"
outFeatureClass = "c:/output/output.gdb/thiessen1"
outFields = "ALL"
 
# Execute CreateThiessenPolygons
#
arcpy.CreateThiessenPolygons_analysis(inFeatures, outFeatureClass, outFields)

ライセンス情報

  • Basic: いいえ
  • Standard: いいえ
  • Advanced: はい

関連トピック