Advanced のライセンスで利用可能。
サマリ
入力ライン フィーチャまたはポリゴン フィーチャによって囲まれるエリアに生成されるポリゴンを含むフィーチャクラスを作成します。
図
使用法
1 つ以上の入力フィーチャによって 1 つの閉じたエリアが形成される場合に新しいポリゴン フィーチャが作成され、出力フィーチャクラスに書き込まれます。出力の属性は、ダイアログ ボックスの [属性の保存] オプション (スクリプトの attributes パラメーター) と [ラベル フィーチャ] オプション (スクリプトの label_features パラメーター) によって異なります。
複数のフィーチャクラスまたはレイヤーが入力フィーチャのリストで指定されている場合、それらのエントリの順序は出力フィーチャ タイプに影響を与えません。ただし、このツールのダイアログ ボックスで、リストの最上位にあるエントリ (スクリプトでは最初のエントリ) の空間参照が処理で使用され、出力に設定されます。
入力フィーチャのパラメトリック カーブ (トゥルー カーブ) は、フィーチャが分割された場合でも出力ポリゴンでトゥルー カーブのまま維持されます。これは、シェープファイル データには適用されません。
-
ダイアログ ボックスの [属性の保存] オプションがオンの場合 (スクリプトで attributes パラメーターが ATTRIBUTES に設定されている)、ラベル フィーチャ (ポイント) が指定されるかどうかによって次のようになります。
- [ラベル フィーチャ] が指定されていない場合は、各入力エントリの属性スキーマ (フィールド値ではなく、フィールド名とプロパティ) が、入力リストに表示されている順番で出力に保存されます。新規フィールドである FID_xxx (xxx は、該当する入力エントリのソース フィーチャクラス名) が各入力エントリの出力に追加され、値が -1 に設定されます。他のすべてのフィールドには 0 または NULL 値が設定されます。
- [ラベル フィーチャ] が指定されている場合、入力属性スキーマはいずれも出力フィーチャクラスに保存されず、ラベル フィーチャの属性のみが出力フィーチャクラスに含まれます。出力ポリゴンに 1 つのラベル フィーチャが含まれる場合は、出力ポリゴンにそのラベル フィーチャのフィールド値が設定されます。出力ポリゴンに複数のラベル フィーチャが含まれる場合は、それらのフィーチャの 1 つのフィールド値が出力ポリゴンに設定されます。出力ポリゴンにラベル フィーチャが含まれない場合は、出力ポリゴンに 0 または NULL フィールド値が設定されます。
ダイアログ ボックスの [属性の保存] オプションがオフの場合 (スクリプトで attributes パラメーターが NO_ATTRIBUTES に設定されている場合)、入力属性スキーマが出力に書き込まれても、属性値は空になります。出力ポリゴン フィーチャクラスに属性を一切含めたくない場合は、[ラベリング] パラメーターに、属性のないポイント フィーチャクラスを指定してください。
入力ポリゴン フィーチャがより小さな出力ポリゴン フィーチャに分割される場合は、[アイデンティティ (Identity)] ツールを使用して、入力ポリゴン フィーチャの属性を結果として生成されたポリゴン フィーチャに引き継ぐことができます。
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
構文
FeatureToPolygon_management (in_features, out_feature_class, {cluster_tolerance}, {attributes}, {label_features})| パラメータ | 説明 | データ タイプ |
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 |
コードのサンプル
FeatureToPolygon (フィーチャ → ポリゴン) の例 1 (Python ウィンドウ)
次の 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 (フィーチャ → ポリゴン) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトは、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", "")
環境
ライセンス情報
- ArcGIS for Desktop Basic: ×
- ArcGIS for Desktop Standard: ×
- ArcGIS for Desktop Advanced: ○