リサンプル (Resample) (データ管理)

概要

ラスター データセットの空間解像度を変更し、新しいピクセル サイズにおいて値を集約または内挿するためのルールを設定します。

使用法

• セル サイズは変更可能ですが、ラスター データセットの範囲は変わりません。

• 出力は、BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF、MRF、CRF、または任意のジオデータベース ラスター データセットに保存することができます。

• [出力セル サイズ] パラメーターは、既存のラスター レイヤーと同じセル サイズに出力をリサンプルできます。また、指定した X および Y のセル サイズを出力できます。

• [リサンプリング手法] パラメーターには、次の 4 つのオプションがあります。

  • 最近隣内挿法 - 最近隣内挿法を実行します。最も高速の内挿法です。この方法はセルの値を変更しないため、主に土地利用区分などの不連続データに使用されます。最大の空間誤差は、セル サイズの 1/2 になります。
  • 最頻値 - 最頻値アルゴリズムを実行し、フィルター ウィンドウ内の最も一般的な値に基づいて新しいセル値を決定します。これは最近隣内挿法と同様、主に不連続データに対して使用されますが、一般に [最頻値] オプションは [最近隣内挿法] に比べてスムーズな結果が得られます。最頻値リサンプリング手法では、出力セルの中心に最も近い対応する 4 x 4 のセルを入力空間で検出し、4 x 4 の隣接セルの最頻値を使用します。
  • 共一次内挿法 - 共一次内挿法を実行し、4 つの最近隣入力セルの中心の重み付けされた距離に基づいてセルの新しい値を決定します。このオプションは連続データに有効で、ある程度データをスムージングします。
  • 三次たたみ込み内挿法 - 三次たたみ込み内挿法を実行し、16 の最近隣入力セルの中心を通る滑らかなカーブの適合に基づいて、セルの新しい値を算出します。この方法は、連続データに適していますが、入力ラスターの範囲外の値を含んだ出力ラスターを生成することがあります。このことが容認できない場合は、代わりに [共一次内挿法] を使用してください。三次たたみ込み内挿法の出力は、最近隣内挿法リサンプリング アルゴリズムを実行して得られたラスターに比べて、幾何学的に歪みが少なくなります。[三次たたみ込み内挿法] オプションの欠点は、所要処理時間が相対的に長いことです。

  カテゴリ データに対しては、[共一次内挿法] オプションと [三次たたみ込み内挿法] オプションを使用しないでください。セル値が変更されてしまう場合があるためです。

• 出力空間のピクセルの中心が、入力セルのピクセルの 1 つとまったく同じになる場合、その特定のセル値はすべてのウェイトを取得するため、出力ピクセルがセルの中心と同じになります。これは、共一次内挿法と三次たたみ込み内挿法の結果に影響を与えます。

• 出力ラスター データセットの左下隅は、入力ラスター データセットの左下隅と同じマップ空間座標位置になります。

• 出力ラスター内の行数と列数は、次の式で計算されます。

  columns = (xmax - xmin) / cell size rows = (ymax - ymin) / cell size

• 上記の式に剰余が生じた場合、列と行の数に対して丸めが実行されます。

• このツールでは多次元ラスター データをサポートします。多次元ラスターの各スライスでこのツールを実行して多次元ラスター出力を生成するには、出力を CRF に保存してください。

  サポートされている入力多次元データセット タイプには、多次元ラスター レイヤー、モザイク データセット、イメージ サービスおよび CRF が含まれます。

構文

arcpy.management.Resample(in_raster, out_raster, {cell_size}, {resampling_type})

パラメーター	説明	データ タイプ
in_raster	変更される空間解像度を持つラスター データセット。	Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
out_raster	作成されるデータセットの名前、場所、および形式。 .bil(Esri BIL) .bip(Esri BIP) .bmp(BMP) .bsq(Esri BSQ) .dat(ENVI DAT) .gif(GIF) .img(ERDAS IMAGINE) .jpg(JPEG) .jp2(JPEG 2000) .png(PNG) .tif(TIFF) .mrf (MRF) .crf (CRF) 拡張子なし (Esri GRID) ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。ラスター データセットを JPEG 形式、JPEG 2000 形式、TIFF 形式、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。	Raster Dataset
cell_size (オプション)	既存のラスター データセットを使用するか、幅 (x) と高さ (y) を指定することによって、新しいラスターのセル サイズを設定します。 セル サイズは次の方法で指定できます。 1 つの値を使用して、正方形のセル サイズを指定します。 2 つの値を使用して、X および Y のセル サイズを指定します。値は空白で区切ります。 ラスター データセットのパスを使用して、ラスター データセットから正方形のセル サイズをインポートします。	Cell Size XY
resampling_type (オプション)	使用するリサンプリング手法を指定します。 NEAREST — 最近隣内挿法は、新しい値が作成されないため、ピクセル値の変更を最小限に抑える最速のリサンプリング方法です。土地被覆のような不連続なデータに適しています。 BILINEAR — 共一次内挿法は、周囲 4 ピクセルの値を平均 (距離に対する加重平均) して、各ピクセルの値を計算します。連続的なデータに適しています。 CUBIC — 三次たたみ込み内挿法は、周囲 16 ピクセルを基準にした滑らかな曲線と一致させて、各ピクセルの値を計算します。最も滑らかな画像が生成される一方、ソース データの範囲外に値が作成されます。連続的なデータに適しています。 MAJORITY —最頻値リサンプリングは、3 x 3 のウィンドウ内に最も頻出する値に基づいて、各ピクセルの値を決定します。不連続なデータに適しています。	String

コードのサンプル

Resample (リサンプリング) の例 1 (Python ウィンドウ)

以下は、Resample 関数を実行する Python サンプルです。

import arcpy
arcpy.Resample_management("c:/data/image.tif", "resample.tif", "10 20", "NEAREST")

Resample (リサンプリング) の例 2 (スタンドアロン スクリプト)

以下は、Resample 関数を実行する Python スクリプト サンプルです。

# Resample TIFF image to a higher resolution

import arcpy
arcpy.env.workspace = r"C:/Workspace"
    
arcpy.Resample_management("image.tif", "resample.tif", "10", "CUBIC")

環境

圧縮, 現在のワークスペース, 範囲, 地理座標系変換, NoData, 出力データのコンフィグレーション キーワード, 出力座標系, 並列処理ファクター, ピラミッド, ラスターの統計情報, リサンプリング方法, テンポラリ ワークスペース, スナップ対象ラスター, タイル サイズ

ライセンス情報

• Basic: はい
• Standard: はい
• Advanced: はい