ドキュメンテーション

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

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) と逆になることに注意してください。固有座標は連続平面上で定義される一方、添字の位置は整数値をもつ離散位置です。

構築

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 オブジェクトを作成します。

入力引数

すべて展開する

オブジェクトに関連付けられているイメージのサイズ。3 要素の正の行ベクトルとして指定します。関数 size で返されるベクトルを使用できます。

例: imageSize = [128 128 27];

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

ワールド座標系で測定される x 次元の単一ピクセルのサイズ。正のスカラーとして指定します。

データ型: double | single

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

データ型: double | single

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

データ型: double | single

ワールド座標系の x 次元の最大座標値と最小座標値。2 要素の数値の行ベクトルとして指定します。

例: xWorldLimits = [0.5 256.5];

データ型: double | single

ワールド座標系の y 次元の最大座標値と最小座標値であり、2 要素の数値の行ベクトルとして指定されます。

例: yWorldLimits = [0.5 256.5];

データ型: double | single

ワールド座標系の z 次元の最大座標値と最小座標値であり、2 要素の数値の行ベクトルとして指定されます。

例: zWorldLimits = [0.5 27.5];

データ型: double | single

プロパティ

すべて展開する

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

ワールド座標系で測定される x 次元の単一ピクセルのサイズ。正のスカラーとして指定します。

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

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

データ型: double

メソッド

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

拡張機能

参考

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