変換エラーの計算 (編集ツール)

サマリー

座標変換に使用する既知のコントロールポイント間の入力リンクの座標に基づいて、残差エラーと RMSE (二乗平均平方根誤差) を計算します。

使用法

このツールは、フィーチャの座標補正 ツールの前に使用され、特に多数のフィーチャを変換する前に、コントロールポイントが対象の変換に対して十分あるかどうかが判定されます。
入力リンクフィーチャは、対応するコントロールポイント間の変換リンクを表すラインです。
変換は、直交座標系または平面座標系で機能します。 PCS (投影座標系) をお勧めします。緯度と経度の値を持つ GCS (地理座標系) を使用すると、歪みや計算エラーが発生する可能性があります。
エラーは、アフィン変換、相似変換、射影変換という 3 つの変換方式のいずれかに対して計算されます。各方式には、最低数の変換リンクが必要です。変換式などの詳細については、「フィーチャの座標補正」をご参照ください。
- AFFINE—少なくとも 3 つの変換リンクが必要です。
- PROJECTIVE—少なくとも 4 つの変換リンクが必要です。
- SIMILARITY—少なくとも 2 つの変換リンクが必要です。
変換結果は、入力リンクの質によって異なります。リンクは既知のソース位置から開始し、対応するターゲット位置で終了します。これらの位置は、コントロールポイントとも呼ばれます。コントロールポイントがよりよく確立されているほど、変換結果の精度が高くなります。リンクの起終点の座標を使用して、変換式で使用されるパラメーターを取得します。これらは、「フィーチャの座標補正」で説明するように、ソースとターゲットのコントロールポイント間で最適なものです。変換パラメーターに基づいて実際のソースコントロールポイントを変換した場合でも、結果の位置はターゲットコントロールポイントの位置と一致しません。この不一致は残差エラーと呼ばれ、各変換リンクで発生します。入力リンクの残差エラーは、指定された出力テーブルに書き込まれます。このテーブルには、次のフィールドが含まれています。
- Orig_FID—入力リンクフィーチャの ID
- X_Source—リンクのソース位置または始点の X 座標
- Y_Source—リンクのソース位置または始点の Y 座標
- X_Destination—リンクのターゲット位置または終点の X 座標
- Y_Destination—リンクのターゲット位置または終点の Y 座標
- Residual_Error—変換後の位置の残差エラー
RMSD (二乗平均平方根偏差) とも呼ばれる RMSE は、残差エラーに基づいて計算され、通常、得られた変換結果の適切さの尺度となります。 RMSE 値は、処理メッセージに書き込まれます。これは、スクリプトまたはモデルワークフローで使用できる派生出力パラメーターにもなります。

「フィーチャの座標補正」トピックに、残差エラーと RMSE の計算に関する詳細が記載されています。入力フィーチャとコントロールポイントの位置精度に関する知識を基に、ユーザーが許容可能な RMSE 値を決める必要があります。 RMSE 値が大きすぎると、残差エラーを確認して、残差エラーの大きいリンクを破棄または置換する必要が生じます。

ラベル説明データタイプ

ラベル	説明	データタイプ
入力リンクフィーチャ	座標変換に使用する既知のコントロールポイント間の変換リンクである入力リンクフィーチャ。	Feature Layer
出力リンクテーブル (オプション)	入力リンクのフィーチャ ID とその残差エラーを含む出力テーブル。入力リンクの残差エラーは、指定された出力テーブルに書き込まれます。このテーブルには、次のフィールドが含まれています。 `Orig_FID`—入力リンクフィーチャの ID `X_Source`—リンクのソース位置または始点の X 座標 `Y_Source`—リンクのソース位置または始点の Y 座標 `X_Destination`—リンクのターゲット位置または終点の X 座標 `Y_Destination`—リンクのターゲット位置または終点の Y 座標 `Residual_Error`—変換後の位置の残差エラー	Table
方法 (オプション)	入力フィーチャの座標変換に使用する変換方式を指定します。アフィン変換—少なくとも 3 つの変換リンクが必要です。これがデフォルトです。射影変換—少なくとも 4 つの変換リンクが必要です。相似変換—少なくとも 2 つの変換リンクが必要です。	String

入力リンクフィーチャ

座標変換に使用する既知のコントロールポイント間の変換リンクである入力リンクフィーチャ。

Feature Layer

出力リンクテーブル

(オプション)

入力リンクのフィーチャ ID とその残差エラーを含む出力テーブル。入力リンクの残差エラーは、指定された出力テーブルに書き込まれます。このテーブルには、次のフィールドが含まれています。

Orig_FID—入力リンクフィーチャの ID
X_Source—リンクのソース位置または始点の X 座標
Y_Source—リンクのソース位置または始点の Y 座標
X_Destination—リンクのターゲット位置または終点の X 座標
Y_Destination—リンクのターゲット位置または終点の Y 座標
Residual_Error—変換後の位置の残差エラー

Table

方法

(オプション)

入力フィーチャの座標変換に使用する変換方式を指定します。

アフィン変換—少なくとも 3 つの変換リンクが必要です。これがデフォルトです。
射影変換—少なくとも 4 つの変換リンクが必要です。
相似変換—少なくとも 2 つの変換リンクが必要です。

String

派生した出力

ラベル	説明	データタイプ
RMSE	RMSE (二乗平均平方根誤差) の値をレポートします。	Double

arcpy.edit.CalculateTransformationErrors(in_link_features, {out_link_table}, {method})

名前説明データタイプ

名前	説明	データタイプ
in_link_features	座標変換に使用する既知のコントロールポイント間の変換リンクである入力リンクフィーチャ。	Feature Layer
out_link_table (オプション)	入力リンクのフィーチャ ID とその残差エラーを含む出力テーブル。入力リンクの残差エラーは、指定された出力テーブルに書き込まれます。このテーブルには、次のフィールドが含まれています。 `Orig_FID`—入力リンクフィーチャの ID `X_Source`—リンクのソース位置または始点の X 座標 `Y_Source`—リンクのソース位置または始点の Y 座標 `X_Destination`—リンクのターゲット位置または終点の X 座標 `Y_Destination`—リンクのターゲット位置または終点の Y 座標 `Residual_Error`—変換後の位置の残差エラー	Table
method (オプション)	入力フィーチャの座標変換に使用する変換方式を指定します。 `AFFINE`—少なくとも 3 つの変換リンクが必要です。これがデフォルトです。 `PROJECTIVE`—少なくとも 4 つの変換リンクが必要です。 `SIMILARITY`—少なくとも 2 つの変換リンクが必要です。	String

in_link_features

座標変換に使用する既知のコントロールポイント間の変換リンクである入力リンクフィーチャ。

Feature Layer

out_link_table

(オプション)

Orig_FID—入力リンクフィーチャの ID
X_Source—リンクのソース位置または始点の X 座標
Y_Source—リンクのソース位置または始点の Y 座標
X_Destination—リンクのターゲット位置または終点の X 座標
Y_Destination—リンクのターゲット位置または終点の Y 座標
Residual_Error—変換後の位置の残差エラー

Table

method

(オプション)

入力フィーチャの座標変換に使用する変換方式を指定します。

AFFINE—少なくとも 3 つの変換リンクが必要です。これがデフォルトです。
PROJECTIVE—少なくとも 4 つの変換リンクが必要です。
SIMILARITY—少なくとも 2 つの変換リンクが必要です。

String

派生した出力

名前	説明	データタイプ
out_rmse	RMSE (二乗平均平方根誤差) の値をレポートします。	Double

コードのサンプル

CalculateTransformationErrors の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードで CalculateTransformationErrors 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data/Countries.gdb"
arcpy.edit.CalculateTransformationErrors("control_Links", "output_Table", "AFFINE")

CalculateTransformationErrors の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、CalculateTransformationErrors 関数をスクリプティング環境で適用する方法の例を示しています。

import arcpy
import os

# All input data is in country.gdb and output will also go to this gdb
arcpy.env.workspace = os.path.join(os.getcwd(), "country.gdb")

in_links_feats = "link_features"
out_link_table = "output_table"

# Transformation method
method = "SIMILARITY"

result = arcpy.edit.CalculateTransformationErrors(in_links_feats, out_link_table, method)

# Get the transformation error
error = float(result.getOutput(1))

# If error is less than 12.234, run Transform Features
if error < 20.0:
    # Make a copy of the input features
    arcpy.management.CopyFeatures(in_links_feats, "in_links_copy")
    arcpy.edit.TransformFeatures("in_links_copy", in_links_feats, method, "out_link_table")
else:
    print("Transformation error {} is too high".format(error))

環境

現在のワークスペース, 範囲

ライセンス情報

Basic: いいえ
Standard: いいえ
Advanced: はい

変換エラーの計算 (編集ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック