Advanced のライセンスで利用可能。
概要
入力ライン フィーチャまたはポリゴン フィーチャによって囲まれるエリアに生成されるポリゴンを含むフィーチャクラスを作成します。
図
使用法
1 つ以上の入力フィーチャによって 1 つの閉じたエリアが形成される場合に新しいポリゴン フィーチャが作成され、出力フィーチャクラスに書き込まれます。出力の属性は、ダイアログ ボックスの [属性の保存] オプション (スクリプトの attributes パラメーター) と [ラベル フィーチャ] オプション (スクリプトの label_features パラメーター) によって異なります。
複数のフィーチャクラスまたはレイヤーが入力フィーチャのリストで指定されている場合、それらのエントリの順序は出力フィーチャ タイプに影響を与えません。ただし、このツールのダイアログ ボックスで、リストの最上位にあるエントリの空間参照が処理で使用され、出力に設定されます。
入力フィーチャのパラメトリック カーブ (トゥルー カーブ) は、フィーチャが分割された場合でも出力ポリゴンでトゥルー カーブのまま維持されます。これは、シェープファイル データには適用されません。
メモ:
[属性の保存] パラメーター (スクリプトの attributes パラメーター) は無効であり、使用することはできません。スクリプトまたはモデルの後方互換性を維持するため、このパラメーターは削除されません。以下で説明するように、特定の入力値の組み合わせでは、出力の属性スキーマおよびフィールド値が生成されることがありますが、それらのほとんどは、意図した出力ではありません。
ダイアログ ボックスの [属性を保存] オプションがオンの場合 (スクリプトで attributes パラメーターが ATTRIBUTES に設定されている) 、ラベル フィーチャ (ポイント) が指定されるかどうかによって次のようになります。
- [ラベル フィーチャ] が指定されていない場合は、各入力エントリの属性スキーマ (フィールド値ではなく、フィールド名とプロパティ) が、入力リストに表示されている順番で出力に保存されます。新規フィールドである FID_xxx (xxx は、該当する入力エントリのソース フィーチャクラス名) が各入力エントリの出力に追加され、値 -1 に設定されます。その他すべてのフィールドには、ゼロか Null の値を設定します。
- [ラベル フィーチャ] が指定されている場合、入力属性スキーマはいずれも出力フィーチャクラスに保存されず、ラベル フィーチャの属性のみが出力フィーチャクラスに含まれます。出力ポリゴンに 1 つのラベル フィーチャが含まれる場合は、出力ポリゴンにそのラベル フィーチャのフィールド値が設定されます。出力ポリゴンに複数のラベル フィーチャが含まれる場合は、それらのフィーチャの 1 つのフィールド値が出力ポリゴンに設定されます。出力ポリゴンにラベル フィーチャが含まれない場合は、出力ポリゴンに 0 または NULL フィールド値が設定されます。
ダイアログ ボックスの [属性の保存] オプションがオフの場合 (スクリプトで attributes パラメーターが NO_ATTRIBUTES に設定されている場合)、入力属性スキーマが出力に書き込まれても、属性値は空になります。出力ポリゴン フィーチャクラスに属性を一切含めたくない場合は、[ラベリング] パラメーターに、属性のないポイント フィーチャクラスを指定してください。
入力ポリゴン フィーチャがより小さな出力ポリゴン フィーチャに分割される場合は、[アイデンティティ (Identity)] ツールを使用して、入力ポリゴン フィーチャの属性を結果として生成されたポリゴン フィーチャに引き継ぐことができます。
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
構文
arcpy.management.FeatureToPolygon(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 メートル、またはフィーチャ単位でそれに相当する値に設定されます。 注意:このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。このパラメーターを変更しないことをお勧めします。ツール ダイアログのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。 | Linear Unit |
attributes (オプション) | レガシー:以降のリリースでは、このパラメーターはサポートされていません。 | Boolean |
label_features (オプション) | 出力ポリゴン フィーチャへと引き継がれる属性を保持するオプションの入力ポイント フィーチャ。 | Feature Layer |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで FeatureToPolygon 関数を使用する方法を示しています。
import arcpy
arcpy.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.
# import system modules
import arcpy
# Set environment settings
arcpy.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")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい