リンク ファイルによる幾何補正 (Warp From File) (データ管理)

サマリー

ソースおよびターゲット コントロール ポイントを含む既存のテキスト ファイルを使用してラスター データセットを座標変換します。

2 次元の座標変換の例

使用法

  • [幾何補正 (Warp)] は、多項式を使用してモデリングされる体系的な地理補正をラスターが必要とする場合に便利です。空間変換では、適切な次数の多項式変換を使用して、歪みを転化または削除できます。次数が高いほど、より複雑な歪みを補正できます。多項式の次数が高くなると、それだけ処理時間が長くなります。

  • デフォルトの多項式の次数では、アフィン変換が実行されます。

  • 特定の多項式の次数に必要なリンクの最小数を特定するには、次の式を使用します。

    n = (p + 1) (p + 2) / 2

    n は、次数 p の多項式に必要なリンクの最小数です。最低限必要なリンク数よりも多くのリンクを使用することをお勧めします。

  • このツールは、幾何補正されたラスターの範囲を決定し、ロウとカラムの数を入力ラスター内とほぼ同数になるように設定します。X と Y 方向おける出力ラスターのサイズ間の比率の変更により、わずかな差異がいくつか生じる場合があります。使用されるデフォルトのセル サイズは、以前に決定されたロウとカラムの数で範囲を分割して計算されます。セル サイズの値は、リサンプリング アルゴリズムで使用されます。

    環境設定で出力セル サイズを定義する場合、ロウとカラムの数は次のように計算されます。

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

  • ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。

  • 入力リンク ファイルの各行は、次の値を持ちます。それぞれの値は、タブで区切られます。

    <From X> <From Y> <To X> <To Y>

    ここで、各行はコントロール ポイント ペアの座標を表します。残差値を含む追加の列を存在させることもできますが、必須ではありません。

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

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

パラメーター

ラベル説明データ タイプ
入力ラスター

変換されるラスター。

Mosaic Layer; Raster Layer
出力ラスター データセット

作成するデータセットの名前、場所、および形式。ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納する場合は、環境設定を使用して圧縮タイプと圧縮品質を指定できます。

  • .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)
Raster Dataset
リンク ファイル

入力ラスターを幾何補正するための座標を含む、テキスト、CSV ファイル、または TAB ファイル。これは、[ラスターの位置合わせ (Register Raster)] ツール、または [ジオリファレンス] タブから生成できます。

Text File
変換タイプ
(オプション)

ラスター データセットをシフトさせるための変換方法を指定します。

  • シフトのみ0 次多項式はデータをシフトするために使用されます。 すでにジオリファレンスされているデータをほんの少しだけずらしたい、というときによく使用されます。 0 次多項式シフトに必要なリンクは 1 つだけです。
  • アフィン変換1 次多項式 (アフィン) は、単純な平面を入力ポイントに当てはめるために使用されます。
  • 2 次多項式変換2 次多項式は、やや複雑なサーフェスを入力ポイントに当てはめるために使用されます。
  • 3 次多項式変換3 次多項式は、さらに複雑なサーフェスを入力ポイントに当てはめるために使用されます。
  • グローバルおよびローカルの精度を最適化多項式変換は、グローバルとローカルの両方の精度を最適化する TIN (不規則三角形網) 内挿法と組み合わせられます。
  • スプライン変換ソース コントロール ポイントはターゲット コントロール ポイントに正確に変換されます。 出力では、コントロール ポイントは正確ですが、コントロール ポイント間のラスター ピクセルは正確ではありません。
  • 射影変換ラインは直線に保てるように幾何補正されます。 変換前に平行であったラインが平行でなくなる場合があります。 射影変換は、特に傾斜した画像、スキャン マップ、その他の画像製品で役立ちます。
  • 相似変換元のラスターの形状を維持しようとする一次変換が使用されます。 ベスト フィットより形状の維持が重要であるため、他の多項式変換と比べて RMS エラーが高くなる傾向があります。
String
リサンプリング手法
(オプション)

使用するリサンプリング アルゴリズム。

[最近隣内挿法] オプションと [最頻値] オプションは、土地利用分類などのカテゴリ データに使用されます。 [最近隣内挿法] オプションがデフォルトです。 最も高速であり、ピクセル値を変更しません。 これらのオプションを標高サーフェスなどの連続データに使用しないでください。

[共一次内挿法] オプションと [三次たたみ込み内挿法] オプションは、連続データに最も適しています。 ピクセル値が変更される可能性があるため、これらのオプションをカテゴリ データに使用しないことをお勧めします。

  • 最近隣内挿法最近隣内挿法を使用します。 新しい値は作成されないため、ピクセル値の変更を最小限に抑える最速のリサンプリング方法です。 土地被覆のような不連続なデータに適しています。
  • 共一次内挿法共一次内挿法を使用します。 周囲 4 ピクセルの値を平均 (距離に対する加重平均) して、各ピクセルの値を計算します。 連続的なデータに適しています。
  • 三次たたみ込み内挿法三次たたみ込み内挿法を使用します。 周囲 16 ピクセルを基準にした滑らかな曲線と一致させて、各ピクセルの値を計算します。 最も滑らかな画像が生成される一方、ソース データの範囲外に値が作成されます。 連続的なデータに適しています。
  • 最頻値リサンプリング最頻値リサンプリング手法を使用します。 4 x 4 のウィンドウ内に最も頻出する値に基づいて、各ピクセルの値を決定します。 不連続なデータに適しています。
String

arcpy.management.WarpFromFile(in_raster, out_raster, link_file, {transformation_type}, {resampling_type})
名前説明データ タイプ
in_raster

変換されるラスター。

Mosaic Layer; Raster Layer
out_raster

作成するデータセットの名前、場所、および形式。ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。ラスター データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納する場合は、環境設定を使用して圧縮タイプと圧縮品質を指定できます。

  • .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)
Raster Dataset
link_file

入力ラスターを幾何補正するための座標を含む、テキスト、CSV ファイル、または TAB ファイル。これは、[ラスターの位置合わせ (Register Raster)] ツール、または [ジオリファレンス] タブから生成できます。

Text File
transformation_type
(オプション)

ラスター データセットをシフトさせるための変換方法を指定します。

  • POLYORDER00 次多項式はデータをシフトするために使用されます。 すでにジオリファレンスされているデータをほんの少しだけずらしたい、というときによく使用されます。 0 次多項式シフトに必要なリンクは 1 つだけです。
  • POLYSIMILARITY元のラスターの形状を維持しようとする一次変換が使用されます。 ベスト フィットより形状の維持が重要であるため、他の多項式変換と比べて RMS エラーが高くなる傾向があります。
  • POLYORDER11 次多項式 (アフィン) は、単純な平面を入力ポイントに当てはめるために使用されます。
  • POLYORDER22 次多項式は、やや複雑なサーフェスを入力ポイントに当てはめるために使用されます。
  • POLYORDER33 次多項式は、さらに複雑なサーフェスを入力ポイントに当てはめるために使用されます。
  • ADJUST多項式変換は、グローバルとローカルの両方の精度を最適化する TIN (不規則三角形網) 内挿法と組み合わせられます。
  • SPLINEソース コントロール ポイントはターゲット コントロール ポイントに正確に変換されます。 出力では、コントロール ポイントは正確ですが、コントロール ポイント間のラスター ピクセルは正確ではありません。
  • PROJECTIVEラインは直線に保てるように幾何補正されます。 変換前に平行であったラインが平行でなくなる場合があります。 射影変換は、特に傾斜した画像、スキャン マップ、その他の画像製品で役立ちます。
String
resampling_type
(オプション)

使用するリサンプリング アルゴリズム。

  • NEAREST最近隣内挿法を使用します。 新しい値は作成されないため、ピクセル値の変更を最小限に抑える最速のリサンプリング方法です。 土地被覆のような不連続なデータに適しています。
  • BILINEAR共一次内挿法を使用します。 周囲 4 ピクセルの値を平均 (距離に対する加重平均) して、各ピクセルの値を計算します。 連続的なデータに適しています。
  • CUBIC三次たたみ込み内挿法を使用します。 周囲 16 ピクセルを基準にした滑らかな曲線と一致させて、各ピクセルの値を計算します。 最も滑らかな画像が生成される一方、ソース データの範囲外に値が作成されます。 連続的なデータに適しています。
  • MAJORITY最頻値リサンプリング手法を使用します。 4 x 4 のウィンドウ内に最も頻出する値に基づいて、各ピクセルの値を決定します。 不連続なデータに適しています。

[最近隣内挿法] オプションと [最頻値] オプションは、土地利用分類などのカテゴリ データに使用されます。 [最近隣内挿法] オプションがデフォルトです。 最も高速であり、ピクセル値を変更しません。 これらのオプションを標高サーフェスなどの連続データに使用しないでください。

[共一次内挿法] オプションと [三次たたみ込み内挿法] オプションは、連続データに最も適しています。 ピクセル値が変更される可能性があるため、これらのオプションをカテゴリ データに使用しないことをお勧めします。

String

コードのサンプル

WarpFromFile (リンク ファイルによる幾何補正) の例 1 (Python ウィンドウ)

以下は、WarpFromFile ツールを実行する Python サンプルです。

import arcpy
arcpy.WarpFromFile_management(
     "\\cpu\data\raster.img", "\\cpu\data\warp_out.tif",
     "\\cpu\data\gcpfile.txt", "POLYORDER2", "BILINEAR")
WarpFromFile (リンク ファイルによる幾何補正) の例 2 (スタンドアロン スクリプト)

以下は、WarpFromFile ツールを実行する Python スクリプト サンプルです。

##Warp image with signiture file

import arcpy
arcpy.env.workspace = r"C:/Workspace"
    
    
arcpy.WarpFromFile_management("raster.img", "warp_output.tif", "gcpfile.txt", 
                      "POLYORDER2", "BILINEAR")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック