統計情報の計算のバッチ処理 (Batch Calculate Statistics) (データ管理)

サマリー

複数のラスター データセットの統計情報を計算します。

使用法

• 統計情報の計算に使用されるラスター部分は、スキップ ファクターによって制御されます。水平方向または垂直方向のスキップ ファクターは、入力値で示されます。値が 1 のときは各ピクセルを使用し、値が 2 のときはピクセルを 1 つおきに使用します。スキップ ファクターの範囲は、1 からラスター内のカラム数またはロウ数までに限定されます。

• Esri GRID 形式および RADARSAT2 形式の統計情報の計算では、常にスキップ ファクター 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 値の場合、または計算を歪ませる値の場合に、値を無視することができます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ラスター データセット	入力ラスター データセット	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
除外値 (オプション)	統計情報の計算に含まれないピクセル値。 デフォルトは値なしです。	Double
既存をスキップ (オプション)	不足している箇所だけの統計情報を計算するか、存在している箇所のピラミッドも再生成するかを指定します。 オフ - すでに存在している場合でも、統計情報を計算します。したがって、既存の統計情報は上書きされます。 これがデフォルトです。 オン - 存在していない統計情報だけを計算します。	Boolean

派生した出力

ラベル	説明	データ タイプ
統計情報の計算のバッチ処理が成功しました	ツールが正常に実行されたかどうかを返します。	ブール型

Python

arcpy.management.BatchCalculateStatistics(Input_Raster_Datasets, {Number_of_columns_to_skip}, {Number_of_rows_to_skip}, {Ignore_values}, {Skip_Existing})

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

派生した出力

名前	説明	データ タイプ
Batch_Calculate_Statistics_Succeeded	ツールが正常に実行されたかどうかを返します。	ブール型

コードのサンプル

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

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

import arcpy
arcpy.BatchCalculateStatistics_management(
     "C:/data/img1.tif;C:/data/img2.jp2",
     "5", "5", "0;255", "SKEP_EXISTING")

BatchCalculateStatistics の例 2 (スタンドアロン スクリプト)

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

#Calculate Statistics for multiple raster datasets with 
#multiple ignore values. 
#Skip datasets that already have the statistics.

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
inras = "image1.tif;image2.img;fgdb.gdb/image3"
skipcol = "5"
skiprow = "5"
ignoreval = "0;255;21"
skipexist = "SKIP_EXISTING"

arcpy.BatchCalculateStatistics_management(
     inras, skipcol, skiprow, ignoreval,skipexist)

環境

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

特殊なケース

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes