tforminv

逆方向の N 次元空間変換の適用

2 次元および 3 次元の幾何学的変換の場合、関数 tforminv は推奨されません。代わりに関数 transformPointsInverse を使用してください。詳細については、バージョン履歴を参照してください。

構文

[U1,U2,...,U_ndims_in] = tforminv(T,X1,X2,...,X_ndims_out)

U = tforminv(T,X)

[U1,U2,...,U_ndims_in] = tforminv(T,X)

U = tforminv(T,X1,X2,...,X_ndims_out)

説明

[U1,U2,...,U_ndims_in] = tforminv(T,X1,X2,...,X_ndims_out) は T で定義された ndims_out から ndims_in への逆変換を座標配列 X1,X2,...,X_ndims_out に適用します。変換により点 [X1(k) X2(k) ... X_ndims_out(k)] を点 [U1(k) U2(k) ... U_ndims_in(k)] にマッピングします。

入力座標配列 ndims_out の数は、T.ndims_out と等しくなければなりません。出力座標配列 ndims_in の数は、T.ndims_in と等しくなければなりません。配列 X1,X2,...,X_ndims_out は任意の次元にできますが、サイズは同じでなければなりません。出力配列 U1,U2,...,U_ndims_in もこのサイズでなければなりません。

U = tforminv(T,X) は T で定義された ndims_out から ndims_in への逆変換を配列 X に適用します。

• X が m 行 ndims_out 列の次元を持つ 2 次元行列の場合、U は m 行 ndims_in 列の次元を持つ 2 次元行列です。tforminv は、変換を X の各行に適用します。tforminv は、点 X(k, : ) を点 U(k, : ) にマッピングします。

• X が (N+1) 次元配列の場合、tforminv は、点 X(k₁, k₂, … ,k_N, : ) を点 U(k₁, k₂, … ,k_N, : ) にマッピングします。

  size(X,N+1) は ndims_out と等しくなければなりません。U は (N+1) 次元配列で、size(U,I) は I = 1, … ,N の場合 size(X,I) と等しく、size(U,N+1) は ndims_in に等しくなります。

構文 U = tforminv(X,T) はこの構文の古い形式であり、下位互換性のために引き続きサポートされています。

[U1,U2,...,U_ndims_in] = tforminv(T,X) は、(N+1) 次元の配列をサイズの等しい N 次元の配列 ndims_in にマッピングします。

U = tforminv(T,X1,X2,...,X_ndims_out) は、N 次元の配列 ndims_out を 1 つの (N+1) 次元の配列にマッピングします。

例

アフィン変換の作成と逆方向のマッピングによる検証

頂点 (0,0)、(6,3)、(-2,5) をもつ三角形を頂点 (-1,-1)、(0,-10)、(4,4) をもつ三角形にマッピングするアフィン変換を作成します。

u = [ 0   6  -2]';
v = [ 0   3   5]';
x = [-1   0   4]';
y = [-1 -10   4]';
tform = maketform('affine',[u v],[x y]);

tforminv を適用することによってマッピングを検証します。結果は u および v と等しくなります。

[um, vm] = tforminv(tform, x, y)

um = 3×1

         0
    6.0000
   -2.0000

vm = 3×1

         0
    3.0000
    5.0000

入力引数

T — 空間変換

TFORM 空間変換構造体

空間変換。TFORM 空間変換構造体として指定します。関数 maketform を使用して T を作成します。

データ型: struct

X — 入力座標点

数値配列

入力座標点。数値配列として指定します。X のサイズと次元には、使用される構文に応じて追加の制限があります。

データ型: double

X1,X2,...,X_ndims_out — 入力座標点

複数の数値配列

入力座標点。複数の数値配列として指定します。X1,X2,...,X_ndims_out のサイズと次元には、使用される構文に応じて追加の制限があります。

データ型: double

出力引数

U — 出力点の座標配列

数値配列

出力点の座標配列。数値配列として返されます。U のサイズと次元には、使用される構文に応じて追加の制限があります。

U1,U2,...,U_ndims_in — 出力点の座標

複数の数値配列

出力点の座標。複数の配列で返されます。U1,U2,...,U_ndims_in のサイズと次元には、使用される構文に応じて追加の制限があります。

拡張機能

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2006a より前に導入

R2021b: スレッドベース環境のサポート

tforminv は、スレッドベースの環境をサポートするようになりました。

R2018b: 2 次元および 3 次元の幾何学的変換の場合、tforminv は非推奨

2 次元および 3 次元の幾何学的変換の場合、関数 tforminv は推奨されません。代わりに、2 次元または 3 次元の幾何学的変換オブジェクトを作成してから、関数 transformPointsInverse を使用してください。幾何学的変換オブジェクトの詳細については、2 次元リフティングおよび 3 次元リフティング、ローカル多項式変換、ローラン多項式を参照してください。

次の表は、代替コードの使用が推奨される tforminv の構文を示しています。

非推奨の使用方法	推奨される代替案
TFORM 構造体 T で定義された逆方向の 2 次元アフィン変換を座標配列 X と Y に適用し、点 [X(k) Y(k)] を点 [U(k) V(k)] にマッピングします。 [U,V] = tforminv(T,X,Y);	affinetform2d オブジェクト T および関数 transformPointsInverse を使用して、逆方向の 2 次元アフィン変換を適用します。 [U,V] = transformPointsInverse(T,X,Y);

参考

maketform | fliptform | tformfwd | transformPointsInverse

トピック

• N 次元空間変換