セル統計 (Cell Statistics) (Image Analyst)

サマリー

複数のラスターからセルごとに統計情報を計算します。

使用できる統計情報は、最頻値、最大、平均値、中央値、最小、最少頻値、パーセンタイル、範囲、標準偏差、合計、および種類です。

セル統計ツールの詳細

セル統計ツールの入出力値の例
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

使用法

  • このツールに、入力ラスターの順序は関係ありません。

  • 統計の種類が最大、最小、平均、中央値、最頻値、最少頻値、パーセンタイル、合計のとき、入力として 1 つのラスターが使用される場合、出力セルの値は入力セルの値と同じです。 範囲と標準偏差のとき、出力セルの値はすべて 0 になります。 種類のときは、1 になります。

  • [マルチバンドとして処理] パラメーターがオフの場合 (Pythonprocess_as_multibandSINGLE_BAND に設定されている場合)、マルチバンド ラスター入力の各バンドはシングル バンド ラスターとして別々に処理され、出力はシングル バンド ラスターになります。

    SINGLE_BAND として処理した際のシングルバンド出力
    SINGLE_BAND として処理すると、セル統計 (Cell Statistics) ツールでシングルバンド出力が生成されます。
  • [マルチバンドとして処理] パラメーターがオンの場合 (Pythonprocess_as_multibandMULTI_BAND に設定されている場合)、マルチバンド ラスターの各入力はマルチバンド ラスターとして処理され、出力はマルチバンド ラスターになります。 入力がマルチバンド ラスターと定数の組み合わせの場合、出力ラスターもマルチバンドになります。 各マルチバンド入力のバンド数は同一である必要があります。

    ツールは、1 つの入力の各バンドに対して、他の入力の対応するバンドを使用して操作を実行します。 入力の 1 つがマルチバンド ラスターで他の入力が定数である場合、ツールは、マルチバンド入力内の各バンドの定数値を使用して操作を実行します。

    MULTI_BAND として処理した際のマルチバンド出力。
    MULTI_BAND として処理すると、セル統計ツールでマルチバンド出力が生成されます。
  • すべての入力が、同数の変数を含む多次元ラスター データの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行します。 出力は CRF 形式の多次元ラスターになります。 このツールで処理を行うには、一般的なディメンションと一般的なディメンション値が入力の変数に少なくとも 1 つ必要です。これらがないとエラーが発生します。

    すべての入力に 1 つの変数が含まれているが、名前が異なっている場合は、この操作を実行する前に、多次元変数の照合ジオプロセシング環境をオフにします (Python で arcpy.env.matchMultidimensionalVariable = False を設定します)。

    1 つ以上の入力が多次元ラスターで、それ以外の入力が定数である場合、このツールは、すべての変数のすべてのスライスについて、その定数値を使用して演算を実行し、出力は多次元ラスターになります。

  • 最頻値と最少頻値の計算では、同一頻度の値が複数ある場合、同一頻度の値の中で最も小さい値が出力されます。

パラメーター

ラベル説明データ タイプ
入力ラスター、または定数値

解析ウィンドウでセルごとに統計演算を計算する入力ラスターのリスト。

数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。

[マルチバンドとして処理] パラメーターをオンにした場合は、すべてのマルチバンド入力ラスターのバンド数を同じにする必要があります。

Raster Layer; Constant
オーバーレイ統計
(オプション)

計算する統計情報の種類を指定します。

デフォルトの統計情報タイプは [平均値] です。

  • 平均入力の平均値が計算されます。 これがデフォルトです。
  • 最頻値入力の最頻値 (最も頻繁に発生する値) を求めます。
  • 最大入力の最大値を求めます。
  • 中央値入力の中央値が計算されます。
  • 最小入力の最小値を求めます。
  • 最少頻値入力の最少頻値 (発生する数が最も少ない値) を求めます。
  • パーセンタイル入力のパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 [パーセンタイル値] パラメーターを使用して、その他の値 (0 ~ 100) を指定できます。
  • 範囲入力の範囲 (最大値と最小値の差) が計算されます。
  • 標準偏差入力の標準偏差が計算されます。
  • 合計入力の合計値 (すべての値の合計) が計算されます。
  • 種類入力の種類 (個別値の数) が計算されます。
String
計算時に NoData を除外
(オプション)

統計計算で NoData 値を無視するかどうかを指定します。

  • オン - 処理セルの位置で、いずれかの入力ラスターに NoData が含まれている場合、その NoData 値は無視されます。 有効なデータを持つセルだけを考慮して、統計情報が計算されます。 これがデフォルトです。
  • オフ - いずれかの入力ラスターの処理セルの位置が NoData である場合、そのセルの出力は NoData になります。
Boolean
マルチバンドとして処理
(オプション)

入力マルチバンド ラスター バンドを処理する方法を指定します。

  • オフ - マルチバンド ラスター入力の各バンドは、シングル バンド ラスターとして別々に処理されます。 これがデフォルトです。
  • オン - それぞれのマルチバンド ラスター入力はマルチバンド ラスターとして処理されます。 1 つの入力に含まれる各バンドについて、他の入力に含まれる対応バンド番号を使用して演算が行われます。
Boolean
パーセンタイル値
(オプション)

