集約(Aggregate) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

ラスタの低解像度バージョンを生成します。それぞれの出力セルは、そのセルの範囲に囲まれている入力セルの合計値、最小値、最大値、平均値、または中央値を持ちます。

[集約(Aggregate)] ツールの仕組みの詳細

Aggregate illustration
OutRas = Aggregate(InRas1, 3, Max, Expand, Data)

使用法

構文

Aggregate (in_raster, cell_factor, {aggregation_type}, {extent_handling}, {ignore_nodata})
パラメータ説明データ タイプ
in_raster

集約対象の入力ラスタ。

整数タイプでも浮動小数点タイプでもかまいません。

Raster Layer
cell_factor

出力ラスタの解像度を取得するために、入力ラスタのセル サイズに掛けるファクタ。

たとえば、セル ファクタ値が 3 の場合、出力セル サイズは入力ラスタのセル サイズの 3 倍になります。

1 より大きい整数値を指定する必要があります。

Long
aggregation_type
(オプション)

各出力セルの値の決定方法を設定します。

解像度の低い出力セルに囲まれた入力セルの値は、次のいずれかの統計情報によって集約されます。

  • SUM入力セル値の合計です。 これがデフォルトです。
  • MAXIMUM 入力セルの最大値です。
  • MEAN 入力セルの平均値です。
  • MEDIAN 入力セルの中央値です。
  • MINIMUM 入力セルの最小値です。
String
extent_handling
(オプション)

入力ラスタの行または列がセル ファクタの倍数でない場合の、入力ラスタの境界の処理方法を定義します。

  • EXPAND 入力ラスタの下または右の境界を拡張して、行または列のセルの合計数がセル ファクタの倍数になるようにします。拡張されたセルの値は、NoData になります。このオプションを使用すると、出力ラスタの空間範囲が入力ラスタより大きくなる可能性があります。これがデフォルトです。 これがデフォルトです。
  • TRUNCATE 出力ラスタの行または列の数を 1 減らします。これにより、入力ラスタの下または右の境界上にあるセルが削除され、入力ラスタの行または列の数がセル ファクタの倍数になります。このオプションを使用すると、出力ラスタの空間範囲が入力ラスタより小さくなる可能性があります。

入力ラスタの行と列の数が cell_factor の倍数である場合、これらのキーワードは使用されません。

Boolean
ignore_nodata
(オプション)

集約計算で NoData 値を無視するかどうかを示します。

  • DATA 出力ラスタの大きなセルの空間範囲内にあるセルに NoData 値が存在する場合、出力のセル位置の値を決定する際に 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

# 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")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
9/17/2013