Image Analyst ライセンスで利用できます。
Spatial Analyst のライセンスで利用可能。
概要
多次元ラスターまたはマルチバンド ラスター内の各ピクセルに対して、所定の統計が得られるディメンション値またはバンド インデックスを抽出します。
使用法
[引数の統計を検索 (Find Argument Statistics)] ツールを使用すると、多次元ラスター データセット内のラスターのスタックで、特定の統計値に達したディメンション値 (たとえば、日付、高さ、深さ) を抽出できます。また、マルチバンド ラスター内で統計値に達したバンド番号を検索できます。
たとえば、30 年間のデータ コレクションで各ピクセルが最高海面温度に達した月を知りたい場合があります。あるいは、8 バンドのリモート センシング画像があり、各ピクセルで最小反射率値に達したバンドを知りたいこともあります。
サポートされている多次元ラスター データセットには、netCDF、GRIB、HDF、Esri の CRF などがあります。多次元モザイク データセットもサポートされています。
このツールは、多次元ラスター データセットを CRF (Cloud Raster Format) で生成します。現在、他の出力形式はサポートされていません。
入力多次元ラスターに 1 つのディメンションのみが含まれている場合、出力はシングル バンド ラスター データセットになります。入力多次元ラスターに複数のディメンションが含まれている場合、出力の多次元ラスターには、解析から除外されたそれらのディメンションが含まれます。
構文
FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata})| パラメーター | 説明 | データ タイプ |
in_raster | 解析対象の入力多次元ラスターまたはマルチバンド ラスター。 | Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File |
dimension (オプション) | 統計の抽出元となるディメンション。入力ラスターが多次元ラスターでない場合、このパラメーターは必要ありません。 | String |
dimension_def (オプション) | ディメンションから統計を抽出する方法を指定します。
| String |
interval_keyword (オプション) | 統計を抽出する時間単位。 たとえば、毎日の海面温度データが 5 年分あり、最大温度を観測した年を知りたいとします。[統計の種類] を [最大値の引数] に、[ディメンション定義] を [間隔キーワード] に、[間隔キーワード] を [毎年] に設定します。 あるいは、最大温度が一貫して観測される月を知るには、[統計の種類] を [最大値の引数] に、[ディメンション定義] を [間隔キーワード] に、[間隔キーワード] を [毎月繰り返し] に設定します。この結果、5 年間の記録の中で統計値に到達した月が各ピクセルに含まれるラスターが生成されます (例: 2018/08/18、2016/08/25、2013/08/07)。 このパラメーターは、dimension パラメーターが StdTime に設定されていて、dimension_def パラメーターが INTERVAL_KEYWORD に設定されている場合に必須です。
| String |
variables [variables,...] (オプション) | 解析対象の変数。入力ラスターが多次元でない場合、マルチバンド ラスターのピクセル値が変数と見なされます。入力ラスターが多次元で、変数が指定されない場合、選択したディメンションを含む変数がすべて解析されます。 たとえば、温度の値が最高であった年を検索するには、解析対象の変数として温度を指定します。変数を指定せず、変数として温度と降雨量の両方がある場合、両方の変数が解析され、出力多次元ラスターには両方の変数が含まれます。 | String |
statistics_type (オプション) | 所定のディメンションに沿って変数から抽出する統計を指定します。
| String |
min (オプション) | 期間の抽出に使用する最小変数値。 このパラメーターは、statistics_type パラメーターが DURATION に設定されている場合に必須です。 | Double |
max (オプション) | 期間の抽出に使用する最大変数値。 このパラメーターは、statistics_type パラメーターが DURATION に設定されている場合に必須です。 | Double |
multiple_occurrence (オプション) | 入力ラスター データセット内で所定の引数の統計値に複数回達したことを示すために使用するピクセル値。指定しない場合、ピクセル値は、初めて引数の統計値に達したときのディメンションの値になります。 | Long |
ignore_nodata (オプション) | 解析で NoData 値を無視するかどうかを指定します。
| Boolean |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster | 出力ラスター データセット。 | Raster |
コードのサンプル
この例では、時系列多次元ラスターで最小の月間降雨量値と温度値を検索します。同じ最小値が複数回見つかった場合、ピクセル値は 99999 になります。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")この例では、多次元ラスター内で塩分濃度が 10 ～ 15 計測単位であった最長の期間を検索します。
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"
# Execute
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.crf")環境
ライセンス情報
- Basic: 次のものが必要 Image Analyst
- Standard: 次のものが必要 Image Analyst
- Advanced: 次のものが必要 Image Analyst