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

サマリー

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

図

ゾーンのジオメトリツールの図 — 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

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

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

環境

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

サマリー

図

使用法

パラメーター

戻り値

戻り値

コードのサンプル

環境

関連トピック

このトピックの内容