ゾーンジオメトリー (Spatial Analyst ツール)

サマリー

データセット内の各ゾーンに対して、指定されたジオメトリー計測値 (面積、境界、深さ、楕円の特性) を算出します。

ゾーンジオメトリーツールの詳細

図

ゾーンジオメトリーツールの図 — `OutRas = ZonalGeometry(InRas1,"VALUE","AREA")`

使用法

ゾーンは、入力データ内において、同じ値を持つすべてのエリアとして定義されます。エリアは連続していなくてもかまいません。ラスターとフィーチャのいずれも入力ゾーンとして使用できます。
出力セルサイズ パラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、セルサイズ環境が指定されていれば、そこから取得されます。パラメーターのセルサイズも環境のセルサイズも指定されていない場合、デフォルトの出力セルサイズは、次のように入力データセットのタイプに基づいて決定されます。
- 入力データセットがラスターの場合は、そのデータセットのセルサイズが使用されます。
- 入力データセットがフィーチャで、スナップ対象ラスター環境が設定されている場合は、スナップラスターのセルサイズが使用されます。スナップ対象ラスターが設定されていない場合、セルサイズは範囲の幅および高さのうち小さい方を 250 で割った値で計算されます (範囲が環境で指定された出力座標系に存在する場合)。
数値を使用してセルサイズを指定した場合、出力ラスターではそれが直接使用されます。

ラスターデータセットを使用してセルサイズを指定した場合、パラメーターにはセルサイズの値ではなく、ラスターデータセットのパスが表示されます。データセットの空間参照が出力空間参照と同じであれば、そのラスターデータセットのセルサイズが解析で直接使用されます。データセットの空間参照が出力空間参照と異なる場合、指定した セルサイズ投影法 の値に基づいて投影されます。
入力ラスター、またはフィーチャゾーンデータ 値に重なり合うポリゴンが含まれる場合、個別のポリゴンに対してゾーン解析は実行されません。フィーチャ入力はラスターに変換されるため、各位置は 1 つの値しか持てません。

別の方法として考えられるのは、それぞれのポリゴンゾーンについてゾーン演算を反復処理して、その結果を適用することです。
入力ラスター、またはフィーチャゾーンデータ パラメーター値を指定する場合、デフォルトのゾーンフィールドは 1 つ目の有効な整数フィールドまたはテキストフィールドになります。他に有効なフィールドが存在しないとき、ObjectID フィールド (たとえば OID や FID) がデフォルトになります。
各ジオメトリータイプに対する出力ラスターのデータタイプは、浮動小数です。
特定のゾーンが 1 つのセルのみで構成されている場合、またはゾーンが複数のセルから構成される 1 つの正方形ブロックの場合、楕円 (この場合は円) の方向が 90 度に設定されます。
出力ラスターの形式が .crf の場合、このツールはピラミッドラスター格納環境をサポートします。デフォルトでは、ピラミッドは出力で作成されます。その他の出力形式ではこの環境はサポートされず、ピラミッドは作成されません。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。

ラベル	説明	データタイプ
入力ラスター、またはフィーチャゾーンデータ	ゾーンを定義するデータセット。ゾーンは、整数ラスターまたはフィーチャレイヤーによって定義できます。	Raster Layer; Feature Layer
ゾーンフィールド	各ゾーンを定義する値を格納するフィールド。ゾーンデータセットの整数フィールドでなくてはいけません。	Field
ジオメトリータイプ (オプション)	計算するジオメトリータイプを指定します。面積—各ゾーンの面積が計算されます。周長—各ゾーンの周長が計算されます。厚さ—ゾーン内の周囲のセルからの最深 (最も厚い) ポイントが計算されます。重心—各ゾーンの重心が計算されます。	String
出力セルサイズ (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、環境セルサイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。詳細については、使用法セクションをご参照ください。	Analysis Cell Size

戻り値

ラベル	説明	データタイプ
出力ラスター	出力ゾーンジオメトリーラスター。	Raster

ZonalGeometry(in_zone_data, zone_field, {geometry_type}, {cell_size})

名前	説明	データタイプ
in_zone_data	ゾーンを定義するデータセット。ゾーンは、整数ラスターまたはフィーチャレイヤーによって定義できます。	Raster Layer; Feature Layer
zone_field	各ゾーンを定義する値を格納するフィールド。ゾーンデータセットの整数フィールドでなくてはいけません。	Field
geometry_type (オプション)	計算するジオメトリータイプを指定します。 `AREA`—各ゾーンの面積が計算されます。 `PERIMETER`—各ゾーンの周長が計算されます。 `THICKNESS`—ゾーン内の周囲のセルからの最深 (最も厚い) ポイントが計算されます。 `CENTROID`—各ゾーンの重心が計算されます。	String
cell_size (オプション)	作成される出力ラスターのセルサイズ。このパラメーターは、数値で定義するか、既存のラスターデータセットから取得することができます。セルサイズがパラメーター値として明示的に指定されていない場合、環境セルサイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。詳細については、使用法セクションをご参照ください。	Analysis Cell Size

戻り値

名前	説明	データタイプ
out_raster	出力ゾーンジオメトリーラスター。	Raster

コードのサンプル

ZonalGeometry 例 1 (Python ウィンドウ)

次の例では、入力ポリゴンシェープファイルで定義された各ゾーンの面積を求めています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalGeometry = ZonalGeometry("zones.shp", "Classes", "AREA", 0.2)
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout3")

ZonalGeometry 例 2 (スタンドアロンスクリプト)

次の例では、入力ポリゴンシェープファイルで定義された各ゾーンの面積を求めています。

# Name: ZonalGeometry_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry
#   measure (area, perimeter, thickness, or the characteristics
#   of ellipse).
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inZoneData = "zones.shp"
zoneField = "Classes"
cellSize = 0.2

# Run ZonalStatistics
outZonalGeometry = ZonalGeometry(inZoneData, zoneField, "AREA", cellSize)

# Save the output
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout2")

環境

自動コミット, セルサイズ, セルサイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーションキーワード, 出力座標系, 並列処理ファクター, ピラミッド, スクラッチワークスペース, スナップ対象ラスター, タイルサイズ

ライセンス情報

Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要

ゾーン ジオメトリー (Spatial Analyst ツール)

サマリー

図

使用法

パラメーター

戻り値

環境

ライセンス情報

関連トピック

ゾーンジオメトリー (Spatial Analyst ツール)