ラスタの統計情報(環境設定)
ラスタの統計情報の環境を反映するツールは、出力ラスタ データセットの統計情報の作成方法を制御します。
統計情報オプションにより、出力ラスタ データセットの統計情報を作成できます。ラスタ データセットによって ArcMap または ArcCatalog で、コントラスト ストレッチの適用やデータの分類などの特定のタスクを実行するには、統計情報が必要です。この時点で統計情報を作成する必要はありません。統計情報は、それが最初に必要になったときに、まだ計算されていなければ計算されるからです。ただし、統計情報を必要とする特定の機能を使用する場合は、ラスタ データセットの統計情報を事前に計算しておくことをお勧めします。統計情報が存在する場合は、標準偏差ストレッチが適用されます。このため、ArcMap または ArcCatalog では、統計情報があらかじめ計算されていると、多くの場合、ラスタのデフォルト表示が改善されます。また、常にストレッチを適用しない状態でデータを表示したい場合は、統計情報を計算する必要はありません。
スキップ ファクタを設定すると、ピクセルをスキップすることにより、統計情報の計算プロセスが高速化します。除外値は、統計情報の計算に関与しない値に適用されます。通常、背景の値は除外することができます。この設定は、ArcGIS でラスタ データセットを作成するツールに使用されます。この設定を使用したときに制御可能なラスタ格納形式については、「ラスタ格納マトリックス」をご参照ください。
使用に関する注意
- ラスタ データセットによって ArcMap または ArcCatalog で、コントラスト ストレッチの適用やデータの分類などの特定のタスクを実行するには、統計情報が必要です。
- 統計情報を必要とする特定の機能を使用する場合は、ラスタ データセットの統計情報を事前に計算しておくことをお勧めします。
- スキップ ファクタを設定すると、ピクセルをスキップすることにより、統計情報の計算プロセスが高速化します。
- 除外値は、統計情報の計算に関与しない値に適用されます。通常、背景の値は除外することができます。
- ファイル ジオデータベースと ArcSDE ジオデータベースに格納されたラスタ データセットのスキップ ファクタはそれぞれに異なります。まず第一に、X スキップ ファクタと Y スキップ ファクタが異なる場合は、小さい方のスキップ ファクタが X と Y の両方のスキップ ファクタに使用されます。第二に、スキップ ファクタは、選択されたスキップ ファクタに最も適合するピラミッド レベルに関連付けられます。スキップ ファクタ値がピラミッド レイヤのピクセル数に等しくない場合、その数は次のピラミッド レベルに切り捨てられ、その統計情報が使用されます。
- この設定を使用したときに制御可能なラスタ格納形式については、「ラスタ格納マトリックス」をご参照ください。
ダイアログの構文
- 統計情報の計算 - 統計情報を計算するには、このチェックボックスをオンにします。
- 統計情報スキップ ファクタ
- X スキップ ファクタ - サンプル間の水平方向のピクセル数。この値は、ゼロより大きく、ラスタ データセットの列数以下でなければなりません。デフォルトは 1、または最後に使用したスキップ ファクタです。
- Y スキップ ファクタ - サンプル間の垂直方向のピクセル数。この値は、ゼロより大きく、ラスタ データセットの行数以下でなければなりません。デフォルトは 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(オプション) | 背景値など、統計情報の計算に関与しない除外値。除外値は、丸括弧の中に入力します。 |
import arcpy # Statistics using a skip factor of 100 for x and y, and # an ignore value of 0. arcpy.env.rasterStatistics = 'STATISTICS 100 100 (0)'