このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

labelvolshow

ラベル付きボリュームの表示

説明

ラベル付きボリューム データを表示し、表示の外観を制御するプロパティを持つ labelvolshow オブジェクトを作成します。強度ボリュームをラベル付きボリュームに組み込み、両方のボリュームを同時に表示できます。

作成

構文

labelvolshow(L)

labelvolshow(L,V)

labelvolshow(___,Name,Value)

h = labelvolshow(___)

説明

labelvolshow(L) は、Figure に 3 次元ラベル付きボリューム L を表示します。

labelvolshow(L,V) は、3 次元ラベル付きボリューム L と 3 次元強度ボリューム V を Figure に表示します。L と V は同じサイズでなければなりません。

labelvolshow(___,Name,Value) は、ボリュームの可視化を制御する プロパティ を設定する 1 つ以上の名前と値のペアを使用します。各プロパティ名を引用符で囲みます。

たとえば、labelvolshow(L,V,'BackgroundColor','w','VolumeThreshold',0.2) は、Figure に 3 次元ラベル付きボリューム L およびグレースケール ボリューム V を白い背景色で表示します。値が 0.2 より小さい V のピクセルはすべて、完全に透明になります。

h = labelvolshow(___) は、ボリュームの可視化を制御するために使用できるプロパティを持つ labelvolshow オブジェクト h を返します。前のいずれかの構文の入力引数を使用します。

入力引数

L — ラベル付きボリューム

3 次元数値配列

ラベル付きボリューム。3 次元数値配列として指定します。

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

V — 強度ボリューム

3 次元数値配列

強度ボリューム。ラベル付きボリューム L と同じサイズの 3 次元数値配列として指定します。

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

プロパティ

BackgroundColor — 背景色

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

背景色。MATLAB^® ColorSpec として指定します。強度は [0, 1] の範囲でなければなりません。

CameraPosition — カメラの位置

[4 4 2.5] (既定値) | 3 要素ベクトル

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

CameraUpVector — 上方向を定義するベクトル

[0 0 1] (既定値) | 3 要素ベクトル

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

CameraTarget — カメラのターゲットとして使用する点

[0 0 0] (既定値) | 3 要素ベクトル

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

CameraViewAngle — 視野

15 (既定値) | 数値スカラー

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

InteractionsEnabled — ボリュームの対話性

true (既定値) | false

ボリュームの対話性。true (1) または false (0) を指定します。true (既定の設定) の場合、マウスのスクロール ホイールを使用してラベル付きボリュームを拡大および縮小したり、ボリュームをクリック アンド ドラッグして回転させたりできます。回転およびズームは CameraTarget で指定される値に関して実行されます。この値が false の場合、ボリュームに対する対話型の操作はできません。

LabelColor — ラベルの色

ランダムなカラーマップ (既定値) | numLabels 行 3 列の数値配列

ラベルの色。範囲 [0, 1] の値を持つ numLabels 行 3 列の数値配列として指定します。numLabels はラベル付きボリューム内のラベルの数を表します。

LabelOpacity — ラベルの不透明度

ラベル 0 以外のすべてのラベルについて true (既定値) | numLabels 行 1 列の数値ベクトル

ラベルの不透明度。範囲 [0, 1] の値を持つ numLabels 行 1 列の数値ベクトルとして指定します。numLabels はラベル付きボリューム内のラベルの数を表します。複数のボリュームが一緒に組み込まれている場合、LabelOpacity はサポートされません。

LabelsPresent — ラベル値

numLabels 行 1 列の数値ベクトル

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

ラベル値。numLabels 行 1 列の数値ベクトルとして指定します。numLabels はラベル付きボリューム内のラベルの数を表します。

LabelVisibility — ラベルの可視性

ラベル 0 以外のすべてのラベルについて true (既定値) | numLabels 行 1 列の logical ベクトル

ラベルの可視性。numLabels 行 1 列の logical ベクトルとして指定します。numLabels はラベル付きボリューム内のラベルの数を表します。

Parent — labelvolshow オブジェクトの親

gcf (既定値) | uipanel | Figure

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

ScaleFactors — ボリュームを再スケーリングするために使用する倍率

[1 1 1] (既定値) | 1 行 3 列の正の数値のベクトル

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

ShowIntensityVolume — 強度ボリュームの表示

true | false

強度ボリュームの表示。true (1) または false (0) として指定します。値が true の場合、関数はラベル付きボリュームと強度ボリュームの両方を表示します。値が false の場合、関数はラベル付きボリュームのみを表示します。labelvolshow オブジェクトがラベル付きボリュームと強度ボリュームの両方を含んでいる場合、既定の設定は true です。このオブジェクトがラベル付きボリュームのみを含んでいる場合、既定の設定は false です。

VolumeOpacity — ボリュームの不透明度

0.5 (既定値) | 範囲 [0, 1] の数値

ボリュームの不透明度。範囲 [0, 1] の数値として指定します。ラベル付きボリュームと強度ボリュームの両方が一緒に組み込まれている場合、この値はボリューム データの不透明度を定義します。VolumeThreshold の値を上回るすべての組み込みボリューム強度に対して、不透明度は VolumeOpacity です。

VolumeThreshold — ボリューム強度のしきい値

0.4 (既定値) | 範囲 [0, 1] の数値

ボリューム強度のしきい値。範囲 [0, 1] の正規化された数値として指定します。このしきい値を下回るすべてのボリューム強度に対して、不透明度は 0 です。

オブジェクト関数

setVolume

新しい labelvolshow オブジェクトの設定

例

ラベル付きボリュームの強度ボリュームを伴う表示と伴わない表示

脳 MRI のグレースケール イメージを読み取ります。イメージはワークスペース変数 vol に保存されます。

load(fullfile(toolboxdir('images'),'imdata','BrainMRILabeled', ...
    'images','vol_001.mat'));

対応するラベル付きイメージをワークスペース変数 label に読み取ります。

load(fullfile(toolboxdir('images'),'imdata','BrainMRILabeled', ...
    'labels','label_001.mat'));

表示パネルをカスタマイズします。

ViewPnl = uipanel(figure,'Title','Labeled Volume');

ラベル付きボリュームと強度ボリュームを表示します。

h = labelvolshow(label,vol,'Parent',ViewPnl);

強度ボリュームを非表示にします。ラベルのみが表示されます。

h.ShowIntensityVolume = false;

ラベル付きボリュームの表示と色および不透明度の変更

脳 MRI のグレースケール ボリュームを読み取ります。イメージはワークスペース変数 vol に保存されます。

load(fullfile(toolboxdir('images'),'imdata','BrainMRILabeled', ...
    'images','vol_001.mat'));

対応するラベル付きボリュームをワークスペース変数 label に読み取ります。ボリュームには、背景ラベル 0 以外に 3 つのラベルがあります。

load(fullfile(toolboxdir('images'),'imdata','BrainMRILabeled', ...
    'labels','label_001.mat'));

表示パネルをカスタマイズします。

ViewPnl = uipanel(figure,'Title','Labeled Volume');

ラベル付きボリュームを表示します。

h = labelvolshow(label,vol,'Parent',ViewPnl);

背景ではない 1 番目のラベル (2 番目のラベル) を完全に透明にします。背景ではない 2 番目のラベルの色を赤に変更し、背景ではない 3 番目のラベルの色を黄色に変更します。

h.LabelOpacity(2) = 0;
h.LabelColor(3,:) = [1 0 0];
h.LabelColor(4,:) = [1 1 0];

参考

volshow | ボリューム ビューアー | slice | modefilt

R2019a で導入

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい