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

Spatial Analyst のライセンスで利用可能。

Image Analyst ライセンスで利用できます。

概要

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

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

セル統計 (Cell Statistics) ツールの詳細

セル統計の図
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

使用法

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

  • [統計情報の種類 (オプション)] が [MAXIMUM]、[MINIMUM]、[MEAN]、[MEDIAN]、[MAJORITY]、[MINORITY]、[SUM] のとき、入力として 1 つのラスターが使用される場合、出力セルの値は入力セルの値と同じです。[範囲] および [標準偏差] の場合、出力セル値は 0 になります。[VARIETY] のときは 1 になります。

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

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

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

    MULTI_BAND として処理された場合のマルチバンド出力
    MULTI_BAND として処理すると、[セル統計 (Cell Statistics)] ツールでマルチバンド出力が生成されます。
  • このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

構文

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
(オプション)

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

  • MEAN入力の平均値が計算されます。
  • MAJORITY入力の最頻値 (最も頻繁に発生する値) が計算されます。
  • MAXIMUM入力の最大値が計算されます。
  • MEDIAN入力の中央値が計算されます。
  • MINIMUM入力の最小値が計算されます。
  • MINORITY入力の最少頻値 (発生する数が最も少ない値) が計算されます。
  • RANGE入力の範囲 (最大値と最小値の差) が計算されます。
  • STD入力の標準偏差が計算されます。
  • SUM入力の合計値 (すべての値の合計) が計算されます。
  • VARIETY入力の種類 (個別値の数) が計算されます。

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

String
ignore_nodata
(オプション)

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

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

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

  • SINGLE_BANDマルチバンド ラスター入力の各バンドは、シングル バンド ラスターとして別々に処理されます。これがデフォルトです。
  • MULTI_BANDそれぞれのマルチバンド ラスター入力はマルチバンド ラスターとして処理されます。1 つの入力に含まれる各バンドについて、他の入力に含まれる対応バンド番号を使用して演算が行われます。
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 (スタンドアロン スクリプト)

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

# 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")

ライセンス情報

  • Basic: 次のものが必要 Spatial Analyst または Image Analyst
  • Standard: 次のものが必要 Spatial Analyst または Image Analyst
  • Advanced: 次のものが必要 Spatial Analyst または Image Analyst

関連トピック