ラスターの統計情報の環境を反映するツールは、出力ラスター データセットの統計情報の作成方法を制御します。
[統計情報] オプションを使用すると、出力ラスター データセットの統計情報を構築することができます。コントラスト ストレッチの適用やデータの分類など、ラスター データセットでアプリケーションの特定のタスクを実行するには、統計情報が必要です。統計情報を作成する必要はありません。統計情報は、最初に必要になった際に、まだ計算されていなければ計算されるからです。ただし、統計情報を必要とする特定の機能を使用する場合は、ラスター データセットを使用する前に統計情報を計算しておくことをお勧めします。
使用上の注意
- コントラスト ストレッチの適用やデータの分類など、ラスター データセットでアプリケーションの特定のタスクを実行するには、統計情報が必要です。
- 統計情報を必要とする特定の機能を使用する場合は、ラスター データセットの統計情報を事前に計算しておくことをお勧めします。
- スキップ ファクターを設定すると、ピクセルをスキップすることにより、統計情報の計算プロセスが高速化します。
- 除外値は、統計情報の計算に関与しない値に適用されます。通常は、背景の値を除外します。
- ジオデータベースに格納されたラスター データセットのスキップ ファクターはそれぞれに異なります。第一に、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 つまたは複数の除外値。複数の値はスペースで区切って指定します。 |
スクリプトの例
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)'