Spatial Analyst のライセンスで利用可能。
概要
複数のラスターからセルごとに統計情報を計算します。
使用できる統計情報は、最頻値、最大値、平均値、中央値、最小値、最少頻値、範囲、標準偏差、合計、および種類です。
図
使用法
このツールに、入力ラスターの順序は関係ありません。
[入力ラスター、または定数値] (Python では in_rasters_or_constants) の 1 つとしてマルチバンド ラスターが指定された場合、すべてのバンドが使用されます。
マルチバンド ラスターから選択したバンドを処理するには、まず、[コンポジット バンド (Composite Bands)] ツールを使用して、それら特定のバンドから構成される新しいラスター データセットを作成し、その結果を [入力ラスター、または定数値] (Python では in_rasters_or_constants) のリストで使用できます。
[統計情報の種類 (オプション)] が [MAXIMUM]、[MINIMUM]、[MEAN]、[MEDIAN]、[MAJORITY]、[MINORITY]、[SUM] のとき、入力として 1 つのラスターが使用される場合、出力セルの値は入力セルの値と同じです。[範囲] と [STD] のとき、出力セルの値はすべて 0 になります。[VARIETY] のときは、すべて 1 になります。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata})
パラメーター | 説明 | データ タイプ |
in_rasters_or_constants [in_raster_or_constant,...] | [解析] ウィンドウでセルごとに統計情報を計算する入力ラスターのリスト。 数値を入力として使用できます。しかし、セル サイズと範囲を最初に環境で設定しておく必要があります。 | Raster Layer; Constant |
statistics_type (オプション) | 計算する統計情報の種類。
デフォルトの統計情報タイプは [平均値] です。 | String |
ignore_nodata (オプション) | 統計計算で NoData 値を無視するかどうかを示します。
| Boolean |
戻り値
名前 | 説明 | データ タイプ |
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 (スタンドアロン スクリプト)
次の例では、複数の入力 Grid ラスターの標準偏差をセルごとに計算し、結果を Grid ラスターとして出力しています。
# 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA")
# Save the output
outCellStatistics.save("C:/sapyexamples/output/cellstats")
環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst