transltform3d

3 次元平行移動幾何学的変換

R2022b 以降

説明

transltform3d オブジェクトは、3 次元平行移動幾何学的変換に関する情報を格納し、順変換と逆変換を可能にします。

作成

transltform3d オブジェクトは次の方法で作成できます。

• imregtform — 類似性の最適化を使用して移動イメージを固定イメージにマッピングする幾何学的変換を推定します。

• fitgeotform3d (Medical Imaging Toolbox) — 2 つのイメージの間でコントロール ポイントのペアをマッピングする幾何学的変換を推定します。

• ここで説明する関数 transltform3d。

構文

tform = transltform3d

tform = transltform3d(t)

tform = transltform3d(tx,ty,tz)

tform = transltform3d(translMat)

tform = transltform3d(tformIn)

説明

tform = transltform3d は、恒等変換を実行する transltform3d オブジェクトを作成します。

tform = transltform3d(t) は、指定された平行移動の量 t に基づいて平行移動変換を実行する transltform3d オブジェクトを作成します。

tform = transltform3d(tx,ty,tz) は、それぞれ x 方向、y 方向、z 方向の指定された平行移動の量 tx、ty、tz で平行移動変換を実行する transltform3d オブジェクトを作成します。

tform = transltform3d(translMat) は、指定された 3 次元平行移動変換行列 translMat から transltform3d オブジェクトを作成します。

tform = transltform3d(tformIn) は、別の幾何学的変換オブジェクト tformIn から、有効な 3 次元平行移動幾何学的変換を表す transltform2d オブジェクトを作成します。

入力引数

t — 平行移動の量

[0 0 0] (既定値) | 3 要素の数値ベクトル

平行移動の量。[t_x t_y t_z] 形式の 3 要素の数値ベクトルとして指定します。この平行移動の量は、A によって定義される平行移動変換行列の値 t_x、t_y、および t_z に対応します。

この引数によって Translation プロパティが設定されます。

データ型: double | single

tx — x 方向の平行移動の量

0 (既定値) | 数値スカラー

x 方向の平行移動の量。数値スカラーとして指定します。この引数は、Translation プロパティの最初の要素を設定します。

ty — y 方向の平行移動の量

0 (既定値) | 数値スカラー

y 方向の平行移動の量。数値スカラーとして指定します。この引数は、Translation プロパティの 2 番目の要素を設定します。

tz — z 方向の平行移動の量

0 (既定値) | 数値スカラー

z 方向の平行移動の量。数値スカラーとして指定します。この引数は、Translation プロパティの 3 番目の要素を設定します。

translMat — 順方向の 3 次元平行移動変換

4 行 4 列の単位行列 (既定値) | 4 行 4 列の数値行列

順方向の 3 次元平行移動変換。4 行 4 列の数値行列として指定します。このオブジェクトを作成する場合は、3 行 4 列の数値行列として translMat を指定することもできます。この場合、オブジェクトは行ベクトル [0 0 0 1] を行列の最後まで連結し、4 行 4 列の行列を作成します。

有効な 3 次元平行移動変換 A の形式は次のとおりです。

$${\rm A}=\left[\begin{array}{cccc}1& 0& 0& t_x\\ 0& 1& 0& t_y\\ 0& 0& 1& t_z\\ 0& 0& 0& 1\end{array}\right]$$

t_x、t_y、t_z はそれぞれ x 方向、y方向、z 方向の平行移動の量であり、Translation プロパティを設定します。

この引数によって A プロパティが設定されます。

データ型: double | single

tformIn — 3 次元平行移動幾何学的変換

affinetform3d オブジェクト | rigidtform3d オブジェクト | simtform3d オブジェクト | transltform3d オブジェクト

3 次元平行移動幾何学的変換。affinetform3d オブジェクト、rigidtform3d オブジェクト、simtform3d オブジェクト、または transltform3d オブジェクトとして指定します。

出力引数

tform — 3 次元平行移動幾何学的変換

transltform3d オブジェクト

3 次元平行移動幾何学的変換。transltform3d オブジェクトとして返されます。

プロパティ

A — 順方向の 3 次元平行移動変換

4 行 4 列の単位行列 (既定値) | 4 行 4 列の数値行列

順方向の 3 次元平行移動変換。4 行 4 列の数値行列として指定します。A の既定値は単位行列です。

行列 A は、次の規則を使用して、入力座標空間内の点 (u, v, w) を出力座標空間内の点 (x, y, z) に変換します。

$$\left[\begin{array}{c}x\\ y\\ z\\ 1\end{array}\right]={\rm A}\times \left[\begin{array}{c}u\\ v\\ w\\ 1\end{array}\right]$$

平行移動変換の場合、A の形式は次のとおりです。

$${\rm A}=\left[\begin{array}{cccc}1& 0& 0& t_x\\ 0& 1& 0& t_y\\ 0& 0& 1& t_z\\ 0& 0& 0& 1\end{array}\right]$$

ここで、t_x、t_y、t_z はそれぞれ x 方向、y 方向、z 方向の平行移動の量であり、Translation プロパティに対応します。

データ型: double | single

Translation — 平行移動の量

[0 0 0] (既定値) | 3 要素の数値ベクトル

平行移動の量。[t_x t_y t_z] 形式の 3 要素の数値ベクトルとして指定します。

データ型: double | single

Dimensionality — 幾何学的変換の次元

読み取り専用: 3 (既定値)

この プロパティ は読み取り専用です。

入力点と出力点の両方の幾何学的変換の次元。値 3 として返されます。

データ型: double

オブジェクト関数

invert	幾何学的逆変換
outputLimits	与えられた入力空間範囲について出力空間範囲を求める
transformPointsForward	順方向の幾何学的変換の適用
transformPointsInverse	逆方向の幾何学的変換の適用

例

3 次元平行移動変換の作成

平行移動の量を指定します。

t = [10 20.5 15];

指定された平行移動を実行する transltform3d オブジェクトを作成します。

tform = transltform3d(t)

tform = 
  transltform3d with properties:

    Dimensionality: 3
       Translation: [10 20.5000 15]

                 A: [1.0000         0         0   10.0000
                          0    1.0000         0   20.5000
                          0         0    1.0000   15.0000
                          0         0         0    1.0000]

A プロパティの値を調べます。

tform.A

ans = 4×4

    1.0000         0         0   10.0000
         0    1.0000         0   20.5000
         0         0    1.0000   15.0000
         0         0         0    1.0000

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• transltform3d では C コードおよび C++ コードの生成がサポートされています (MATLAB^® Coder™ が必要)。詳細については、イメージ処理のコード生成を参照してください。

• コードを生成するとき、特異オブジェクトだけを指定できます。オブジェクトの配列はサポートされていません。

• 生成されたコードは transltform3d オブジェクトを返すことができません。代わりに、A プロパティの値など、数値配列を返すことができます。

スレッドベースの環境

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

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

バージョン履歴

R2022b で導入

参考

affinetform3d | rigidtform3d | simtform3d | imwarp

トピック

• 2 次元リフティングおよび 3 次元リフティング、ローカル多項式変換、ローラン多項式
• 幾何学的変換の行列表現