ラスタの統計情報（環境設定）

ラスタの統計情報の環境を反映するツールは、出力ラスタ データセットの統計情報の作成方法を制御します。

[統計情報] オプションを使うと、出力ラスタ データセットの統計情報を構築することができます。ラスタ データセットによって ArcMap または ArcCatalog で、コントラスト ストレッチの適用やデータの分類などの特定のタスクを実行するには、統計情報が必要です。統計情報を作成する必要はありません。統計情報は、最初に必要になった際に、まだ計算されていなければ計算されるからです。ただし、統計情報を必要とする特定の機能を使用する場合は、ラスタ データセットを使用する前に統計情報を計算しておくことをお勧めします。

使用上の注意

• コントラスト ストレッチの適用やデータの分類など、ラスタ データセットでアプリケーションの特定のタスクを実行するには、統計情報が必要です。
• 統計情報を必要とする特定の機能を使用する場合は、ラスタ データセットの統計情報を事前に計算しておくことをお勧めします。
• スキップ ファクタを設定すると、ピクセルをスキップすることにより、統計情報の計算プロセスが高速化します。
• 除外値は、統計情報の計算に関与しない値に適用されます。通常は、背景の値を除外します。
• ファイル ジオデータベースと ArcSDE ジオデータベースに格納されたラスタ データセットのスキップ ファクタはそれぞれに異なります。第一に、X スキップ ファクタと Y スキップ ファクタが異なる場合は、小さい方のスキップ ファクタが X と Y の両方のスキップ ファクタに使用されます。第二に、スキップ ファクタは、選択されたスキップ ファクタに最も適合するピラミッド レベルに関連付けられます。スキップ ファクタ値がピラミッド レイヤのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。
• この設定を使用したときに制御可能なラスタ格納形式については、「ラスタ格納マトリックス」をご参照ください。

ダイアログの構文

• 統計情報の計算 - 統計情報を計算するには、このチェックボックスをオンにします。
• 統計情報スキップ ファクタ
  • X スキップ ファクタ - サンプル間の水平方向のピクセル数。この値は、ゼロより大きく、ラスタ データセットの列数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクタです。
  • Y スキップ ファクタ - サンプル間の垂直方向のピクセル数。この値は、ゼロより大きく、ラスタ データセットの行数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクタです。
• 統計情報の除外値 - 背景値など、統計情報の計算に関与しない 1 つまたは複数の除外値。複数の値はセミコロンで区切って指定します。

スクリプトの構文

arcpy.env.rasterStatistics = "calculate_statistics {x_skip_factor} {y_skip_factor} {statistics_ignore_value}"

パラメータ	説明
calculate_statistics（必須）	統計情報を計算するときは STATISTICS を、それ以外の場合は NONE を指定します。
x_skip_factor（オプション）	X 軸のスキップ ファクタ。
y_skip_factor（オプション）	Y 軸のスキップ ファクタ。
statistics_ignore_value（オプション）	背景値など、統計情報の計算に関与しない 1 つまたは複数の除外値。複数の値はスペースで区切って指定します。

rasterStatistics の構文

import arcpy

# Statistics using a skip factor of 100 for x and y, and 
# ignore values of 0 and 255.
arcpy.env.rasterStatistics = 'STATISTICS 100 100 (0 255)'