Spatial Analyst のライセンスで利用可能。
Image Analyst ライセンスで利用できます。
複数のラスターからセルごとに統計情報を計算します。
使用できる統計情報は、最頻値、最大値、平均値、中央値、最小値、最少頻値、範囲、標準偏差、合計、および種類です。
![[セル統計 (Cell Statistics)] ツールの入力値と出力値の例](GUID-D8BD897C-B7A2-46A5-93DC-121409FF4C0D-web.png "[セル統計 (Cell Statistics)] ツールの入力値と出力値の例")
このツールに、入力ラスターの順序は関係ありません。
[統計情報の種類 (オプション)] が [MAXIMUM]、[MINIMUM]、[MEAN]、[MEDIAN]、[MAJORITY]、[MINORITY]、[SUM] のとき、入力として 1 つのラスターが使用される場合、出力セルの値は入力セルの値と同じです。 [範囲] および [標準偏差] の場合、出力セル値は 0 になります。 [VARIETY] のときは 1 になります。
[マルチバンドとして処理] パラメーターがオフの場合 (Python では process_as_multiband が SINGLE_BAND に設定されている場合)、マルチバンド ラスター入力の各バンドはシングル バンド ラスターとして別々に処理され、出力はシングル バンド ラスターになります。
[マルチバンドとして処理] パラメーターがオンの場合 (Python では process_as_multiband が MULTI_BAND に設定されている場合)、各マルチバンド ラスター入力はマルチバンド ラスターとして処理され、出力はマルチバンド ラスターになります。 入力がマルチバンド ラスターと定数の組み合わせの場合、出力もマルチバンドになります。 各マルチバンド入力のバンド数は同一である必要があります。
ツールは、一方の入力の各バンドに対し、他方の入力の対応するバンドを使用して操作を行います。 入力の一方がマルチバンド ラスターで他方が定数の場合、ツールはマルチバンド入力の各バンドの定数値を使用して操作を行います。
ArcPy では、すべての入力が、同数の変数を含む多次元ラスターの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行し、出力は多次元ラスターになります。 入力に含まれる変数には、同じディメンションまたは一般的なディメンションが指定される必要があります。
すべての入力が、1 つの変数を含むが名前が異なっている多次元ラスターである場合は、演算を実行するために、matchMultidimensionalVariable ジオプロセシング環境を False に設定します。
ArcPy では、1 つ以上の入力が多次元ラスターで、それ以外の入力が定数である場合、このツールは、すべての変数のすべてのスライスについて、その定数値を使用して演算を実行し、出力は多次元ラスターになります。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
| ラベル | 説明 | データ タイプ |
入力ラスター、または定数値 | [解析] ウィンドウでセルごとに統計情報を計算する入力ラスターのリスト。 数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。 [マルチバンドとして処理] パラメーターをオンにした場合は、すべてのマルチバンド入力ラスターのバンド数を同じにする必要があります。 | Raster Layer; Constant |
オーバーレイ統計情報 (オプション) | 計算する統計情報の種類を指定します。 デフォルトの統計情報タイプは [平均値] です。
| String |
計算時に NoData を除外 (オプション) | 統計計算で NoData 値を無視するかどうかを指定します。
| Boolean |
マルチバンドとして処理 (オプション) | 入力マルチバンド ラスター バンドを処理する方法を指定します。
| Boolean |
| ラベル | 説明 | データ タイプ | 出力ラスター | 出力ラスター。 各セルで、指定された統計情報の種類をその位置で入力ラスターに適用することにより、値が求められます。 | Raster |
CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})| 名前 | 説明 | データ タイプ |
in_rasters_or_constants [in_raster_or_constant,...] | [解析] ウィンドウでセルごとに統計情報を計算する入力ラスターのリスト。 数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。 [processing_as_multiband] パラメーターを [MULTI_BAND] に設定した場合は、すべてのマルチバンド入力ラスターのバンド数を同じにする必要があります。 | Raster Layer; Constant |
statistics_type (オプション) | 計算する統計情報の種類を指定します。
デフォルトの統計情報タイプは [平均値] です。 | String |
ignore_nodata (オプション) | 統計計算で NoData 値を無視するかどうかを指定します。
| Boolean |
process_as_multiband (オプション) | 入力マルチバンド ラスター バンドを処理する方法を指定します。
| Boolean |
| 名前 | 説明 | データ タイプ | out_raster | 出力ラスター。 各セルで、指定された統計情報の種類をその位置で入力ラスターに適用することにより、値が求められます。 | Raster |
次の例では、複数の入力 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")この例では、複数のマルチバンド入力ラスターのバンドごとに各セルの範囲を算出し、マルチバンド出力ラスターを生成します。
# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
# and process as multiband.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"
# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")
# Save the output
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")