imtranslate

R2026b

イメージの平行移動

構文

B = imtranslate(A,translation)

[B,RB] = imtranslate(A,RA,translation)

___ = imtranslate(___,method)

___ = imtranslate(___,Name=Value)

説明

B = imtranslate(A,translation) は、translation に指定された 2 次元または 3 次元平行移動ベクトルを使用してイメージ A を平行移動します。

A が 2 次元を超える次元をもち、translation が 2 要素ベクトルである場合、imtranslate は、2 次元平行移動を A の平面ごとに適用します。

[B,RB] = imtranslate(A,RA,translation) は、空間参照イメージ A を、関連付けられている空間参照オブジェクト RA と共に平行移動します。平行移動ベクトル translation は、ワールド座標系にあります。この関数は、平行移動された空間参照イメージ B を、関連付けられている空間参照オブジェクト RB と共に返します。

___ = imtranslate(___,method) は、method で指定された内挿法を使用して、イメージ A を平行移動します。

___ = imtranslate(___,Name=Value) は、平行移動のさまざまな特性を制御する名前と値の引数を使用して、入力イメージを平行移動します。

例

2 次元イメージの平行移動

イメージをワークスペースに読み取ります。

I = imread("pout.tif");

イメージを平行移動します。

J = imtranslate(I,[25.3, -10.1],FillValues=255);

元のイメージと平行移動したイメージを表示します。

figure
imshow(I)
title("Original Image")
set(gca,Visible="on")

figure
imshow(J)
title("Translated Image")
set(gca,Visible="on")

2 次元イメージの平行移動と平行移動したイメージ全体の表示

イメージをワークスペースに読み取ります。

I = imread("pout.tif");

イメージを平行移動します。OutputView パラメーターを使用して、平行移動したイメージ全体が表示されるように指定します。

J = imtranslate(I,[25.3, -10.1],FillValues=255,OutputView="full");

元のイメージと平行移動したイメージを表示します。

figure
imshow(I)
title("Original Image")
set(gca,Visible="on")

figure
imshow(J)
title("Full Translated Image")
set(gca,Visible="on")

3 次元 MRI データセットの平行移動

MRI データをワークスペースに読み込んで表示します。

s = load("mri");
mriVolume = squeeze(s.D);
sizeIn = size(mriVolume);
hFigOriginal = figure;
hAxOriginal  = axes;
slice(double(mriVolume),sizeIn(2)/2,sizeIn(1)/2,sizeIn(3)/2);
grid on, shading interp, colormap gray

X、Y 方向の平行移動を適用します。

mriVolumeTranslated = imtranslate(mriVolume,[40,30,0],OutputView="full");

ボリュームの中心を通る軸スライス平面を表示することによって平行移動を可視化します。X 方向と Y 方向に移動しています。

sliceIndex = round(sizeIn(3)/2);
axialSliceOriginal   = mriVolume(:,:,sliceIndex);
axialSliceTranslated = mriVolumeTranslated(:,:,sliceIndex);

imshow(axialSliceOriginal)

imshow(axialSliceTranslated)

入力引数

A — 平行移動するイメージ

数値配列 | logical 配列 | categorical 配列

平行移動するイメージ。数値配列、logical 配列、または categorical 配列として指定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | logical | categorical

RA — 入力イメージ A に関連付けられている空間参照情報

imref2d または imref3d 空間参照オブジェクト

入力イメージ A に関連付けられている空間参照情報。空間参照オブジェクト imref2d または imref3d として指定します。

translation — 平行移動ベクトル

2 要素の数値ベクトル | 3 要素の数値ベクトル

平行移動ベクトル。2 要素の数値ベクトル [Tx Ty] または 3 要素の数値ベクトル [Tx Ty Tz] として指定します。小数値も指定できます。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

method — 内挿法

"linear" (既定値) | "nearest" | "cubic"

内挿法。次のいずれかの値に指定します。

値	説明
"nearest"	最近傍内挿。出力ピクセルには、対象の点が含まれるピクセルの値が代入されます。周りの他のピクセルは、考慮に入れません。 最近傍内挿は、categorical イメージでサポートされている唯一のメソッドであり、このタイプのイメージに対する既定のメソッドです。
"bilinear"	線形内挿。 線形内挿は、数値イメージと論理イメージに対する既定のメソッドです。
"bicubic"	3 次内挿。 メモ 3 次内挿は、元の範囲外のピクセル値を生成します。

データ型: char | string

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: mriVolumeTranslated = imtranslate(mriVolume,[40,30,0],OutputView="full") は、出力ワールド座標範囲を "full" として指定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: mriVolumeTranslated = imtranslate(mriVolume,[40,30,0],"OutputView","full");

