このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

affinetform2d

2 次元アフィン幾何学的変換

R2022b 以降

説明

affinetform2d オブジェクトは、2 次元アフィン幾何学的変換に関する情報を格納し、フォワード変換と逆変換を可能にします。

作成

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

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

• imregcorr — 位相相関を使用して移動イメージを固定イメージにマッピングする幾何学的変換を推定します。

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

• randomAffine2d — ランダムな 2 次元アフィン変換を作成します。

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

構文

tform = affinetform2d

tform = affinetform2d(A)

tform = affinetform2d(tformIn)

説明

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

tform = affinetform2d(A) は affinetform2d オブジェクトを作成し、指定された 2 次元アフィン変換行列をプロパティ A に設定します。

tform = affinetform2d(tformIn) は、有効な 2 次元アフィン幾何学的変換を表す、別の幾何学的変換オブジェクト tformIn から affinetform2d オブジェクトを作成します。

入力引数

tformIn — 2 次元アフィン幾何学的変換

affinetform2d オブジェクト | rigidtform2d オブジェクト | simtform2d オブジェクト | transltform2d オブジェクト | projtform2d オブジェクト

2 次元アフィン幾何学的変換。affinetform2d オブジェクト、rigidtform2d オブジェクト、simtform2d オブジェクト、transltform2d オブジェクト、または projtform2d オブジェクトとして指定します。

プロパティ

A — 2 次元フォワード アフィン変換

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

2 次元フォワード アフィン変換。3 行 3 列の数値行列として指定します。このオブジェクトを作成する場合は、2 行 3 列の数値行列として A を指定することもできます。この場合、オブジェクトは行ベクトル [0 0 1] を行列の最後まで連結し、3 行 3 列の行列を作成します。A の既定値は単位行列です。

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

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

アフィン変換の場合、A の形式は次のとおりです。

$${\rm A}=\left[\begin{array}{ccc}a& b& c\\ d& e& f\\ 0& 0& 1\end{array}\right]$$

データ型: double | single

Dimensionality — 幾何学的変換の次元

2 (既定値)

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

入力点と出力点の両方の幾何学的変換の次元。値 2 として指定します。

オブジェクト関数

invert	Invert geometric transformation
outputLimits	Find output spatial limits given input spatial limits
transformPointsForward	Apply forward geometric transformation
transformPointsInverse	Apply inverse geometric transformation

例

2 次元アフィン変換の作成

3 行 3 列の幾何学的変換行列を定義します。この例では、垂直方向のせん断と水平方向の広がりから構成されるアフィン変換の行列を指定します。

A = [2 0 0; 0.33 1 0; 0 0 1];

変換行列から affinetform2d オブジェクトを作成します。

tform = affinetform2d(A)

tform = 
  affinetform2d with properties:

    Dimensionality: 2
                 A: [3x3 double]

イメージを読み取って表示します。

I = imread("pout.tif");
imshow(I)

幾何学的変換をイメージに適用し、結果を表示します。

J = imwarp(I,tform);
imshow(J)

拡張機能

C/C++ コード生成

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

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

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

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

スレッドベースの環境

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

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

バージョン履歴

R2022b で導入

R2022b: affine2d よりも推奨

R2022b 以降、ほとんどの Image Processing Toolbox™ 関数は、左から乗算する規則を使用して幾何学的変換を作成し、実行します。affinetform2d オブジェクトは、左から乗算する規則と一致する形式で 2 次元アフィン幾何学的変換に関する情報を格納します。

affine2d オブジェクトは右から乗算する規則を使用していることから推奨されません。現時点では、affine2d オブジェクトを削除する予定はありませんが、affinetform2d オブジェクトに切り替えることで、幾何学的変換のワークフローを効率化できます。詳細については、Migrate Geometric Transformations to Premultiply Conventionを参照してください。

参考

fitgeotform2d | rigidtform2d | simtform2d | transltform2d | projtform2d | imwarp

トピック

• 2 次元および 3 次元の幾何学的変換プロセスの概要
• 幾何学的変換の行列表現