Spatial Analyst のライセンスで利用可能。
概要
ラスターの低解像度バージョンを生成します。それぞれの出力セルは、そのセルの範囲に囲まれている入力セルの合計値、最小値、最大値、平均値、または中央値を持ちます。
図
使用法
[集約手法] 設定が [最大値]、[中央値]、[最小値]、または [合計] の場合、出力ラスターのタイプは入力ラスターと同じです。手法が [平均値] の場合、出力タイプは常に浮動小数になります。
このツールでは、ジオプロセシング解析環境の [範囲] と [セル サイズ] が適用されます。整数のセル サイズが指定されたときに出力ラスターの解像度を求めるには、解析環境のセル解像度に入力セル ファクター パラメーターを掛けます。解析環境のセル サイズが入力の最小値または最大値に設定されている場合、出力ラスターの解像度は入力ラスターの解像度に指定されたセル ファクターを掛けた値になります。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
Aggregate(in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
パラメーター | 説明 | データ タイプ |
in_raster | 集約対象の入力ラスター。 整数タイプでも浮動小数点タイプでもかまいません。 | Raster Layer |
cell_factor | 出力ラスターの解像度を取得するために、入力ラスターのセル サイズに掛けるファクター。 たとえば、セル ファクター値が 3 の場合、出力セル サイズは入力ラスターのセル サイズの 3 倍になります。 1 より大きい整数値を指定する必要があります。 | Long |
aggregation_type (オプション) | 各出力セルの値の決定方法を設定します。 解像度の低い出力セルに囲まれた入力セルの値は、次のいずれかの統計情報によって集約されます。
| String |
extent_handling (オプション) | 入力ラスターの行または列がセル ファクターの倍数でない場合の、入力ラスターの境界の処理方法を定義します。
入力ラスターの行と列の数が cell_factor の倍数である場合、これらのキーワードは使用されません。 | Boolean |
ignore_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
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute 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