ゾーン統計 (テーブル) (Image Analyst ツール)
サマリー
図
ZonalStatisticsAsTable(ZoneRas, "Value", ValRas, OutTable, "DATA", "MIN_MAX_MEAN")
使用法
ゾーンは、入力データ内において、同じ値を持つすべてのエリアとして定義されます。 エリアは連続していなくてもかまいません。 ラスターとフィーチャのいずれも入力ゾーンとして使用できます。
入力ラスターまたはフィーチャ ゾーン データ パラメーター値 (Python では in_zone_data) がラスターの場合、整数ラスターである必要があります。
入力ラスター、またはフィーチャ ゾーン データ パラメーター値がフィーチャである場合、そのフィーチャは、入力値ラスター (Python では in_value_raster) パラメーターのセル サイズとセル配置を使用して、内部でラスターに変換されます。
入力ラスター、またはフィーチャ ゾーン データ および 入力値ラスター パラメーター値でセル サイズ、セル配置、または空間参照が異なる場合、入力値ラスター の値が、内部でセル サイズ 、スナップ ラスター 、および 出力座標系 として使用されます。 いずれの場合も、ゾーン演算を実行する前に内部でリサンプリングが開始されます。
ゾーンと値の両方の入力が同じセル サイズのラスターで、セル同士が位置揃えされている場合、それらの入力はツールで直接使用され、ツールの処理時に内部でリサンプリングされません。
入力ラスターまたはフィーチャ ゾーン データ パラメーター値がフィーチャである場合、値ラスターのセルの中心にオーバーラップしていないゾーン フィーチャのゾーンは内部ゾーン ラスターに変換されません。 その結果、これらのゾーンは出力に表示されません。 これを管理するには、フィーチャ ゾーンの目的の詳細レベルを保持する [セル サイズ] 環境の適切な値を決定し、解析環境で指定します。
入力ラスターまたはフィーチャ ゾーン データ 値がポイント フィーチャである場合、値入力ラスターの特定のセルに複数のポイントが含まれる可能性があります。 そのようなセルの場合、ゾーンの値は最小の ObjectID フィールドを持つポイントによって決まります (たとえば OID や FID)。
入力ラスターまたはフィーチャ ゾーン データ パラメーター値にオーバーラップ フィーチャがある場合は、フィーチャごとにゾーン解析が実行されます。
入力ラスターまたはフィーチャ ゾーン データ パラメーター値を指定する場合、デフォルトのゾーン フィールドは 1 つ目の有効な整数フィールドまたはテキスト フィールドになります。 他に有効なフィールドが存在しないとき、ObjectID フィールド (たとえば OID や FID) がデフォルトになります。
サポートされる統計の種類は、入力値ラスター 値のデータ タイプと、円周統計の計算 パラメーターで指定されている統計の計算タイプによって異なります。
データ タイプが整数の場合、算術統計計算では、平均 、最頻値 、最頻値の数 、最頻値の割合 、最大 、中央値 、最小 、最少頻値 、最少頻値の数 、最少頻値の割合 、パーセンタイル 、範囲 、標準偏差 、合計 、種類 の各オプションがサポートされます。 円周統計の計算では、平均 、最頻値 、最少頻値 、標準偏差 、種類 の各オプションがサポートされます。
データ タイプが浮動小数点の場合、算術統計計算では、平均 、最大 、中央値 、最小 、パーセンタイル 、範囲 、標準偏差 、合計 の各オプションがサポートされます。 円周統計の計算では、平均 と 標準偏差 オプションがサポートされます。
最頻値と最少頻値の計算では、同一頻度の値が複数ある場合、同一頻度の値の中で最も小さい値が出力されます。
円周統計を計算するには、円周統計の計算 パラメーターをオンにし (Python では circular_calculation = "CIRCULAR")、円形折り返し値 パラメーター (Python では circular_wrap_value) の値を指定します。
サポートされている多次元ラスター データセット タイプには、多次元ラスター レイヤー、モザイク、イメージ サービスおよび Esri CRF が含まれます。
統計の種類 パラメーター設定 (Python では statisticType) に応じて、フィールドまたは一連のフィールドが出力テーブルに作成されます。
算術統計の計算の場合、このフィールドの名前は統計の種類と同じになります。 これがデフォルトです。
ただし、円周統計の場合、フィールド名の先頭に C_ が付き、その後に指定された統計情報が続きます。 たとえば、算術中央値の統計情報のフィールド名は Median、円形平均の統計情報の場合は C_Median になります。
出力テーブルに含まれるアイテムの各値のデータ タイプは、実行されるゾーン計算によって変わります。 統計の固有の動作については、ゾーン統計ツールの詳細 をご参照ください。
出力テーブルの行数は、ゾーンの数です。 ゾーン全体の要約統計が NoData の場合、出力テーブルにはそのゾーンのレコードは作成されません。
デフォルトでは、このツールはすべてのマルチコア プロセッサーを最大で 80 パーセントまで使用します (使用可能な場合)。
ゾーンの数が膨大な場合、処理に使用するコア数を減らします。 異なる数のコアを使用するには、並列処理ファクター 環境設定を使用します。
パラメーター
ラベル
説明
データ タイプ
入力ラスターまたはフィーチャ ゾーン データ
ゾーンを定義するデータセット。
ゾーンは、整数ラスターまたはフィーチャ レイヤーによって定義できます。
Raster Layer; Feature Layer
ゾーン フィールド
各ゾーンを定義する値を格納するフィールド。
ゾーン データセットの整数フィールドまたは文字列フィールドを使用できます。
Field
入力値ラスター
統計の計算対象の値を含むラスター。
Raster Layer
出力テーブル
各ゾーンの値のサマリーを含む出力テーブル。
テーブルの形式は、出力先とパスによって決定されます。 デフォルトでは、出力は、ジオデータベース ワークスペース内であればジオデータベース テーブル、ファイル ワークスペース内であれば dBASE テーブルになります。
Table
計算時に NoData を除外
(オプション)
入力値内の NoData 値が、属するゾーンの結果で無視されるかどうかを指定します。
オン —どのゾーン内でも、入力値ラスターで値を持つセルだけがそのゾーンの出力値の決定に使用されます。 値ラスターの NoData セルは、統計の計算時に無視されます。 これがデフォルトです。
オフ —どのゾーン内でも、値ラスターに NoData セルが存在する場合、それらは無視されません。また、NoData セルが存在することは、そのゾーンのすべてのセルについて統計の計算を実行するには情報が不足しているということになります。 したがって、ゾーン全体が NoData 値を受け取ります。
Boolean
統計の種類
(オプション)
計算する統計の種類を指定します。
すべて —すべての統計情報が計算されます。 これがデフォルトです。
平均 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの平均値が計算されます。
最頻値 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルにおいて最も多く存在する値が計算されます。
最頻値の数 —出力セルと同じゾーンに属する、値ラスターに最頻値が含まれるすべてのセルの頻度が計算されます。
最頻値の割合 —出力セルと同じゾーンに属する、値ラスターに最頻値が含まれるセルの割合が計算されます。
最大 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最大値が計算されます。
中央値 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの中央値が計算されます。
最小 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最小値が計算されます。
最少頻値 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルに最も少なく存在する値が計算されます。
最少頻値の数 —出力セルと同じゾーンに属する、値ラスターに最小頻値が含まれるすべてのセルの頻度が計算されます。
最少頻値の割合 —出力セルと同じゾーンに属する、値ラスターに最小頻値が含まれるセルの割合が計算されます。
パーセンタイル —出力セルと同じゾーンに属する値ラスター内にある、すべてのセルのパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 パーセンタイル値 パラメーターを使用して、その他の値 (0 ~ 100) を指定できます。
範囲 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最大値と最小値の差が計算されます。
標準偏差 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの標準偏差が計算されます。
合計 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの合計値が計算されます。
種類 —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの個別値の数が計算されます。
最小と最大 —最小値と最大値の統計情報が計算されます。
平均値および標準偏差 —平均値と標準偏差の統計情報が計算されます。
最小値、最大値および平均値 —最小値、最大値および平均値の統計情報が計算されます。
最頻値、数、割合 —最頻値、数、割合の統計が計算されます。
最少頻値、数、割合 —最小頻値、数、割合の統計が計算されます。
String
多次元として処理
(オプション)
多次元の場合の入力ラスターの計算方法を指定します。
Boolean
パーセンタイル値
(オプション)
計算対象のパーセンタイル。 デフォルトは 90 で、90 番目のパーセンタイルを示します。
値の範囲は 0 ~ 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。
このパラメーターは、統計の種類 パラメーターが パーセンタイル か すべて に設定されている場合にのみ使用できます。
Double
パーセンタイル内挿タイプ
(オプション)
パーセンタイル値が入力値ラスターの 2 つのセル値の間にある場合に使用される内挿方法を指定します。
自動検出 —入力値ラスターが整数ピクセル タイプである場合は、最近隣 内挿法が使用されます。 入力値ラスターが浮動小数点ピクセル タイプである場合は、リニア 内挿法が使用されます。 これがデフォルトです。
最近接 —目的のパーセンタイルに使用できる最近隣の値が使用されます。
リニア —目的のパーセンタイルからの 2 つの周囲値の加重平均が使用されます。
String
円周統計の計算
(オプション)
入力値ラスターを、円形データに対してどのように処理するかを指定します。
Boolean
円形折り返し値
(オプション)
リニアの値を指定された円周統計の範囲に丸めるために使用する値。 値は整数または浮動小数点で指定する必要があります。 デフォルト値は 360 度です。
このパラメーターは、円周統計の計算 パラメーターがオンになっている場合にのみサポートされます。
Double
出力結合レイヤー
(オプション)
出力テーブルを入力ゾーン データに結合することで作成される出力レイヤー。
Raster Layer; Feature Layer
ZonalStatisticsAsTable(in_zone_data, zone_field, in_value_raster, out_table, {ignore_nodata}, {statistics_type}, {process_as_multidimensional}, {percentile_values}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value}, {out_join_layer})
名前
説明
データ タイプ
in_zone_data
ゾーンを定義するデータセット。
ゾーンは、整数ラスターまたはフィーチャ レイヤーによって定義できます。
Raster Layer; Feature Layer
zone_field
各ゾーンを定義する値を格納するフィールド。
ゾーン データセットの整数フィールドまたは文字列フィールドを使用できます。
Field
in_value_raster
統計の計算対象の値を含むラスター。
Raster Layer
out_table
各ゾーンの値のサマリーを含む出力テーブル。
テーブルの形式は、出力先とパスによって決定されます。 デフォルトでは、出力は、ジオデータベース ワークスペース内であればジオデータベース テーブル、ファイル ワークスペース内であれば dBASE テーブルになります。
Table
ignore_nodata
(オプション)
入力値内の NoData 値が、属するゾーンの結果で無視されるかどうかを指定します。
DATA —どのゾーン内でも、入力値ラスターで値を持つセルだけがそのゾーンの出力値の決定に使用されます。 値ラスターの NoData セルは、統計の計算時に無視されます。 これがデフォルトです。
NODATA —どのゾーン内でも、値ラスターに NoData セルが存在する場合、それらは無視されません。また、NoData セルが存在することは、そのゾーンのすべてのセルについて統計の計算を実行するには情報が不足しているということになります。 したがって、ゾーン全体が NoData 値を受け取ります。
Boolean
statistics_type
(オプション)
計算する統計の種類を指定します。
ALL —すべての統計情報が計算されます。 これがデフォルトです。
MEAN —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの平均値が計算されます。
MAJORITY —出力セルと同じゾーンに属する、値ラスター内のすべてのセルにおいて最も多く存在する値が計算されます。
MAJORITY_COUNT —出力セルと同じゾーンに属する、値ラスターに最頻値が含まれるすべてのセルの頻度が計算されます。
MAJORITY_PERCENT —出力セルと同じゾーンに属する、値ラスターに最頻値が含まれるセルの割合が計算されます。
MAXIMUM —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最大値が計算されます。
MEDIAN —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの中央値が計算されます。
MINIMUM —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最小値が計算されます。
MINORITY —出力セルと同じゾーンに属する、値ラスター内のすべてのセルに最も少なく存在する値が計算されます。
MINORITY_COUNT —出力セルと同じゾーンに属する、値ラスターに最小頻値が含まれるすべてのセルの頻度が計算されます。
MINORITY_PERCENT —出力セルと同じゾーンに属する、値ラスターに最小頻値が含まれるセルの割合が計算されます。
PERCENTILE —出力セルと同じゾーンに属する値ラスター内にある、すべてのセルのパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 percentile_values パラメーターを使用して、その他の値 (0 ~ 100) を指定できます。
RANGE —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの最大値と最小値の差が計算されます。
STD —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの標準偏差が計算されます。
SUM —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの合計値が計算されます。
VARIETY —出力セルと同じゾーンに属する、値ラスター内のすべてのセルの個別値の数が計算されます。
MIN_MAX —最小値と最大値の統計情報が計算されます。
MEAN_STD —平均値と標準偏差の統計情報が計算されます。
MIN_MAX_MEAN —最小値、最大値および平均値の統計情報が計算されます。
MAJORITY_VALUE_COUNT_PERCENT —最頻値、数、割合の統計が計算されます。
MINORITY_VALUE_COUNT_PERCENT —最小頻値、数、割合の統計が計算されます。
String
process_as_multidimensional
(オプション)
多次元の場合の入力ラスターの計算方法を指定します。
Boolean
percentile_values
[percentile_values,...]
(オプション)
計算対象のパーセンタイル。 デフォルトは 90 で、90 番目のパーセンタイルを示します。
値の範囲は 0 ~ 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。
このパラメーターは、statistics_type パラメーターが PERCENTILE または ALL に設定されているときのみサポートされます。
Double
percentile_interpolation_type
(オプション)
パーセンタイル値が入力値ラスターの 2 つのセル値の間にある場合に使用される内挿方法を指定します。
AUTO_DETECT —入力値ラスターが整数ピクセル タイプである場合は、NEAREST 内挿法が使用されます。 入力値ラスターが浮動小数点ピクセル タイプである場合は、LINEAR 内挿法が使用されます。 これがデフォルトです。
NEAREST —目的のパーセンタイルに使用できる最近隣の値が使用されます。
LINEAR —目的のパーセンタイルからの 2 つの周囲値の加重平均が使用されます。
String
circular_calculation
(オプション)
入力値ラスターを、円形データに対してどのように処理するかを指定します。
Boolean
circular_wrap_value
(オプション)
リニアの値を指定された円周統計の範囲に丸めるために使用する値。 値は整数または浮動小数点で指定する必要があります。 デフォルト値は 360 度です。
このパラメーターは、circular_calculation パラメーターが CIRCULAR に設定されているときのみサポートされます。
Double
out_join_layer
(オプション)
出力テーブルを入力ゾーン データに結合することで作成される出力レイヤー。
Raster Layer; Feature Layer
コードのサンプル
ZonalStatisticsAsTable の例 1 (Python ウィンドウ)
次の例では、ポリゴン シェープファイルに定義されたゾーン内のラスターの値を集計し、結果をテーブルに記録しています。
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/sapyexamples/data"
outZSaT = ZonalStatisticsAsTable("zones.shp", "Classes", "valueforzone",
"zonalstattblout", "NODATA", "SUM")
ZonalStatisticsAsTable の例 2 (スタンドアロン スクリプト)
次の例では、ポリゴン シェープファイルに定義されたゾーン内のラスターの値を集計し、結果をテーブルに記録しています。
# Name: ZonalStatisticsAsTable_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset and reports the results to a table.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy.ia import *
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"
outTable = "zonalstattblout02.dbf"
# Run ZonalStatisticsAsTable
outZSaT = ZonalStatisticsAsTable(inZoneData, zoneField, inValueRaster,
outTable, "NODATA", "MAXIMUM", "ALL_SLICES")
環境
自動コミット , セル サイズ , セル サイズ投影法 , 圧縮 , 現在のワークスペース , 範囲 , 地理座標系変換 , マスク , 出力データのコンフィグレーション キーワード , 出力座標系 , 並列処理ファクター , 完全に記述したフィールド名を保持 , スクラッチ ワークスペース , スナップ対象ラスター , タイル サイズ , フィールド ドメインの説明の転送
ライセンス情報
Basic: Image Analyst または Spatial Analyst が必要
Standard: Image Analyst または Spatial Analyst が必要
Advanced: Image Analyst または Spatial Analyst が必要