ラスターの位置合わせ (Register Raster) (データ管理)—ArcGIS Pro

サマリー

ラスターの位置を参照画像に自動的に合わせるか、コントロールポイントファイルを使用して地理的位置合わせを行います。入力データセットがモザイクデータセットである場合、このツールは各モザイクデータセットアイテムに対して動作します。画像を自動位置合わせするには、入力ラスターと参照ラスターの地理的範囲が比較的近い必要があります。それぞれのラスターデータセットの位置が近いと、このツールの実行速度が速くなります。入力ラスターを同じマップ空間に入れるには、いくつかのリンクを含むリンクファイル (コントロールポイントファイルとも呼ばれている) の作成が必要な場合があります。

使用法

入力ラスターのジオリファレンス情報が更新されます。
[ジオリファレンス] タブを使用して、コントロールポイントテーブルを作成できます。
[リセット] キーワード (Python では register_mode = "RESET") を使用すると、このツールを使用して適用されている地理座標系変換をすべて削除できます。
このツールでは、モザイクデータセット内のすべてのアイテム、アイテムのサブセット、またはモザイクデータセット内の 1 つのアイテムを位置合わせできます。特定の 1 つのアイテムだけを位置合わせする場合は、モザイクデータセットの絶対パスと、更新するアイテムが一意に特定されるクエリを入力する必要があります。
モザイクデータセット内のアイテムを入力ラスターとして選択する方法の例を次に示します。
- \\Myserver\MyFolder\MyMosaicDataset\OBJECTID=1
- \\Myserver\MyFolder\MyMosaicDataset\NAME='tileName01'
アイテムのサブセットを選択する場合は、モザイクデータセットレイヤーに対して選択できます。
Python では、入力ラスターがパンシャープンアイテムを含むモザイクデータセットである場合、[位置合わせモード] パラメーター内で、[位置合わせ (マルチスペクトル)] キーワードを選択すると (Python では register_mode = "REGISTER_MS")、このツールでマルチスペクトルラスターをパンクロマティックラスターに位置合わせすることができます。必ず、[参照ラスター] および [入力リンクファイル] パラメーターを空のままにしておいてください。

パラメーター

ラベル	説明	データタイプ
入力ラスター	再度位置合わせするラスター。モザイクデータセットアイテムの位置合わせでアップデートされるのは、モザイクデータセット内の特定のアイテムです。モザイクデータセットのパスは、モザイクデータセットの後ろにアイテムの Object ID が続きます。たとえば、モザイクデータセット内の最初のアイテムのパスは、次のようになります。.\mosaicDataset\objectid=1	Mosaic Layer; Raster Dataset; Raster Layer
位置合わせモード	位置合わせモードを指定します。ラスターに変換を適用するか、変換をリセットすることができます。位置合わせ—地理座標系変換を入力ラスターに適用します。位置合わせ (マルチスペクトル)—マルチスペクトル入力をパンクロマティック入力に位置合わせします。これは、2 つのモザイクデータセット間に位置のずれがある場合にのみ使用されます。リセット—このツールが以前に追加した地理座標系変換を削除します。リンクの作成—自動生成されるリンクからリンクファイルを作成します。	String
参照ラスター (オプション)	入力ラスターデータセットの位置合わせの基準となるラスターデータセットを指定します。マルチスペクトルモザイクデータセットアイテムを、関連するパンクロマティックラスターデータセットに位置合わせをする場合、このパラメーターを空のままにします。	Image Service; Internet Tiled Layer; Map Server Layer; Map Server; Mosaic Layer; Raster Dataset; Raster Layer; WMS Map
入力リンクファイル (オプション)	入力ラスターデータセットを参照データとリンクさせるための座標を含むファイル。入力リンクテーブルは、モザイクレイヤー内の 1 つのモザイクアイテムに対して機能します。入力では、処理対象のアイテムを選択するか、ObjectID を指定して、そのアイテムを指定する必要があります。マルチスペクトルモザイクデータセットアイテムを、関連するパンクロマティックラスターデータセットに位置合わせするには、このパラメーターを空のままにします。	Feature Class; Text File
変換タイプ (オプション)	ラスターデータセットをシフトさせるための方法を指定します。シフトのみ—0 次多項式を使用してデータをシフトします。すでにジオリファレンスされているデータをほんの少しだけずらしたい、というときによく使用されます。 0 次多項式シフトに必要なリンクは 1 つだけです。アフィン変換—1 次多項式 (アフィン) は、単純な平面を入力ポイントに当てはめます。 2 次多項式変換—2 次多項式は、やや複雑なサーフェスを入力ポイントに当てはめます。 3 次多項式変換—3 次多項式は、さらに複雑なサーフェスを入力ポイントに当てはめます。アジャスト変換—多項式変換と組み合わせて TIN (不規則三角形網) 内挿法を使用し、グローバルとローカルの両方の精度を最適化します。スプライン変換—ソースコントロールポイントをターゲットコントロールポイントに正確に変換します。出力では、コントロールポイントは正確ですが、コントロールポイント間のラスターピクセルは正確ではありません。射影変換—ラインを直線に保つように補正します。この変換を行うと、変換前に平行であったラインが平行でなくなる場合があります。射影変換は、特に傾斜した画像、スキャンマップ、その他の画像製品で役立ちます。相似変換—元のラスターの形状の維持しようとする一次変換です。ベストフィットより形状の維持が重要であるため、他の多項式変換と比べて RMS エラーが高くなる傾向があります。フレーム変換—空中画像に対して画像切除アルゴリズムを使用します。画像切除アルゴリズムは、最小二乗法を使用して、既知の地上コントロールポイントから画像の外部標定 (3 次元表示、ω、φ、κ) を精密に設定します。各画像は同一線上にないポイントを少なくとも 3 つ持つ必要があります。入力がモザイクデータセットの場合は、選択された画像を一度に 1 つ登録します。	String
出力リンクファイル (オプション)	指定された場合、このツールによって作成されたリンクを含むテキストファイルが書き込まれます。このファイルは、[リンクファイルによる幾何補正 (Warp From File)] ツールで使用できます。出力リンクテーブルは、モザイクレイヤー内の 1 つのモザイクデータセットアイテムに対して機能します。入力では、処理対象のアイテムを選択するか、ObjectID を指定して、そのアイテムを指定する必要があります。	Text File
最大 RMS (オプション)	出力で必要とされるモデル化された誤差 (ピクセル単位) の量。デフォルト値は 0.5 です。0.3 未満の値は、過適合の状態を引き起こすため使用しないでください。	Double

派生した出力

ラベル	説明	データタイプ
位置合わせ済みのラスター	出力ラスターデータセット。	Raster Dataset

arcpy.management.RegisterRaster(in_raster, register_mode, {reference_raster}, {input_link_file}, {transformation_type}, {output_cpt_link_file}, {maximum_rms_value})

名前	説明	データタイプ
in_raster	再度位置合わせするラスター。モザイクデータセットアイテムの位置合わせでアップデートされるのは、モザイクデータセット内の特定のアイテムです。モザイクデータセットのパスは、モザイクデータセットの後ろにアイテムの Object ID が続きます。たとえば、モザイクデータセット内の最初のアイテムのパスは、次のようになります。.\mosaicDataset\objectid=1	Mosaic Layer; Raster Dataset; Raster Layer
register_mode	位置合わせモードを指定します。ラスターに変換を適用するか、変換をリセットすることができます。 REGISTER—地理座標系変換を入力ラスターに適用します。 REGISTER_MS—マルチスペクトル入力をパンクロマティック入力に位置合わせします。これは、2 つのモザイクデータセット間に位置のずれがある場合にのみ使用されます。 RESET—このツールが以前に追加した地理座標系変換を削除します。 CREATE_LINKS—自動生成されるリンクからリンクファイルを作成します。	String
reference_raster (オプション)	入力ラスターデータセットの位置合わせの基準となるラスターデータセットを指定します。マルチスペクトルモザイクデータセットアイテムを、関連するパンクロマティックラスターデータセットに位置合わせをする場合、このパラメーターを空のままにします。	Image Service; Internet Tiled Layer; Map Server Layer; Map Server; Mosaic Layer; Raster Dataset; Raster Layer; WMS Map
input_link_file (オプション)	入力ラスターデータセットを参照データとリンクさせるための座標を含むファイル。入力リンクテーブルは、モザイクレイヤー内の 1 つのモザイクアイテムに対して機能します。入力では、処理対象のアイテムを選択するか、ObjectID を指定して、そのアイテムを指定する必要があります。マルチスペクトルモザイクデータセットアイテムを、関連するパンクロマティックラスターデータセットに位置合わせするには、このパラメーターを空のままにします。	Feature Class; Text File
transformation_type (オプション)	ラスターデータセットをシフトさせるための方法を指定します。 POLYORDER0—0 次多項式を使用してデータをシフトします。すでにジオリファレンスされているデータをほんの少しだけずらしたい、というときによく使用されます。 0 次多項式シフトに必要なリンクは 1 つだけです。 POLYSIMILARITY—元のラスターの形状の維持しようとする一次変換です。ベストフィットより形状の維持が重要であるため、他の多項式変換と比べて RMS エラーが高くなる傾向があります。 POLYORDER1—1 次多項式 (アフィン) は、単純な平面を入力ポイントに当てはめます。 POLYORDER2—2 次多項式は、やや複雑なサーフェスを入力ポイントに当てはめます。 POLYORDER3—3 次多項式は、さらに複雑なサーフェスを入力ポイントに当てはめます。 ADJUST—多項式変換と組み合わせて TIN (不規則三角形網) 内挿法を使用し、グローバルとローカルの両方の精度を最適化します。 SPLINE—ソースコントロールポイントをターゲットコントロールポイントに正確に変換します。出力では、コントロールポイントは正確ですが、コントロールポイント間のラスターピクセルは正確ではありません。 PROJECTIVE—ラインを直線に保つように補正します。この変換を行うと、変換前に平行であったラインが平行でなくなる場合があります。射影変換は、特に傾斜した画像、スキャンマップ、その他の画像製品で役立ちます。 FRAME—空中画像に対して画像切除アルゴリズムを使用します。画像切除アルゴリズムは、最小二乗法を使用して、既知の地上コントロールポイントから画像の外部標定 (3 次元表示、ω、φ、κ) を精密に設定します。各画像は同一線上にないポイントを少なくとも 3 つ持つ必要があります。入力がモザイクデータセットの場合は、選択された画像を一度に 1 つ登録します。	String
output_cpt_link_file (オプション)	指定された場合、このツールによって作成されたリンクを含むテキストファイルが書き込まれます。このファイルは、[リンクファイルによる幾何補正 (Warp From File)] ツールで使用できます。出力リンクテーブルは、モザイクレイヤー内の 1 つのモザイクデータセットアイテムに対して機能します。入力では、処理対象のアイテムを選択するか、ObjectID を指定して、そのアイテムを指定する必要があります。	Text File
maximum_rms_value (オプション)	出力で必要とされるモデル化された誤差 (ピクセル単位) の量。デフォルト値は 0.5 です。0.3 未満の値は、過適合の状態を引き起こすため使用しないでください。	Double

派生した出力

名前	説明	データタイプ
out_raster	出力ラスターデータセット。	Raster Dataset

コードのサンプル

RegisterRaster (ラスターの位置合わせ) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.RegisterRaster_management(
     "\\cpu\data\nonref.tif", "REGISTER", "\\cpu\data\yesref.tif",
     "\\cpu\data\links.txt", "POLYORDER1", "#")

RegisterRaster (ラスターの位置合わせ) の例 2 (スタンドアロンスクリプト)

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

# Register raster using only control points

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
rdname = "irs_ps.img"
mode = "REGISTER"
refrd = ""
linkfile = "C:/Workspace/irs_controls_13.txt"
order = "POLYORDER2"
    
arcpy.RegisterRaster_management(
     rdname, mode, refrd, linkfile, order)

環境

並列処理ファクター

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容