リンク ファイルによる幾何補正 (Warp From File)

概要

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

図

使用法

• [幾何補正 (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>

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

構文

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 (オプション)	ラスター データセットをシフトさせるための変換方法を指定します。 POLYORDER0 — 0 次多項式を使用してデータをシフトします。すでにジオリファレンスされているデータをほんの少しだけずらしたい、というときによく使用されます。0 次多項式シフトに必要なリンクは 1 つだけです。 POLYSIMILARITY — 元のラスターの形状の維持しようとする一次変換です。ベスト フィットより形状の維持が重要であるため、他の多項式変換と比べて RMS エラーが高くなる傾向があります。 POLYORDER1 —1 次多項式 (アフィン) は、単純な平面を入力ポイントに当てはめます。 POLYORDER2 —2 次多項式は、やや複雑なサーフェスを入力ポイントに当てはめます。 POLYORDER3 —3 次多項式は、さらに複雑なサーフェスを入力ポイントに当てはめます。 ADJUST — 多項式変換と組み合わせて TIN (不規則三角形網) 内挿法を使用し、グローバルとローカルの両方の精度を最適化します。 SPLINE — ソース コントロール ポイントをターゲット コントロール ポイントに正確に変換します。出力では、コントロール ポイントは正確ですが、コントロール ポイント間のラスター ピクセルは正確ではありません。 PROJECTIVE — ラインを直線に保つように補正します。この変換を行うと、変換前に平行であったラインが平行でなくなる場合があります。射影変換は、特に傾斜した画像、スキャン マップ、その他の画像製品で役立ちます。	String
resampling_type (オプション)	使用するリサンプリング アルゴリズム。 NEAREST — 最近隣内挿法は、新しい値が作成されないため、ピクセル値の変更を最小限に抑える最速のリサンプリング方法です。土地被覆のような不連続なデータに適しています。 BILINEAR — 共一次内挿法は、周囲 4 ピクセルの値を平均 (距離に対する加重平均) して、各ピクセルの値を計算します。連続的なデータに適しています。 CUBIC — 三次たたみ込み内挿法は、周囲 16 ピクセルを基準にした滑らかな曲線と一致させて、各ピクセルの値を計算します。最も滑らかな画像が生成される一方、ソース データの範囲外に値が作成されます。連続的なデータに適しています。 MAJORITY —最頻値リサンプリングは、3 x 3 のウィンドウ内に最も頻出する値に基づいて、各ピクセルの値を決定します。不連続なデータに適しています。 NEAREST オプションと MAJORITY オプションは、土地利用分類などのカテゴリ データに使用されます。デフォルトは NEAREST オプションです。これは、このオプションが最速であり、セル値を変更しないからです。 これらを標高サーフェスなどの連続データに使用しないでください。 BILINEAR オプションと CUBIC オプションは、連続データに最も適しています。 セル値が変更される可能性があるため、これらをカテゴリ データに使用することは推奨されません。	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")

環境

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

ライセンス情報

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