統計情報の計算 (Calculate Statistics) (データ管理)—ArcGIS Pro

サマリー

ラスターデータセットまたはモザイクデータセットの統計情報を計算します。

コントラストストレッチの適用やデータの分類など、ラスターデータセットとモザイクデータセットで特定のタスクを実行するには、統計情報が必要です。

使用法

統計情報の計算に使用されるラスター部分は、スキップファクターによって制御されます。水平方向または垂直方向のスキップファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。
ファイルジオデータベースとエンタープライズジオデータベースでは、格納されているラスターデータセットのスキップファクターはまったく異なります。第一に、X スキップファクターと Y スキップファクターが異なる場合は、小さいほうのスキップファクターが X と Y の両方のスキップファクターに使用されます。第二に、スキップファクターは、選択されたスキップファクターに最も適合するピラミッドレベルに関連付けられます。スキップファクターの値がピラミッドのピクセル数と異なる場合 (たとえば、スキップファクターが 5 で、最も近いピラミッドレベルが 4 x 4 ピクセル、つまりレベル 2 の場合) は、次のピラミッドレベル (この場合は 2) に切り下げられ、その値がスキップファクターとして使用されます。
スキップファクターはすべてのラスター形式で使用されるわけではありません。統計情報を計算し、スキップファクターを利用するラスター形式には、TIFF、IMG、NITF、DTED、RAW、ADRG、CIB、CADRG、DIGEST、GIS、LAN、CIT、COT、ERMapper、ENVI DAT、BIL、BIP、BSQ、ジオデータベースがあります。
このツールを使用してモザイクデータセットの統計情報を計算するときは、モザイクデータセットに含まれるすべてのラスターではなく、モザイクされた最上面のイメージの統計情報が計算されます。
このデータセットは非常に大きくなる傾向にあるため、モザイクデータセットにはスキップファクターを指定することを強くお勧めします。
[除外値] オプションを使用すると、統計情報の計算から特定の値を除外できます。NoData 値の場合、または計算を歪ませる値の場合に、値を無視することができます。
Esri GRID 形式および RADARSAT2 形式の統計情報の計算では、常にスキップファクター 1 が使用されます。
このツールを使用して多次元モザイクデータセットまたは多次元ラスターの統計情報を計算すると、データセット内の変数ごとに統計情報が計算されます。

パラメーター

ラベル	説明	データタイプ
入力ラスターデータセット	入力ラスターデータセットまたはモザイクデータセット。	Mosaic Dataset; Mosaic Layer; Raster Dataset
X スキップファクター (オプション)	サンプル間の水平方向のピクセル数。統計情報の計算に使用されるラスター部分は、スキップファクターによって制御されます。水平方向または垂直方向のスキップファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップファクターです。ファイルジオデータベースとエンタープライズジオデータベースでは、格納されているラスターデータセットのスキップファクターはまったく異なります。第一に、X スキップファクターと Y スキップファクターが異なる場合は、小さいほうのスキップファクターが X と Y の両方のスキップファクターに使用されます。第二に、スキップファクターは、選択されたスキップファクターに最も適合するピラミッドレベルに関連付けられます。スキップファクター値がピラミッドレイヤーのピクセル数に等しくない場合、その数は次のピラミッドレベルに切り捨てられ、その統計情報が使用されます。	Long
Y スキップファクター (オプション)	サンプル間の垂直方向のピクセル数。統計情報の計算に使用されるラスター部分は、スキップファクターによって制御されます。水平方向または垂直方向のスキップファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップファクターです。ファイルジオデータベースとエンタープライズジオデータベースでは、格納されているラスターデータセットのスキップファクターはまったく異なります。第一に、X スキップファクターと Y スキップファクターが異なる場合は、小さいほうのスキップファクターが X と Y の両方のスキップファクターに使用されます。第二に、スキップファクターは、選択されたスキップファクターに最も適合するピラミッドレベルに関連付けられます。スキップファクター値がピラミッドレイヤーのピクセル数に等しくない場合、その数は次のピラミッドレベルに切り捨てられ、その統計情報が使用されます。	Long
除外する値 (オプション)	統計情報の計算に含まれないピクセル値。デフォルトは値なし、または最後に使用した「除外する値」です。	Long
既存をスキップ (オプション)	統計情報が、不足時のみ計算されるか、存在している場合でも再生成されるかを指定します。オフ - すでに存在している場合でも、統計情報を計算します。既存の統計情報は上書きされます。これがデフォルトです。オン - 存在していない統計情報だけを計算します。	Boolean
対象領域 (AOI) (オプション)	データセット全体から統計情報を生成しないように、統計情報を計算するデータセットのエリア。フィーチャクラスを選択するか、ディスプレイ上でポリゴングラフィックスを作成できます。	Feature Set

