概要
ラスター データセットをポリゴン フィーチャに変換します。
使用法
入力ラスターには、任意のセル サイズを指定できます。この入力ラスターは、有効な整数ラスター データセットである必要があります。
[フィールド] パラメーターを使用すると、出力フィーチャクラスの属性に変換される入力ラスター データセットの属性フィールドを選択できます。フィールドが指定されていない場合、入力ラスターのセル値 (VALUE フィールド) は、出力フィーチャクラスの属性テーブル内で見出しが Gridcode の列の値になります。
出力ポリゴン フィーチャに変換する際の入力ラスターをベクター変換する方法を次の図に示します。この結果は [単純化] パラメーターのどちらの設定にも表示されます。
![それぞれの [単純化] オプションによる出力の図](GUID-3BED040D-509F-4091-A9A4-7EFD63A93719-web.png "それぞれの [単純化] オプションによる出力の図")
それぞれの [単純化] オプションによる出力の比較 [マルチパート フィーチャの作成] パラメーターがオン (Python では MULTIPLE_OUTER_PART) ならば、出力はマルチパート フィーチャクラスであり、平均して、処理は高速になります。しかし、出力フィーチャクラスに大量のフィーチャがあれば、メモリ不足のためエラーになる恐れがあります。グループ化処理は [ディゾルブ (Dissolve)] ツールの処理に似ています。
[1 ポリゴン フィーチャあたりの最大頂点数] パラメーターを使って、指定した頂点制限に基づき、ポリゴンをより小さなポリゴンに分割できます。これは特に、出力フィーチャにあまりにも多数の頂点がある場合に有用です。このパラメーターを指定すると、[フィーチャの分割 (Dice)] ツールが作成するのと似た出力が得られます。
環境設定で [範囲] が指定され、出力範囲の左下隅が入力ラスターのどのセルの隅にも一致しない場合、処理では、指定された範囲に一致するように入力ラスターのセル配置のシフトが実行されます。このシフトにより、最近隣内挿法を使用した入力ラスターのリサンプリングが開始されます。したがって、出力フィーチャもシフトされるため、結果として、出力フィーチャが元の入力ラスターを正確にオーバーレイしない場合があります。このシフトが実行されないようにするには、環境内で入力ラスターを [スナップ対象ラスター] として使用します。
構文
arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})| パラメーター | 説明 | データ タイプ |
in_raster | 入力ラスター データセット。 ラスターは整数タイプでなければなりません。 | Raster Layer |
out_polygon_features | 変換されたポリゴンの格納先となる出力フィーチャクラス | Feature Class |
simplify (オプション) | 出力ポリゴンを単純化された形状にスムージングするか、それとも入力ラスターのセルのエッジに一致させるかを指定します。
| Boolean |
raster_field (オプション) | 入力ラスター内のセルから取得した値を出力データセット内のポリゴンに割り当てるために用いられるフィールド。 整数または文字列のフィールドを使用できます。 | Field |
create_multipart_features (オプション) | 出力ポリゴンを構成するフィーチャがシングルパートかマルチパートかを指定します。
| Boolean |
max_vertices_per_feature (オプション) | ポリゴンをより小さなポリゴンに分割するために使う、頂点数の上限。このパラメーターを指定すると、[フィーチャの分割 (Dice)] ツールが作成するのと似た出力が得られます。 空のままであれば、ポリゴンを分割せずに出力します。デフォルトは空です。 | Long |
コードのサンプル
ラスター データセットをポリゴン フィーチャに変換します。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.RasterToPolygon_conversion("zone", "c:/output/zones.shp", "NO_SIMPLIFY",
"VALUE")ラスター データセットをポリゴン フィーチャに変換します。
# Name: RasterToPolygon_Ex_02.py
# Description: Converts a raster dataset to polygon features.
# Requirements: None
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "zone"
outPolygons = "c:/output/zones.shp"
field = "VALUE"
# Execute RasterToPolygon
arcpy.RasterToPolygon_conversion(inRaster, outPolygons, "NO_SIMPLIFY", field)環境
ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい