フィーチャ → ポリゴン(Feature To Polygon) (データの管理)
サマリ
入力ライン フィーチャまたはポリゴン フィーチャによって囲まれるエリアに生成されるポリゴンを含むフィーチャクラスを作成します。
図
使用法
-
1 つ以上の入力フィーチャによって 1 つの閉じたエリアが形成される場合に新しいポリゴン フィーチャが作成され、出力フィーチャクラスに書き込まれます。出力の属性は、ダイアログ ボックスの [属性を保存] オプション(スクリプトの attributes パラメータ)と [ラベル フィーチャ] オプション(スクリプトの label_features パラメータ)によって異なります。
-
複数のフィーチャクラスまたはレイヤが入力フィーチャのリストで指定されている場合、それらのエントリの順序は出力フィーチャ タイプに影響を与えません。ただし、このツールのダイアログ ボックスで、リストの最上位にあるエントリ(スクリプトでは最初のエントリ)の空間参照が処理で使用され、出力に設定されます。
-
入力フィーチャのパラメトリック カーブ(トゥルー カーブ)は、フィーチャが分割された場合でも出力ポリゴンでトゥルー カーブのまま維持されます。これは、シェープファイル データには適用されません。
-
注意:
[属性を保存] パラメータ(スクリプトの attributes パラメータ)は無効であり、使用することはできません。スクリプトまたはモデルの後方互換性を維持するため、このパラメータは削除されません。以下で説明するように、特定の入力値の組み合わせでは、出力の属性スキーマおよびフィールド値が生成されることがありますが、それらのほとんどは、意図した出力ではありません。
ダイアログ ボックスの [属性を保存] オプションがオンの場合(スクリプトで attributes パラメータが ATTRIBUTES に設定されている)、ラベル フィーチャ(ポイント)が指定されるかどうかによって次のようになります。
- [ラベル フィーチャ] が指定されていない場合は、各入力エントリの属性スキーマ(フィールド値ではなく、フィールド名とプロパティ)が、入力リストに表示されている順番で出力に保存されます。新規フィールドである FID_xxx(xxx は、該当する入力エントリのソース フィーチャクラス名)が各入力エントリの出力に追加され、値が -1 に設定されます。他のすべてのフィールドには 0 または NULL 値が設定されます。
- [ラベル フィーチャ] が指定されている場合、入力属性スキーマはいずれも出力フィーチャクラスに保存されず、ラベル フィーチャの属性のみが出力フィーチャクラスに含まれます。出力ポリゴンに 1 つのラベル フィーチャが含まれる場合は、出力ポリゴンにそのラベル フィーチャのフィールド値が設定されます。出力ポリゴンに複数のラベル フィーチャが含まれる場合は、それらのフィーチャの 1 つのフィールド値が出力ポリゴンに設定されます。出力ポリゴンにラベル フィーチャが含まれない場合は、出力ポリゴンに 0 または NULL フィールド値が設定されます。
ダイアログ ボックスの [属性を保存] オプションがオフの場合(スクリプトで attributes パラメータが NO_ATTRIBUTES に設定されている場合)、入力属性スキーマが出力に書き込まれても、属性値は空になります。出力ポリゴン フィーチャクラスに属性を一切含めたくない場合は、[ラベリング] パラメータに、属性のないポイント フィーチャクラスを指定してください。
-
入力ポリゴン フィーチャがより小さな出力ポリゴン フィーチャに分割される場合は、[アイデンティティ(Identity)] ツールを使用して、入力ポリゴン フィーチャの属性を結果として生成されたポリゴン フィーチャに引き継ぐことができます。
-
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
構文
パラメータ | 説明 | データ タイプ |
in_features [in_features,...] |
ラインまたはポリゴン、またはその両方である入力フィーチャ。 | Feature Layer |
out_feature_class |
出力ポリゴン フィーチャクラス。 | Feature Class |
cluster_tolerance (オプション) |
すべてのフィーチャ座標の最短距離、および空間計算の間に X 方向、Y 方向、XY 方向に座標を移動できる距離。デフォルトの XY 許容値は、0.001 メートル、またはフィーチャ単位でそれに相当する値に設定されます。 | Linear unit |
attributes (オプション) |
入力の属性スキーマまたはラベル フィーチャの属性を出力フィーチャクラスに保存するか、入力の属性をすべて出力フィーチャクラスに保存しないかを指定します。このパラメータは無効であり、スクリプトまたはモデルの後方互換性を維持するため、このパラメータは削除されません。使用上の注意で説明したように、特定の入力の組み合わせでは、出力の属性スキーマおよびフィールド値が生成されることがありますが、それらのほとんどは、意図した出力ではありません。
| Boolean |
label_features (オプション) |
出力ポリゴン フィーチャへと引き継がれる属性を保持するオプションの入力ポイント フィーチャ。 | Feature Layer |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで FeatureToPolygon(フィーチャ → ポリゴン)関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES", "")
次のスタンドアロン スクリプトは、FeatureToPolygon(フィーチャ → ポリゴン)関数をスクリプティング環境に適用する単純な例を示しています。
# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
# from park boundaries and rivers.
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/parks_analysis.gdb"
# Set local parameters
inFeatures = ["park_boundaries", "rivers"]
outFeatureClass = "c:/output/output.gdb/habitat_areas"
clusTol = "0.05 Meters"
# Use the FeatureToPolygon function to form new areas
arcpy.FeatureToPolygon_management(inFeatures, outFeatureClass, clusTol,
"NO_ATTRIBUTES", "")