計算するパーセンタイル。 デフォルトは 90 で、90 番目のパーセンタイルを示します。

値の範囲は 0 〜 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大の統計と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。

[オーバーレイ統計情報] パラメーターが [パーセンタイル] に設定されている場合のみこのパラメーターを使用できます。

Double
パーセンタイル内挿タイプ
(オプション)

指定したパーセンタイル値が 2 つの入力セル値の間にある場合に、使用する内挿の方法を指定します。

  • 自動検出入力ラスターが整数ピクセル タイプである場合は、[最近隣] 内挿法が使用されます。 入力ラスターが浮動小数点ピクセル タイプである場合は、[リニア] 内挿法が使用されます。 これがデフォルトです。
  • 最近隣内挿法目的のパーセンタイルに使用できる最近隣の値が使用されます。 この場合、出力のピクセル タイプは、入力ラスターと同じになります。
  • 線形パーセンタイルからの 2 つの周囲値の加重平均が使用されます。 この場合、出力のピクセル タイプは浮動小数点です。
String

戻り値

ラベル説明データ タイプ
出力ラスター

出力ラスター。

各セルで、指定された統計情報の種類をその位置で入力ラスターに適用することにより、値が求められます。

Raster

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})
名前説明データ タイプ
in_rasters_or_constants
[in_raster_or_constant,...]

解析ウィンドウでセルごとに統計演算を計算する入力ラスターのリスト。

数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。

processing_as_multiband パラメーターを MULTI_BAND に設定した場合は、すべてのマルチバンド入力ラスターのバンド数を同じにする必要があります。

Raster Layer; Constant
statistics_type
(オプション)

計算する統計情報の種類を指定します。

  • MEAN入力の平均値が計算されます。 これがデフォルトです。
  • MAJORITY入力の最頻値 (最も頻繁に発生する値) を求めます。
  • MAXIMUM入力の最大値を求めます。
  • MEDIAN入力の中央値が計算されます。
  • MINIMUM入力の最小値を求めます。
  • MINORITY入力の最少頻値 (発生する数が最も少ない値) を求めます。
  • PERCENTILE入力のパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 percentile_value パラメーターを使用して、その他の値 (0 ~ 100) を指定できます。
  • RANGE入力の範囲 (最大値と最小値の差) が計算されます。
  • STD入力の標準偏差が計算されます。
  • SUM入力の合計値 (すべての値の合計) が計算されます。
  • VARIETY入力の種類 (個別値の数) が計算されます。

デフォルトの統計情報タイプは MEAN です。

String
ignore_nodata
(オプション)

統計計算で NoData 値を無視するかどうかを指定します。

  • DATA処理セルの位置で、いずれかの入力ラスターに NoData が含まれている場合、その NoData 値は無視されます。 有効なデータを持つセルだけを考慮して、統計情報が計算されます。 これがデフォルトです。
  • NODATAいずれかの入力ラスターの処理セルの位置が NoData である場合、そのセルの出力は NoData になります。
Boolean
process_as_multiband
(オプション)

入力マルチバンド ラスター バンドを処理する方法を指定します。

  • SINGLE_BANDマルチバンド ラスター入力の各バンドは、シングル バンド ラスターとして別々に処理されます。 これがデフォルトです。
  • MULTI_BANDそれぞれのマルチバンド ラスター入力はマルチバンド ラスターとして処理されます。 1 つの入力に含まれる各バンドについて、他の入力に含まれる対応バンド番号を使用して演算が行われます。
Boolean
percentile_value
(オプション)

計算するパーセンタイル。 デフォルトは 90 で、90 番目のパーセンタイルを示します。

値の範囲は 0 〜 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大の統計と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。

このパラメーターは、statistics_type パラメーターが PERCENTILE に設定されているときのみサポートされます。

Double
percentile_interpolation_type
(オプション)

指定したパーセンタイル値が 2 つの入力セル値の間にある場合に、使用する内挿の方法を指定します。

  • AUTO_DETECT入力ラスターが整数ピクセル タイプである場合は、NEAREST 内挿法が使用されます。 入力ラスターが浮動小数点ピクセル タイプである場合は、LINEAR 内挿法が使用されます。 これがデフォルトです。
  • NEAREST目的のパーセンタイルに使用できる最近隣の値が使用されます。 この場合、出力のピクセル タイプは、入力ラスターと同じになります。
  • LINEARパーセンタイルからの 2 つの周囲値の加重平均が使用されます。 この場合、出力のピクセル タイプは浮動小数点です。
String

戻り値

名前説明データ タイプ
out_raster

出力ラスター。

各セルで、指定された統計情報の種類をその位置で入力ラスターに適用することにより、値が求められます。

Raster

コードのサンプル

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

次の例では、複数の入力 Grid ラスターの標準偏差をセルごとに計算し、結果を IMG ラスターとして出力しています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")
CellStatistics の例 2 (スタンドアロン スクリプト)

この例では、複数のマルチバンド入力ラスターのバンドごとに各セルの範囲を算出し、マルチバンド出力ラスターを生成します。

# Name: CellStatistics_Ex_02.py
# Description: Calculates a per-cell statistic from multiple rasters
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "cost"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats")

関連トピック