統計の計算 (Calculate Statistics) (データ管理)

サマリー

ラスター データセットまたはモザイク データセットの統計を計算します。

コントラスト ストレッチの適用やデータの分類など、ラスター データセットとモザイク データセットで特定のタスクを実行するには、統計が必要です。

使用法

  • 統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

  • ファイル ジオデータベースとエンタープライズ ジオデータベースでは、格納されているラスター データセットのスキップ ファクターはまったく異なります。第一に、X スキップ ファクターと Y スキップ ファクターが異なる場合は、小さいほうのスキップ ファクターが X と Y の両方のスキップ ファクターに使用されます。第二に、スキップ ファクターは、選択されたスキップ ファクターに最も適合するピラミッド レベルに関連付けられます。スキップ ファクターの値がピラミッドのピクセル数と異なる場合 (たとえば、スキップ ファクターが 5 で、最も近いピラミッド レベルが 4 x 4 ピクセル、つまりレベル 2 の場合) は、次のピラミッド レベル (この場合は 2) に切り下げられ、その値がスキップ ファクターとして使用されます。

  • スキップ ファクターはすべてのラスター形式で使用されるわけではありません。統計情報を計算し、スキップ ファクターを利用するラスター形式には、TIFF、IMG、NITF、DTED、RAW、ADRG、CIB、CADRG、DIGEST、GIS、LAN、CIT、COT、ERMapper、ENVI DAT、BIL、BIP、BSQ、ジオデータベースがあります。

  • このツールを使用してモザイク データセットの統計を計算するときは、モザイク データセットに含まれるすべてのラスターではなく、モザイクされた最上面のイメージの統計が計算されます。

  • このデータセットは非常に大きくなる傾向にあるため、モザイク データセットにはスキップ ファクターを指定することをお勧めします。

  • [除外値] オプションを使用すると、統計情報の計算から特定の値を除外できます。NoData 値の場合、または計算を歪ませる値の場合に、値を無視することができます。

  • Esri GRID 形式および RADARSAT2 形式の統計情報の計算では、常にスキップ ファクター 1 が使用されます。

  • このツールを使用して多次元モザイク データセットまたは多次元ラスターの統計を計算すると、データセットの変数ごとに統計が計算されます。

パラメーター

ラベル説明データ タイプ
入力ラスター データセット

入力ラスター データセットまたはモザイク データセット。

Mosaic Dataset; Mosaic Layer; Raster Dataset
X スキップ ファクター
(オプション)

サンプル間の水平方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクターです。

ファイル ジオデータベースとエンタープライズ ジオデータベースでは、格納されているラスター データセットのスキップ ファクターはまったく異なります。第一に、X スキップ ファクターと Y スキップ ファクターが異なる場合は、小さいほうのスキップ ファクターが X と Y の両方のスキップ ファクターに使用されます。第二に、スキップ ファクターは、選択されたスキップ ファクターに最も適合するピラミッド レベルに関連付けられます。スキップ ファクター値がピラミッド レイヤーのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。

Long
Y スキップ ファクター
(オプション)

サンプル間の垂直方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップ ファクターです。

ファイル ジオデータベースとエンタープライズ ジオデータベースでは、格納されているラスター データセットのスキップ ファクターはまったく異なります。第一に、X スキップ ファクターと Y スキップ ファクターが異なる場合は、小さいほうのスキップ ファクターが X と Y の両方のスキップ ファクターに使用されます。第二に、スキップ ファクターは、選択されたスキップ ファクターに最も適合するピラミッド レベルに関連付けられます。スキップ ファクター値がピラミッド レイヤーのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。

Long
除外値
(オプション)

統計情報の計算に含まれないピクセル値。

デフォルトは値なし、または最後に使用した「除外する値」です。

Long
既存をスキップ
(オプション)

不足している場合にだけピラミッドを構築するか、存在していてもピラミッドを再生成するかを指定します。

  • オフ - すでに存在している場合でも、統計情報を計算します。既存の統計情報は上書きされます。 これがデフォルトです。
  • オン - 存在していない統計情報だけを計算します。
Boolean
対象エリア
(オプション)

データセット全体から統計情報を生成しないように、統計の計算に使用するデータセットのエリア。 フィーチャクラスを選択するか、ディスプレイ上でポリゴン グラフィックスを作成できます。

Feature Set

派生した出力

ラベル説明データ タイプ
更新された入力ラスター データセット

出力ラスター データセット。

Raster Dataset

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})
名前説明データ タイプ
in_raster_dataset

入力ラスター データセットまたはモザイク データセット。

Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor
(オプション)

サンプル間の水平方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクターです。

ファイル ジオデータベースとエンタープライズ ジオデータベースでは、格納されているラスター データセットのスキップ ファクターはまったく異なります。第一に、X スキップ ファクターと Y スキップ ファクターが異なる場合は、小さいほうのスキップ ファクターが X と Y の両方のスキップ ファクターに使用されます。第二に、スキップ ファクターは、選択されたスキップ ファクターに最も適合するピラミッド レベルに関連付けられます。スキップ ファクター値がピラミッド レイヤーのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。

Long
y_skip_factor
(オプション)

サンプル間の垂直方向のピクセル数。

統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップ ファクターです。

ファイル ジオデータベースとエンタープライズ ジオデータベースでは、格納されているラスター データセットのスキップ ファクターはまったく異なります。第一に、X スキップ ファクターと Y スキップ ファクターが異なる場合は、小さいほうのスキップ ファクターが X と Y の両方のスキップ ファクターに使用されます。第二に、スキップ ファクターは、選択されたスキップ ファクターに最も適合するピラミッド レベルに関連付けられます。スキップ ファクター値がピラミッド レイヤーのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。

Long
ignore_values
[ignore_value,...]
(オプション)

統計情報の計算に含まれないピクセル値。

デフォルトは値なし、または最後に使用した「除外する値」です。

Long
skip_existing
(オプション)

不足している場合にだけピラミッドを構築するか、存在していてもピラミッドを再生成するかを指定します。

  • OVERWRITEすでに存在している場合でも、統計情報を計算します。既存の統計情報は上書きされます。 これがデフォルトです。
  • SKIP_EXISTING存在していない統計情報だけを計算します。
Boolean
area_of_interest
(オプション)

データセット全体から統計を生成しないように、統計の計算に使用するデータセットのエリアを表すフィーチャクラス。

Feature Set

派生した出力

名前説明データ タイプ
out_raster

出力ラスター データセット。

Raster Dataset

コードのサンプル

CalculateStatistics の例 1 (Python ウィンドウ)

以下は、CalculateStatistics 関数を実行する Python サンプルです。

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")
CalculateStatistics の例 2 (スタンドアロン スクリプト)

以下は、CalculateStatistics 関数を実行する Python スクリプト サンプルです。

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

関連トピック