volshow

ボリュームの表示

このページをすべて展開する

説明

volshow オブジェクトは、ボリュームを表示し、表示の外観を変更できるようにします。

作成

構文

volshow(V)

volshow(V,config)

volshow(V,Name,Value)

vs = volshow(___)

説明

例

volshow(V) は、Figure に 3 次元グレースケールボリューム V を表示します。マウスを使用して、表示を対話形式で回転および拡大縮小することもできます。

volshow(V,config) は 3 次元グレースケールボリューム V を表示します。config はボリュームビューアー アプリからエクスポートされた構造体です。config は、ボリュームの可視化を制御する構造体であり、volshow オブジェクトプロパティの値を含んでいます。

volshow(V,Name,Value) は、ボリュームの可視化を制御するプロパティを設定する 1 つ以上の名前と値のペアを使用して、ボリュームを表示します。名前と値のペアのリストについては、プロパティを参照してください。各プロパティ名を引用符で囲みます。

例: volshow(V,'BackgroundColor','w') は、Figure に 3 次元グレースケールボリューム V を白い背景色で表示します。

vs = volshow(___) は、ボリュームの可視化を制御するために使用できるプロパティを持つ volshow オブジェクトを返します。

入力引数

すべて展開する

`V` — 3 次元グレースケールボリューム
数値配列

3 次元グレースケールボリューム。数値配列として指定します。

`config` — ボリュームビューアーによってエクスポートされたレンダリング情報
`struct`

ボリュームビューアーによってエクスポートされたレンダリング情報。struct として指定します。

プロパティ

すべて展開する

`Alphamap` — ボリュームコンテンツの透明度マップ
256 行 1 列の数値ベクトル

ボリュームコンテンツの透明度マップ。[0 1] の範囲の値をもつ 256 行 1 列の数値配列として指定します。既定の透明度マップは、ベクトル linspace(0,1,256)' です。