OutputView — 出力ワールド座標範囲

"same" (既定値) | "full"

出力ワールド座標範囲。次のいずれかの値を指定します。

値	説明
"same"	出力ワールド座標範囲は入力イメージと同じです。
"full"	出力ワールド座標範囲は、入力イメージと平行移動された出力イメージの両方を含む四角形の境界です。

データ型: char | string

FillValues — 塗りつぶしの値

数値スカラー | 数値配列 | string スカラー | 文字ベクトル | missing

入力イメージの外側にある出力ピクセルに使用する塗りつぶしの値。次の表のいずれかの値として指定します。imtranslate は、入力イメージにおける対応する逆変換後の位置が完全に入力イメージの境界外である場合に、塗りつぶしの値を出力ピクセルに使用します。

数値イメージと論理イメージの既定の塗りつぶしの値は 0 です。categorical イメージの既定の塗りつぶしの値は missing です。<undefined> カテゴリに対応します。

イメージ タイプ	平行移動の次元	塗りつぶしの値の形式
2 次元グレースケール イメージまたは論理イメージ	2 次元	数値スカラー
2 次元カラー イメージまたは 2 次元マルチスペクトル イメージ	2 次元	数値スカラー c 要素の数値ベクトル。c チャネルのそれぞれに塗りつぶしの値を指定します。カラー イメージの場合、チャネル数 c は 3 です。
一連の p 2 次元イメージ	2 次元	数値スカラー c 行 p 列の数値行列。チャネル数 c は、グレースケール イメージの場合は 1 になり、カラー イメージの場合は 3 になります。
N 次元イメージ	2 次元	数値スカラー 入力イメージ A の 3 ～ N 次元に一致するサイズの数値配列。たとえば、A が 200 x 200 x 10 x 3 である場合、FillValues は 10 行 3 列の配列となります。
3 次元グレースケール イメージまたは論理イメージ	3 次元	数値スカラー
categorical イメージ	2 次元または 3 次元	イメージ内の有効なカテゴリ。string スカラーまたは文字ベクトルとして指定します。 missing。<undefined> カテゴリに対応します。詳細については、missing を参照してください。

例: 255 にすると、uint8 イメージを白のピクセルで塗りつぶします

例: 1 にすると、double イメージを白のピクセルで塗りつぶします

例: [0 1 0] にすると、double カラー イメージを緑のピクセルで塗りつぶします

例: [0 1 0; 0 1 1]' にすると、2 つの double カラー イメージから成るセットの場合、1 番目のイメージを緑のピクセルで、2 番目のイメージをシアンのピクセルで塗りつぶします

例: "vehicle" にすると、categorical イメージを "vehicle" カテゴリで塗りつぶします

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | string | char

出力引数

B — 平行移動したイメージ

数値配列 | logical 配列 | categorical 配列

平行移動したイメージ。入力イメージ A と同じデータ型の数値配列、logical 配列、または categorical 配列として返されます。

RB — 出力イメージに関連付けられている空間参照情報

imref2d オブジェクト | imref3d オブジェクト

出力イメージに関連付けられている空間参照情報。空間参照オブジェクト imref2d または imref3d として返されます。

ヒント

• imtranslate は、整数値の translation ベクトル用に最適化されています。

• OutputView が "full" で、translation が非整数ピクセルである場合、imtranslate は出力空間参照オブジェクトのワールド座標範囲を最も近い整数ピクセルまで拡大します。これによって imtranslate は入力イメージと同じ解像度で元のイメージと平行移動したイメージの両方が含まれるようにします。それぞれのイメージ拡大部分は、イメージの片側に、平行移動ベクトルの指す方向で追加されます。たとえば、translation が X と Y の両方で正の非整数である場合、imtranslate は、入力イメージの解像度で "full" の四角形境界が含まれるように、XWorldLimits と YWorldLimits の最大値を拡大します。

拡張機能

C/C++ コード生成

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

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

• imtranslate では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、imtranslate によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細については、Image Processing Toolbox でサポートされているコード生成のタイプを参照してください。

• データ型 categorical の入力イメージはサポートされていません。

• この関数では 2 次元平行移動ベクトル translation のみがサポートされます。3 次元の平行移動はサポートされません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限については、「C/C++ コード生成」セクションを参照してください。GPU コード生成にも同様の、使用上の注意および制限が適用されます。

スレッドベースの環境

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

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

バージョン履歴

R2014a で導入

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

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

参考

imref2d | imref3d | imresize | imrotate | imwarp

トピック

• 垂直方向と水平方向のイメージの平行移動