派生した出力

ラベル	説明	データタイプ
更新された入力ラスターデータセット	出力ラスターデータセット。	ラスターデータセット

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})

名前	説明	データタイプ
in_raster_dataset	入力ラスターデータセットまたはモザイクデータセット。	Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor (オプション)	サンプル間の水平方向のピクセル数。統計情報の計算に使用されるラスター部分は、スキップファクターによって制御されます。水平方向または垂直方向のスキップファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。この値は、ゼロより大きく、ラスター内のカラム数以下でなければなりません。デフォルトは 1、または最後に使用したスキップファクターです。ファイルジオデータベースとエンタープライズジオデータベースでは、格納されているラスターデータセットのスキップファクターはまったく異なります。第一に、X スキップファクターと Y スキップファクターが異なる場合は、小さいほうのスキップファクターが X と Y の両方のスキップファクターに使用されます。第二に、スキップファクターは、選択されたスキップファクターに最も適合するピラミッドレベルに関連付けられます。スキップファクター値がピラミッドレイヤーのピクセル数に等しくない場合、その数は次のピラミッドレベルに切り捨てられ、その統計情報が使用されます。	Long
y_skip_factor (オプション)	サンプル間の垂直方向のピクセル数。統計情報の計算に使用されるラスター部分は、スキップファクターによって制御されます。水平方向または垂直方向のスキップファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。この値は、ゼロより大きく、ラスターのロウ数以下でなければなりません。デフォルトは 1、または最後に使用した Y スキップファクターです。ファイルジオデータベースとエンタープライズジオデータベースでは、格納されているラスターデータセットのスキップファクターはまったく異なります。第一に、X スキップファクターと Y スキップファクターが異なる場合は、小さいほうのスキップファクターが X と Y の両方のスキップファクターに使用されます。第二に、スキップファクターは、選択されたスキップファクターに最も適合するピラミッドレベルに関連付けられます。スキップファクター値がピラミッドレイヤーのピクセル数に等しくない場合、その数は次のピラミッドレベルに切り捨てられ、その統計情報が使用されます。	Long
ignore_values [ignore_value,...] (オプション)	統計情報の計算に含まれないピクセル値。デフォルトは値なし、または最後に使用した「除外する値」です。	Long
skip_existing (オプション)	統計情報が、不足時のみ計算されるか、存在している場合でも再生成されるかを指定します。 OVERWRITE—すでに存在している場合でも、統計情報を計算します。既存の統計情報は上書きされます。これがデフォルトです。 SKIP_EXISTING—存在していない統計情報だけを計算します。	Boolean
area_of_interest (オプション)	データセット全体から統計情報を生成しないように、統計情報を計算するデータセットのエリアを表すフィーチャクラス。	Feature Set

派生した出力

名前	説明	データタイプ
out_raster	出力ラスターデータセット。	ラスターデータセット

コードのサンプル

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

以下は、CalculateStatistics を実行する Python のサンプルです。

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")

CalculateStatistics (統計情報の計算) の例 2 (スタンドアロンスクリプト)

以下は、CalculateStatistics を実行する Python スクリプトのサンプルです。

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

環境

現在のワークスペース, ラスターの統計情報, テンポラリワークスペース

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容