ゾーンのジオメトリ (Zonal Geometry) (Spatial Analyst)

Spatial Analyst のライセンスで利用可能。

サマリー

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

ゾーンのジオメトリ (Zonal Geometry) ツールの詳細

図

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

Python

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

# Execute 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