`BackgroundColor` — 背景色
`[0.3 0.75 0.93]` (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

背景色。RGB 3 成分、色の名前、または色の省略名として指定します。

RGB 3 成分を使用すると、任意の色を指定できます。RGB 3 成分は、色の赤、緑、青の成分の強度を指定する 3 つの要素から成る行ベクトルです。強度は [0,1] の範囲でなければなりません。

いくつかの一般的な色については、色の名前を string スカラーまたは文字ベクトルとして指定できます。次の表に、名前付きの色のオプション、およびそれと等価な RGB 3 成分を示します。

色の名前	省略名	RGB 3 成分
`'red'`	`'r'`	`[1 0 0]`
`'green'`	`'g'`	`[0 1 0]`
`'blue'`	`'b'`	`[0 0 1]`
`'cyan'`	`'c'`	`[0 1 1]`
`'magenta'`	`'m'`	`[1 0 1]`
`'yellow'`	`'y'`	`[1 1 0]`
`'black'`	`'k'`	`[0 0 0]`
`'white'`	`'w'`	`[1 1 1]`

以下に、MATLAB^® がさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分	外観
`[0 0.4470 0.7410]`
`[0.8500 0.3250 0.0980]`
`[0.9290 0.6940 0.1250]`
`[0.4940 0.1840 0.5560]`
`[0.4660 0.6740 0.1880]`
`[0.3010 0.7450 0.9330]`
`[0.6350 0.0780 0.1840]`

例: 'BackgroundColor','r'

例: 'BackgroundColor','green'

例: 'BackgroundColor',[0 0.4470 0.7410]

`CameraPosition` — カメラの位置
`[4 4 2.5]` (既定値) | 3 要素ベクトル

カメラの位置または視点。[x y z] 形式の 3 要素ベクトルとして指定します。このベクトルは、カメラの位置の座標軸座標を定義します。その点を視点として座標軸が表示されます。カメラは視点軸に沿った向きになります。視点軸はカメラの位置とカメラのターゲットを結ぶ直線です。CameraPosition プロパティを変更すると、ボリュームを表示する点が変化します。詳細については、カメラグラフィックス用語を参照してください。ボリュームを対話形式で回転させると、このプロパティの値が変化します。

`CameraTarget` — カメラのターゲットとして使用する点
`[0 0 0]` (既定値) | 3 要素ベクトル

カメラのターゲットとして使用する点。[x y z] 形式の 3 要素ベクトルとして指定します。カメラは視点軸に沿った向きになります。視点軸はカメラの位置とカメラのターゲットを結ぶ直線です。詳細については、カメラグラフィックス用語を参照してください。

`CameraUpVector` — 上方向を定義するベクトル
`[0 0 1]` (既定値) | 3 要素ベクトル

上方向を定義するベクトル。[x y z] 形式の 3 要素方向ベクトルとして指定します。既定では、volshow は z 軸を上方向 ([0 0 1]) として定義します。詳細については、カメラグラフィックス用語を参照してください。ボリュームを対話形式で回転させると、このプロパティの値が変化します。

`CameraViewAngle` — 視野
`15` (既定値) | 数値スカラー

視野。範囲 [0, 180) のスカラー角度として指定します。角度が大きいほど、視野が広くなります。また、角度が大きいほど、シーン内でオブジェクトが小さく表示されます。詳細については、カメラグラフィックス用語を参照してください。

`Colormap` — ボリュームコンテンツのカラーマップ
`gray(256)` (既定値) | 256 行 3 列の数値配列

ボリュームコンテンツのカラーマップ。[0, 1] の範囲の値をもつ 256 行 3 列の数値配列として指定します。

`InteractionsEnabled` — ボリュームの対話性
`true` (既定値) | `false`

ボリュームの対話性。true または false として指定します。true の場合、マウスのスクロールホイールを使用してズームしたり、ボリュームをクリックアンドドラッグして回転させたりできます。回転およびズームは CameraTarget プロパティで指定される値に関して実行されます。false の場合、ボリュームに対する対話型の操作はできません。

`IsosurfaceColor` — 等値面の色
RGB 3 成分 | 色の名前 | 色の省略名

等値面の色。RGB 3 成分、色の名前、または色の省略名として指定します。Renderer プロパティが 'Isosurface' に設定されている場合、このプロパティはボリュームの色を指定します。

色の名前	省略名	RGB 3 成分
`'red'`	`'r'`	`[1 0 0]`
`'green'`	`'g'`	`[0 1 0]`
`'blue'`	`'b'`	`[0 0 1]`
`'cyan'`	`'c'`	`[0 1 1]`
`'magenta'`	`'m'`	`[1 0 1]`
`'yellow'`	`'y'`	`[1 1 0]`
`'black'`	`'k'`	`[0 0 0]`
`'white'`	`'w'`	`[1 1 1]`

以下に、MATLAB がさまざまなタイプのプロットで使用する既定の色の RGB 3 成分を示します。

RGB 3 成分	外観
`[0 0.4470 0.7410]`
`[0.8500 0.3250 0.0980]`
`[0.9290 0.6940 0.1250]`
`[0.4940 0.1840 0.5560]`
`[0.4660 0.6740 0.1880]`
`[0.3010 0.7450 0.9330]`
`[0.6350 0.0780 0.1840]`

例: 'IsosurfaceColor','r'

例: 'IsosurfaceColor','green'

例: 'IsosurfaceColor',[0 0.4470 0.7410]

`Isovalue` — ボリュームの面を定義する値
`0.49` (既定値) | 非負の数値

Renderer プロパティが 'Isosurface' に設定されている場合に描画されるボリュームの面を定義する値。範囲 [0, 1] の非負の数値として指定します。

`Lighting` — レンダリングに光源を含める
`true` (既定値) | `false`

レンダリングに光源を含める。logical スカラーとして指定します。

`Parent` — `volshow` オブジェクトの親
`gcf` (既定値) | uipanel | Figure

volshow オブジェクトの親。uipanel または figure のハンドルとして指定します。親を指定しない場合、volshow オブジェクトの親は gcf です。

`Renderer` — レンダリングスタイル
`'VolumeRendering'` | `'MaximumIntensityProjection'` | `'Isosurface'`

レンダリングスタイル。次の表のいずれかの値を指定します。ボリュームが logical の場合、既定のレンダリングスタイルは 'Isosurface'、それ以外の場合、既定のレンダリングスタイルは 'VolumeRendering' です。

値	説明
`'VolumeRendering'`	各ボクセルに指定された色と透明度に基づいてボリュームを表示します。
`'MaximumIntensityProjection'`	透過した各 X 線の強度値がデータ全体で最も高いボクセルを表示します。
`'Isosurface'`	`Isovalue` の値で指定されるボリュームの等値面を表示します。

`ScaleFactors` — ボリュームを再スケーリングするために使用する倍率
`[1 1 1]` (既定値) | 正の数値から成る 1 行 3 列の配列

ボリュームを再スケーリングするために使用する倍率。正の数値から成る 1 行 3 列の配列として指定します。配列内の値は、x、y、および z 方向に適用される倍率に対応します。

オブジェクト関数

setVolume 新しいボリュームの設定

例

すべて折りたたむ

スパイラルボリュームのアニメーション GIF の作成

スクリプトを開く

ボリュームを読み込んで表示します。

load('spiralVol.mat');
h = volshow(spiralVol);

GIF ファイルの名前を指定します。

filename = 'animatedSpiral.gif';

単位円周上にカメラ位置の配列を作成します。

vec = linspace(0,2*pi(),120)';
myPosition = [cos(vec) sin(vec) ones(size(vec))];

ループ処理を使用して、各カメラ位置でイメージを作成します。

for idx = 1:120
    % Update current view.
    h.CameraPosition = myPosition(idx,:);
    % Use getframe to capture image.
    I = getframe(gcf);
    [indI,cm] = rgb2ind(I.cdata,256);
    % Write frame to the GIF File.
    if idx == 1
        imwrite(indI, cm, filename, 'gif', 'Loopcount', inf, 'DelayTime', 0.05);
    else
        imwrite(indI, cm, filename, 'gif', 'WriteMode', 'append', 'DelayTime', 0.05);
    end
end

MRI データのボリュームの可視化

ライブスクリプトを開く

MRI データを読み込み、大きさが 1 の次元を削除します。

load mri
V = squeeze(D);

MRI イメージに適したカラーマップと透明度 (アルファ) マップを生成します。

intensity = [0 20 40 120 220 1024];
alpha = [0 0 0.15 0.3 0.38 0.5];
color = ([0 0 0; 43 0 0; 103 37 20; 199 155 97; 216 213 201; 255 255 255]) ./ 255;
queryPoints = linspace(min(intensity),max(intensity),256);
alphamap = interp1(intensity,alpha,queryPoints)';
colormap = interp1(intensity,color,queryPoints);

カスタムのカラーマップと透明度マップを使用してボリュームを表示します。マウスをクリックアンドドラッグして、ボリュームを回転させます。スクロールホイールを使用して、ボリュームを拡大および縮小します。

vol = volshow(V,'Colormap',colormap,'Alphamap',alphamap);

CT ボリュームデータの可視化

スクリプトを開く

データを読み込みます。

load mri
V = squeeze(D);

CT イメージの可視化に適したカラーマップと alphamap を生成します。

intensity = [-3024,-16.45,641.38,3071];
alpha = [0, 0, 0.72, 0.72];
color = ([0 0 0; 186 65 77; 231 208 141; 255 255 255]) ./ 255;
queryPoints = linspace(min(intensity),max(intensity),256);
alphamap = interp1(intensity,alpha,queryPoints)';
colormap = interp1(intensity,color,queryPoints);

カスタムのカラーマップと alphamap を使用したボリュームの表示

volshow(V,'Colormap',colormap,'Alphamap',alphamap);

ヒント

関数 volshow は、指定された親 Figure に uipanel オブジェクトを作成します。パネルは、UI コンポーネントをまとめてグループ化するコンテナーです。volshow は uipanel にボリュームデータを表示します。一方、imshow は Axes にイメージを表示します。volshow がボリュームを表示した Figure に、imshow を呼び出してイメージを表示する場合、imshow は volshow によって表示されたボリュームを上書きしません。imshow によって作成される Axes は uipanel の背後に表示されます。

バージョン履歴

R2018b で導入

参考

ボリュームビューアー | labelvolshow | isosurface | slice | obliqueslice

volshow

説明

作成

構文

説明

入力引数

V — 3 次元グレースケール ボリューム 数値配列

config — ボリューム ビューアーによってエクスポートされたレンダリング情報 struct

プロパティ

Alphamap — ボリューム コンテンツの透明度マップ 256 行 1 列の数値ベクトル

BackgroundColor — 背景色 [0.3 0.75 0.93] (既定値) | RGB 3 成分 | 色の名前 | 色の省略名

CameraPosition — カメラの位置 [4 4 2.5] (既定値) | 3 要素ベクトル

CameraTarget — カメラのターゲットとして使用する点 [0 0 0] (既定値) | 3 要素ベクトル

CameraUpVector — 上方向を定義するベクトル [0 0 1] (既定値) | 3 要素ベクトル

CameraViewAngle — 視野 15 (既定値) | 数値スカラー

Colormap — ボリューム コンテンツのカラーマップ gray(256) (既定値) | 256 行 3 列の数値配列

InteractionsEnabled — ボリュームの対話性 true (既定値) | false

IsosurfaceColor — 等値面の色 RGB 3 成分 | 色の名前 | 色の省略名

Isovalue — ボリュームの面を定義する値 0.49 (既定値) | 非負の数値

Lighting — レンダリングに光源を含める true (既定値) | false

Parent — volshow オブジェクトの親 gcf (既定値) | uipanel | Figure

Renderer — レンダリング スタイル 'VolumeRendering' | 'MaximumIntensityProjection' | 'Isosurface'

ScaleFactors — ボリュームを再スケーリングするために使用する倍率 [1 1 1] (既定値) | 正の数値から成る 1 行 3 列の配列