集約 (Spatial Analyst ツール)
サマリー
ラスターの低解像度バージョンを生成します。 それぞれの出力セルは、そのセルの範囲に囲まれている入力セルの合計、最小、最大、平均、または中央値を持ちます。
集約ツールの詳細
図
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)
使用法
集約手法 設定が 最大 、最小 、または 合計 の場合、出力ラスターのタイプは入力ラスターと同じです。 この設定が 平均 または 中央値 の場合、出力タイプは常に浮動小数になります。
このツールでは、ジオプロセシング解析環境の範囲 とセル サイズ が適用されます。 整数のセル サイズが指定されたときに出力ラスターの解像度を求めるには、解析環境のセル解像度に入力セル ファクター パラメーターを掛けます。 解析環境のセル サイズが入力の最小または最大に設定されている場合、出力ラスターの解像度は入力ラスターの解像度に指定されたセル ファクターを掛けた値になります。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
ラベル
説明
データ タイプ
入力ラスター
集約対象の入力ラスター。
整数タイプでも浮動小数点タイプでもかまいません。
Raster Layer
セル ファクター
入力ラスターのセル サイズに掛ける係数。 1 より大きい整数値を指定する必要があります。
たとえば、セル ファクター値が 3 の場合、出力セル サイズは入力ラスターのセル サイズの 3 倍になります。
Long
集約手法
(オプション)
集約に使用される方法。
解像度の低い出力セルに囲まれた入力セルの値は、次のいずれかの統計情報によって集約されます。
String
必要に応じて範囲を拡大
(オプション)
入力ラスターのロウまたはカラムがセル ファクターの倍数でない場合に、入力ラスターの境界を拡張するかどうかを指定します。
入力ラスターのロウとカラムの数が cell_factor の倍数である場合、このパラメーターは無視されます。
オン —入力ラスターの上または右の境界を拡張して、ロウまたはカラムのセルの合計数がセル ファクターの倍数になるようにします。 出力ラスターの空間範囲が入力ラスターより大きくなる可能性があります。 拡張されたセルの値は、計算に使用されるときに NoData になります。 これがデフォルトです。
オフ —出力ラスターのロウまたはカラムの数を 1 減らします。 これにより、入力ラスターの上または右の境界上にあるセルが削除され、入力ラスターのロウまたはカラムの数がセル ファクターの倍数になります。 このオプションを使用すると、出力ラスターの空間範囲が入力ラスターより小さくなる可能性があります。
Boolean
計算時に NoData を除外
(オプション)
集約計算で NoData 値を無視するかどうかを示します。
オン —出力ラスターの大きなセルの空間範囲内にあるセルに NoData 値が存在する場合、出力のセル位置の値を決定する際に NoData 値は無視されます。 出力セルの範囲内にある、データ値を持つ入力セルだけが、出力セルの値の決定に使用されます。 これがデフォルトです。
オフ —出力ラスターの大きなセルの空間範囲内にあるセルに NoData 値が存在する場合、出力のセル位置の値は NoData 値になります。 このオプションを使用する場合、集約内のセルに NoData 値が含まれるときは、出力値の決定に必要となる、指定された計算を実行するのに十分な情報がないことを示唆しています。
Boolean
戻り値
ラベル
説明
データ タイプ
出力ラスター
集約された出力ラスター。
入力ラスターの低解像度バージョンです。
Raster
Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
名前
説明
データ タイプ
in_raster
集約対象の入力ラスター。
整数タイプでも浮動小数点タイプでもかまいません。
Raster Layer
cell_factor
入力ラスターのセル サイズに掛ける係数。 1 より大きい整数値を指定する必要があります。
たとえば、セル ファクター値が 3 の場合、出力セル サイズは入力ラスターのセル サイズの 3 倍になります。
Long
aggregation_type
(オプション)
集約に使用される方法。
解像度の低い出力セルに囲まれた入力セルの値は、次のいずれかの統計情報によって集約されます。
String
extent_handling
(オプション)
入力ラスターのロウまたはカラムがセル ファクターの倍数でない場合に、入力ラスターの境界を拡張するかどうかを指定します。
入力ラスターのロウとカラムの数が cell_factor の倍数である場合、このパラメーターは無視されます。
EXPAND入力ラスターの上または右の境界を拡張して、ロウまたはカラムのセルの合計数がセル ファクターの倍数になるようにします。 出力ラスターの空間範囲が入力ラスターより大きくなる可能性があります。 拡張されたセルの値は、計算に使用されるときに NoData になります。 これがデフォルトです。
TRUNCATE出力ラスターのロウまたはカラムの数を 1 減らします。 これにより、入力ラスターの上または右の境界上にあるセルが削除され、入力ラスターのロウまたはカラムの数がセル ファクターの倍数になります。 このオプションを使用すると、出力ラスターの空間範囲が入力ラスターより小さくなる可能性があります。
Boolean
ignore_nodata
(オプション)
集約計算で NoData 値を無視するかどうかを示します。
DATA出力ラスターの大きなセルの空間範囲内にあるセルに NoData 値が存在する場合、出力のセル位置の値を決定する際に NoData 値は無視されます。 出力セルの範囲内にある、データ値を持つ入力セルだけが、出力セルの値の決定に使用されます。 これがデフォルトです。
NODATA出力ラスターの大きなセルの空間範囲内にあるセルに NoData 値が存在する場合、出力のセル位置の値は NoData 値になります。 このオプションを使用する場合、集約内のセルに NoData 値が含まれるときは、出力値の決定に必要となる、指定された計算を実行するのに十分な情報がないことを示唆しています。
Boolean
戻り値
名前
説明
データ タイプ
out_raster
集約された出力ラスター。
入力ラスターの低解像度バージョンです。
Raster
コードのサンプル
Aggregate 例 1 (Python ウィンドウ)
次の例では、セル ファクター 3 で値の平均値を計算することでラスターを集約し、TIFF ラスターを出力しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outAggreg = Aggregate("highres", 3, "MAXIMUM", "TRUNCATE", "DATA")
outAggreg.save("C:/sapyexamples/output/aggregate.tif")
Aggregate 例 2 (スタンドアロン スクリプト)
次の例では、セル ファクター 3 で値の平均値を計算することでラスターを集約し、Grid ラスターを出力しています。
# Name: Aggregate_Ex_02.py
# Description: Generates a reduced resolution version of a raster.
# Requirements: Spatial Analyst extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "highres"
cellFactor = 3
# Run Aggregate
outAggreg = Aggregate(inRaster, cellFactor, "MEAN", "TRUNCATE", "NODATA")
# Save the output
outAggreg.save("C:/sapyexamples/output/aggregate02")
環境
自動コミット , セル サイズ , セル サイズ投影法 , 圧縮 , 現在のワークスペース , 範囲 , 地理座標系変換 , マスク , 出力データのコンフィグレーション キーワード , 出力座標系 , 並列処理ファクター , スクラッチ ワークスペース , スナップ対象ラスター , タイル サイズ
ライセンス情報
Basic: Spatial Analyst が必要
Standard: Spatial Analyst が必要
Advanced: Spatial Analyst が必要
