ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

imref3d クラス

ワールド座標に対する 3 次元イメージの参照

説明

imref3d オブジェクトは、3 次元イメージの列、行、面に固定されている固有座標と、その同じ列、行、面の位置がワールド座標系に占める空間位置との関係をカプセル化します。イメージは、固有の X 値がワールド X 値と一致し、固有の Y 値がワールド Y 値と一致し、固有の Z 値がワールド Z 値と一致するように、座標系平面のワールド X、ワールド Y およびワールド Z の座標で等間隔にサンプリングされます。各次元のピクセル間隔が違ってもかまいません。

どのピクセルでも、中心点の固有座標値 (x,y,z) は、そのピクセルに対する列、行、面の添字の値と同一です。たとえば、5 行 3 列の 4 番目の面のピクセルの中心点の固有座標は、x = 3.0、y = 5.0、z = 4.0 です。ただし、座標指定 (3.0,5.0,4.0) の順序は、固有座標においてピクセルの添字 (5,3,4) と逆になることに注意してください。固有座標は連続平面上で定義される一方、添字の位置は整数値をもつ離散位置です。

コード生成 サポート: あり。

MATLAB Function ブロック サポート: あり。

構築

R = imref3d() は、既定のプロパティ設定を使用して imref3d オブジェクトを作成します。

R = imref3d(imageSize) は、与えられたイメージ サイズで imref3d オブジェクトを作成します。この構文は、ワールド座標系が固有座標系と相互に位置調整される既定のケースに対し、空間参照オブジェクトを作成します。

R = imref3d(imageSize,pixelExtentInWorldX,pixelExtentInWorldY,pixelExtentInWorldZ) は、所定のイメージサイズと、pixelExtentInWorldXpixelExtentInWorldY および pixelExtentInWorldZ で指定される各次元の解像度を用いて imref3d オブジェクトを作成します。

R = imref3d(imageSize,xWorldLimits,yWorldLimits,zWorldLimits) は、所定のイメージ サイズと、xWorldLimitsyWorldLimits および zWorldLimits で指定される各次元のワールド座標範囲を用いて imref3d オブジェクトを作成します。

入力引数

imageSize

オブジェクトに関連付けられているイメージのサイズ。double クラスの 3 要素行ベクトルとして 、関数 size によって返されるとおりに、[128 128 27] のように指定されます。

PixelExtentInWorldX

ワールド座標系で測定される X 次元の単一ピクセルのサイズであり、double として指定されます。

PixelExtentInWorldY

ワールド座標系で測定される Y 次元の単一ピクセルのサイズであり、double として指定されます。

PixelExtentInWorldZ

ワールド座標系で測定される Z 次元の単一ピクセルのサイズであり、double として指定されます。

xWorldLimits

ワールド座標系の X 次元の最大座標値と最小座標値であり、double クラスの 2 要素数値ベクトルとして [0.5 256.5] のように指定されます。

yWorldLimits

ワールド座標系の Y 次元の最大座標値と最小座標値であり、double クラスの 2 要素の数値ベクトルとして [0.5 256.5] のように指定されます。

zWorldLimits

ワールド座標系の Z 次元の最大座標値と最小座標値であり、double クラスの 2 要素の数値ベクトルとして [0.5 256.5] のように指定されます。

プロパティ

ImageExtentInWorldX

ワールド座標系の X 次元でのイメージの範囲であり、数値スカラーとして指定されます。imref3d オブジェクトは、この値を PixelExtentInX * ImageSize(2) として計算します。

ImageExtentInWorldY

ワールド座標系の Y 次元でのイメージの範囲であり、数値スカラーとして指定されます。imref3d オブジェクトは、この値を PixelExtentInY * ImageSize(1) として計算します。

ImageExtentInWorldZ

ワールド座標系の Z 次元でのイメージの範囲であり、数値スカラーとして指定されます。imref3d オブジェクトは、この値を PixelExtentInZ * ImageSize(3) として計算します。

ImageSize

各空間次元の要素の数であり、関数 size によって返されるものと同じ形式の 3 要素ベクトルとして指定されます。

PixelExtentInWorldX

ワールド座標系で測定される X 次元の単一ピクセルのサイズであり、double として指定されます。

PixelExtentInWorldY

ワールド座標系で測定される Y 次元の単一ピクセルのサイズであり、double として指定されます。

PixelExtentInWorldZ

ワールド座標系で測定される Z 次元の単一ピクセルのサイズであり、double として指定されます。

XWorldLimits

ワールド X 次元におけるイメージの範囲であり、2 要素の行ベクトル [xMin xMax] として指定されます。

YWorldLimits

ワールド Y 次元におけるイメージの範囲であり、2 要素の行ベクトル [yMin yMax] として指定されます。

ZWorldLimits

ワールド Z 次元におけるイメージの範囲であり、2 要素の行ベクトル [zMin zMax] として指定されます。

XIntrinsicLimits

X 次元における固有座標の単位でのイメージの範囲であり、2 要素の行ベクトル [xMin xMax] として指定されます。M x N x P のイメージでは、[0.5, N + 0.5] と等しくなります。

YIntrinsicLimits

Y 次元における固有座標の単位でのイメージの範囲であり、2 要素の行ベクトル [yMin yMax] として指定されます。M x N x P のイメージでは、[0.5, M + 0.5] と等しくなります。

ZIntrinsicLimits

Z 次元における固有座標の単位でのイメージの範囲であり、2 要素の行ベクトル [zMin zMax] として指定されます。M x N x P のイメージでは、[0.5, P + 0.5] と等しくなります。

メソッド

contains イメージにワールド座標系の点が含まれている場合は true
intrinsicToWorld 固有座標からワールド座標への変換
sizesMatchオブジェクトとイメージのサイズが共通の場合は true
worldToIntrinsicワールド座標から固有座標への変換
worldToSubscript ワールド座標から行と列の添字への変換

コピーのセマンティクス

値。値クラスがコピー操作に与える影響については、MATLAB® ドキュメンテーションの「オブジェクトのコピー」 (MATLAB)を参照してください。

すべて展開する

イメージを読み取ります。

m = analyze75info('brainMRI.hdr');
A = analyze75read(m);

ピクセルのサイズを指定して、イメージと関連付けられた imref3d オブジェクトを作成します。ファイルのメタデータの PixelDimensions フィールドにより、各次元の解像度を 1 ピクセルあたりのミリメートル単位で指定します。

RA = imref3d(size(A),m.PixelDimensions(2),m.PixelDimensions(1),m.PixelDimensions(3));
RA = 

  imref3d with properties:

           XWorldLimits: [0.5000 128.5000]
           YWorldLimits: [0.5000 128.5000]
           ZWorldLimits: [0.5000 27.5000]
              ImageSize: [128 128 27]
    PixelExtentInWorldX: 1
    PixelExtentInWorldY: 1
    PixelExtentInWorldZ: 1
    ImageExtentInWorldX: 128
    ImageExtentInWorldY: 128
    ImageExtentInWorldZ: 27
       XIntrinsicLimits: [0.5000 128.5000]
       YIntrinsicLimits: [0.5000 128.5000]
       ZIntrinsicLimits: [0.5000 27.5000]

各次元のイメージの範囲をミリメートル単位で調べます。

RA.ImageExtentInWorldX
RA.ImageExtentInWorldY
RA.ImageExtentInWorldZ
ans =

   128

ans =

   128

ans =

    27

定義

すべて展開する

参考

この情報は役に立ちましたか?