次元変動統計 (Image Analyst ツール)
サマリー
多次元データの変動ウィンドウで指定された次元に沿って統計を計算します。
使用法
変動統計は、変動ウィンドウ統計、ローリング統計、動作統計などと呼ばれることもあります。 各ディメンション値を囲む事前定義済みのウィンドウは、その次に移動する前に、さまざまな統計情報を計算するために使用します。 逆方向ウィンドウ パラメーターと 正方向ウィンドウ パラメーターを使用すると、ディメンションの両側のウィンドウ サイズを定義することができます。
入力ラスターだけを CRF (Cloud Raster Format) 形式 (.crf ファイル) の多次元ラスターにすることができます。
このツールが処理するディメンションは 1 つだけです。 デフォルトでは、X、Y 以外の最初のディメンションが処理ディメンションとして使用されます。
統計の種類が 円形平均 の場合は、角度またはその他の周期的な数量 (度単位のコンパスの方向など) の平均が計算されます。 このオプションを選択すると、円形折り返し値 パラメーターが使用可能になります。 このパラメーターを使用して、円形平均の計算で折り返す値を指定します。 たとえば、角度の計算に使用する場合は、円形折り返し値を 360 度に設定します。つまり、値 360 が 0 に折り返され、値 370 が 10 に折り返されます。 また、1 年間の月の時間計算に使用することもできます。この場合には、円形折り返し値を 12 に設定します。 つまり、入力値が 13 の場合は 1 に折り返されます。
入力多次元ラスターが整数の場合、統計の種類 に有効なオプションは、平均、円形平均、最頻値、最大、中央値、最小、パーセンタイル です。 入力ラスターが浮動小数点数の場合、最頻値 は使用できません。
入力ラスターが整数の場合、出力ラスターは、最頻値、最大、および 最小 のオプションで整数になります。 平均、円形平均、中央値、および パーセンタイル では、出力が浮動小数点数になります。
入力ラスターのデータ タイプが浮動小数点数の場合は、使用可能なすべての統計の種類で出力ラスターも浮動小数点数になります。
最頻値 オプションでは、同一頻度の値が複数ある場合、同一頻度の値の中で最も小さい値が出力されます。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力多次元ラスター
|
入力ラスターだけを CRF (Cloud Raster Format) 形式 (.crf ファイル) の多次元ラスターにすることができます。
|
Raster Layer
|
|
ディメンション
(オプション)
|
ウィンドウが移動するディメンションの名前。
デフォルト値は、入力多次元ラスター内にある X、Y 以外の最初のディメンションになります。
|
String
|
|
逆方向ウィンドウ
(オプション)
|
定義したウィンドウにいくつ前または上のスライスを含めるかを表す値。 値は 1 ～ 100 の正の整数でなくてはいけません。 デフォルト値は 1 です。
このパラメーターの単位はスライスです。
|
Long
|
|
正方向ウィンドウ
(オプション)
|
定義したウィンドウにいくつ後または下のスライスを含めるかを表す値。 値は 1 ～ 100 の正の整数でなくてはいけません。 デフォルト値は 1 です。
このパラメーターの単位はスライスです。
|
Long
|
|
NoData の処理
(オプション)
|
統計計算での NoData 値の処理方法を指定します。
データ—定義済みのウィンドウ内の NoData (環境設定) 値は、選択した統計を計算するときに無視されます。 出力値の計算には、定義済みのウィンドウ内のデータ値を持つセルだけが使用されます。 処理するセルが NoData で、定義済みのウィンドウ内の最低 1 つのセルが有効な値を持つ場合、このセルは出力ラスターの値を受け取ります。 これがデフォルトです。
NoData—定義済みウィンドウ内に NoData (環境設定) 値がある場合、出力値は NoData (環境設定) になります。 NoData 値が存在すると、定義済みのウィンドウの統計値を決定するのに十分な情報がないことを意味します。
NoData の入力—NoData (環境設定) セル値は、定義済みウィンドウ内の値から計算された、選択した統計情報を使用して出力内で置き換えられます。 データ値を持つ入力セルは、出力でも同じ値になります。
|
String
|
|
統計タイプ
(オプション)
|
計算する統計タイプを指定します。
平均—定義したウィンドウのセルの平均値が計算されます。 これがデフォルトです。
円形平均—角度またはその他の周期的変化量 (度単位のコンパス方向、日中時間、実数の小数部など) の平均値が計算されます。 この統計の種類を指定すると、円形折り返し値 パラメーターが使用可能になります。 このパラメーターを使用して、折り返し値を指定します。
最頻値—定義したウィンドウのセルの最頻値 (最も頻繁に発生する値) が特定されます。
最大—定義したウィンドウのセルの最大値が特定されます。
中央値—定義したウィンドウのセルの中央値が特定されます。
最小—定義したウィンドウのセルの最小値が特定されます。
パーセンタイル—定義したウィンドウのセルのパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 この統計の種類を指定すると、パーセンタイル値 パラメーターと パーセンタイル内挿タイプ パラメーターが使用可能になります。 これらの新しいパラメーターを使用して、計算するパーセンタイルと使用する内挿タイプをそれぞれ指定します。
|
String
|
|
パーセンタイル値
(オプション)
|
計算するパーセンタイル。 デフォルトは 90 です。これは、90 番目のパーセンタイルです。
値の範囲は 0 ～ 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大の統計と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。
このパラメーターは、統計の種類 パラメーターが パーセンタイル に設定されている場合にのみサポートされます。
|
Double
|
|
パーセンタイル内挿タイプ
(オプション)
|
パーセンタイル値が 2 つのセル値の間にある場合に使用する内挿方法を指定します。
このパラメーターは、統計の種類 パラメーターが 中央値 または パーセンタイル に設定されている場合にのみサポートされます。
自動検出—入力ラスターが整数ピクセル タイプである場合は、最近接 方法が使用されます。 入力ラスターが浮動小数点数ピクセル タイプの場合は、リニア 方法が使用されます。 これがデフォルトです。
最近接—パーセンタイルに使用できる最近隣の値が使用されます。 この場合、出力のピクセル タイプは、入力ラスターと同じになります。
リニア—パーセンタイルからの 2 つの周囲値の加重平均が使用されます。 この場合、出力のピクセル タイプは浮動小数点です。
|
String
|
|
円形折り返し値
(オプション)
|
リニア値を特定の円形平均の範囲に変換する場合に使用する値。 正の値にする必要があります。 デフォルト値は 360 度です。
このパラメーターは、統計の種類 パラメーターが 円形平均 に設定されている場合にのみサポートされます。
|
Double
|
派生した出力
|
ラベル
|
説明
|
データ タイプ
|
|
ラスター関数の引数 JSON
|
関数の引数。 この出力は内部的な目的のみで使用されます。
|
String
|
戻り値
|
ラベル
|
説明
|
データ タイプ
|
|
出力多次元ラスター
|
出力ラスターだけを CRF (Cloud Raster Format) 形式 (.crf ファイル) の多次元ラスターにすることができます。
|
Raster
|
DimensionalMovingStatistics(in_raster, {dimension}, {backward_window}, {forward_window}, {nodata_handling}, {statistics_type}, {percentile_value}, {percentile_interpolation_type}, {circular_wrap_value})
|
名前
|
説明
|
データ タイプ
|
|
in_raster
|
入力ラスターだけを CRF (Cloud Raster Format) 形式 (.crf ファイル) の多次元ラスターにすることができます。
|
Raster Layer
|
|
dimension
(オプション)
|
ウィンドウが移動するディメンションの名前。
デフォルト値は、入力多次元ラスター内にある X、Y 以外の最初のディメンションになります。
|
String
|
|
backward_window
(オプション)
|
定義したウィンドウにいくつ前または上のスライスを含めるかを表す値。 値は 1 ～ 100 の正の整数でなくてはいけません。 デフォルト値は 1 です。
このパラメーターの単位はスライスです。
|
Long
|
|
forward_window
(オプション)
|
定義したウィンドウにいくつ後または下のスライスを含めるかを表す値。 値は 1 ～ 100 の正の整数でなくてはいけません。 デフォルト値は 1 です。
このパラメーターの単位はスライスです。
|
Long
|
|
nodata_handling
(オプション)
|
統計計算での NoData 値の処理方法を指定します。
DATA—定義済みのウィンドウ内の NoData (環境設定) 値は、選択した統計を計算するときに無視されます。 出力値の計算には、定義済みのウィンドウ内のデータ値を持つセルだけが使用されます。 処理するセルが NoData で、定義済みのウィンドウ内の最低 1 つのセルが有効な値を持つ場合、このセルは出力ラスターの値を受け取ります。 これがデフォルトです。
NODATA—定義済みウィンドウ内に NoData (環境設定) 値がある場合、出力値は NoData (環境設定) になります。 NoData 値が存在すると、定義済みのウィンドウの統計値を決定するのに十分な情報がないことを意味します。
FILL_NODATA—NoData (環境設定) セル値は、定義済みウィンドウ内の値から計算された、選択した統計情報を使用して出力内で置き換えられます。 データ値を持つ入力セルは、出力でも同じ値になります。
|
String
|
|
statistics_type
(オプション)
|
計算する統計タイプを指定します。
MEAN—定義したウィンドウのセルの平均値が計算されます。 これがデフォルトです。
CIRCULAR_MEAN—角度またはその他の周期的変化量 (度単位のコンパス方向、日中時間、実数の小数部など) の平均値が計算されます。 この統計の種類を指定した場合は、circular_wrap_value パラメーターを使用して、折り返す値を指定します。
MAJORITY—定義したウィンドウのセルの最頻値 (最も頻繁に発生する値) が特定されます。
MAXIMUM—定義したウィンドウのセルの最大値が特定されます。
MEDIAN—定義したウィンドウのセルの中央値が特定されます。
MINIMUM—定義したウィンドウのセルの最小値が特定されます。
PERCENTILE—定義したウィンドウのセルのパーセンタイルが計算されます。 デフォルトでは 90 番目のパーセンタイルが計算されます。 この統計の種類を指定した場合、percentile_value と percentile_interpolation_type パラメーターを使用して、計算するパーセンタイルの指定および使用する内挿タイプの選択をそれぞれ行います。
|
String
|
|
percentile_value
(オプション)
|
計算するパーセンタイル。 デフォルトは 90 です。これは、90 番目のパーセンタイルです。
値の範囲は 0 ～ 100 です。 0 番目のパーセンタイルは、基本的に最小の統計と同じであり、100 番目のパーセンタイルは最大の統計と同じです。 値が 50 の場合、基本的に中央値の統計と同じ結果になります。
このパラメーターは、statistics_type パラメーターが PERCENTILE に設定されているときのみサポートされます。 その他の統計の種類が指定されている場合、このパラメーターは無視されます。
|
Double
|
|
percentile_interpolation_type
(オプション)
|
パーセンタイル値が 2 つのセル値の間にある場合に使用する内挿方法を指定します。
このパラメーターは、statistics_type パラメーターが MEDIAN または PERCENTILE に設定されているときのみサポートされます。 その他の統計の種類が指定されている場合、このパラメーターは無視されます。
AUTO_DETECT—入力ラスターが整数ピクセル タイプである場合は、NEAREST 方法が使用されます。 入力ラスターが浮動小数点ピクセル タイプである場合は、LINEAR 方法が使用されます。
NEAREST—パーセンタイルに使用できる最近隣の値が使用されます。 この場合、出力のピクセル タイプは、入力ラスターと同じになります。
LINEAR—パーセンタイルからの 2 つの周囲値の加重平均が使用されます。 この場合、出力のピクセル タイプは浮動小数点です。
|
String
|
|
circular_wrap_value
(オプション)
|
リニア値を特定の円形平均の範囲に変換する場合に使用する値。 正の値にする必要があります。 デフォルト値は 360 度です。
このパラメーターは、statistics_type パラメーターが CIRCULAR_MEAN に設定されているときのみサポートされます。 その他の統計の種類が指定されている場合、このパラメーターは無視されます。
|
Double
|
派生した出力
|
名前
|
説明
|
データ タイプ
|
|
raster_function_arguments_json
|
関数の引数。 この出力は内部的な目的のみで使用されます。
|
String
|
戻り値
|
名前
|
説明
|
データ タイプ
|
|
out_raster
|
出力ラスターだけを CRF (Cloud Raster Format) 形式 (.crf ファイル) の多次元ラスターにすることができます。
|
Raster
|
コードのサンプル
DimensionalMovingStatistics の例 1 (Python ウィンドウ)
次の例では、入力多次元ラスターの各セルについて、3 スライスのウィンドウ内の平均値を計算しています。
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
out_dimstats = DimensionalMovingStatistics("md_raster.crf", "StdTime",
1, 1, "NODATA", "MEAN")
out_dimstats.save("C:/iapyexamples/output/DMS01.crf")
DimensionalMovingStatistics の例 2 (スタンドアロン スクリプト)
次の例では、入力多次元ラスターの各セルについて、5 スライスの変動ウィンドウ内の最も頻繁に出現する値を判定しています。
# Name: DimensionalMovingStatistics_standalone.py
# Description: Calculates majority on a multidimensional raster
# along its time dimension.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set the analysis environment
env.workspace = "C:/iapyexamples/data"
# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"
# Run DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension,
backward_window, forward_window, nodata_handling,
statistics_type)
# Save the output
out_dimstats.save("C:/iapyexamples/output/mining_location_out.crf")
環境
自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, 並列処理ファクター, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ
ライセンス情報
- Basic: Image Analyst または Spatial Analyst が必要
- Standard: Image Analyst または Spatial Analyst が必要
- Advanced: Image Analyst または Spatial Analyst が必要