Main Content

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

bigimageshow

bigimage オブジェクトの表示

説明

bigimageshow オブジェクトは bigimage オブジェクトのデータを表示します。bigimageshow オブジェクトは、イメージの範囲と画面解像度に基づいてイメージ データを連続的に読み込みます。

作成

説明

bigimageshow(bigimg) は、既定の表示プロパティを使用して大きなイメージ bigimg を表示します。

bigimageshow(hax,bigimg) は、座標軸 hax に大きなイメージ bigimg を表示します。

bigimageshow(___,Name,Value) は、名前と値のペアを使用して初期表示プロパティを設定します。複数の名前と値のペアを指定できます。各引数またはプロパティ名は引用符で囲みます。

たとえば、bigimageshow(bigimg,'GridVisible','on','GridLineStyle',':') は大きなイメージを表示し、点線のグリッド ラインを重ね合わせます。

b = bigimageshow(___)bigimageshow オブジェクト b を返します。大きなイメージが表示された後、b を使用して表示設定を変更します。

入力引数

すべて展開する

大きなイメージ。bigimage オブジェクトとして指定します。

bigimageshow オブジェクトの親の座標軸。axes オブジェクトとして指定します。

プロパティ

すべて展開する

bigimageshow オブジェクトの親の座標軸。axes オブジェクトとして指定します。親を指定しない場合、bigimageshow は現在の Figure のハンドル gca を使用します。Figure が存在しない場合、bigimageshow は新しい Figure を作成します。

表示する大きなイメージ データ。bigimage オブジェクトとして指定します。

カラー データのマッピング方法。'direct' または 'scaled' として指定します。このプロパティを使用して、カラーマップへの CData 内のカラー データ値のマッピングを制御します。CData は、インデックス付きの色を定義するベクトルまたは行列でなければなりません。CData が RGB カラーを定義する 3 次元配列である場合、このプロパティには効果がありません。

これらの方法には以下の効果があります。

  • 'direct' — 値を現在のカラーマップのインデックスとして解釈します。小数点以下の部分がある値は、その値より小さく、その値に最も近い整数に調整されます。

    • 値が double 型または single 型の場合、1 以下の値はカラーマップの最初の色にマッピングされます。カラーマップの長さ以上の値は、カラーマップの最後の色にマッピングされます。

    • 値の型が uint8uint16uint32uint64int8int16int32、または int64 の場合、0 以下の値はカラーマップの最初の色にマッピングされます。カラーマップの長さ以上の値は、カラーマップの最後の色に (または、その型の範囲限界値まで) マッピングされます。

    • 値が logical 型の場合、値 0 はカラーマップの最初の色にマッピングされ、値 1 はカラーマップの 2 番目の色にマッピングされます。

  • 'scaled' — 色の範囲の最小値と最大値の間の範囲になるように値をスケーリングします。座標軸の CLim プロパティには色の範囲が含まれています。

透明度データ。次のいずれかの形式で指定します。

  • 数値スカラー — イメージ全体で一貫した透明度を使用します。

  • CData と同じサイズの数値配列 — イメージ要素ごとに異なる透明度値を使用します。

AlphaDataMapping プロパティは、MATLAB® がアルファ データの透明度値をどのように解釈するかを制御します。

例: 0.5

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

AlphaData 値の解釈。次のいずれかの値を指定します。

  • 'none' — 値を透明度値として解釈します。1 以上の値は完全に不透明、0 以下の値は完全に透明、0 ~ 1 の間の値は半透明です。

  • 'scaled' — 値を Figure の alphamap にマッピングします。座標軸のアルファ範囲の最小値と最大値によって、alphamap の最初の要素と最後の要素にマッピングされるアルファ データ値がそれぞれ決まります。たとえば、アルファ範囲が [3 5] の場合、3 以下のアルファ データ値は alphamap の最初の要素にマッピングされます。5 以上のアルファ データ値は alphamap の最後の要素にマッピングされます。座標軸の ALim プロパティにはアルファ範囲が含まれています。Figure の Alphamap プロパティには alphamap が含まれています。

  • 'direct' — 値を Figure の alphamap のインデックスとして解釈します。小数点以下の部分がある値は、その値より小さく、その値に最も近い整数に調整されます。

    • 値が double 型または single 型の場合、1 以下の値は alphamap の最初の要素にマッピングされます。alphamap の長さ以上の値は、alphamap の最後の要素にマッピングされます。

    • 値が整数型の場合、0 以下の値は alphamap の最初の要素にマッピングされます。alphamap の長さ以上の値は、alphamap の最後の要素に (または、その型の範囲限界値まで) マッピングされます。整数型は uint8uint16uint32uint64int8int16int32、および int64 です。

    • 値が logical 型の場合、値 0 は alphamap の最初の要素にマッピングされ、値 1 は alphamap の 2 番目の要素にマッピングされます。

表示するイメージ データの解像度レベル。bigimg の解像度レベル値以下の正の整数として指定します。

解像度レベルの選択モード。次のいずれかの値を指定します。

  • 'auto' — 親の座標軸と使用可能な画面サイズに基づいて自動的に解像度レベルを選択します。

  • 'manual'ResolutionLevel プロパティを設定することにより、手動で解像度レベルを選択します。

グリッド ラインを表示。'off' または 'on' で指定します。

グリッド ラインの解像度レベル。次のいずれかの値を指定します。

  • 正の整数 — bigimg の特定の解像度レベルに従ってグリッドを表示します。

  • 'fine' — 最も細かい (最も高い) 解像度レベルでグリッドを表示します。

  • 'coarse' — 最も粗い (最も低い) 解像度レベルでグリッドを表示します。

既定では、GridLevelResolutionLevel と同じ値です。

グリッドの解像度レベルの選択モード。次のいずれかの値を指定します。

  • 'auto' — イメージ データの解像度レベル ResolutionLevel と一致するようにグリッドの解像度レベルを選択します。

  • 'manual'GridLevel プロパティを設定することにより、手動でグリッドの解像度レベルを指定します。

グリッド ラインの色。RGB 3 成分、16 進数カラー コード、色の名前、または色の省略名として指定します。グリッド ラインを表示するには、GridVisible プロパティを 'on' に設定します。

カスタム色の場合、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度は範囲 [0,1] に含まれていなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、その後に 16 進数 (0 から F までの範囲) が 3 桁または 6 桁続く、文字ベクトルまたは string スカラーです。値の大文字と小文字は区別されません。そのため、カラー コード、'#FF8800''#ff8800''#F80'、および '#f80' は等価です。

あるいは、一部の一般的な色を名前で指定できます。次の表に、名前付きの色のオプション、等価な RGB 3 成分、および 16 進数カラー コードを示します。

色の名前省略名RGB 3 成分16 進数カラー コード外観
'red''r'[1 0 0]'#FF0000'

'green''g'[0 1 0]'#00FF00'

'blue''b'[0 0 1]'#0000FF'

'cyan' 'c'[0 1 1]'#00FFFF'

'magenta''m'[1 0 1]'#FF00FF'

'yellow''y'[1 1 0]'#FFFF00'

'black''k'[0 0 0]'#000000'

'white''w'[1 1 1]'#FFFFFF'

以下に、MATLAB がさまざまなタイプのプロットで使用する既定の色の RGB 3 成分と 16 進数カラー コードを示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]'#0072BD'

[0.8500 0.3250 0.0980]'#D95319'

[0.9290 0.6940 0.1250]'#EDB120'

[0.4940 0.1840 0.5560]'#7E2F8E'

[0.4660 0.6740 0.1880]'#77AC30'

[0.3010 0.7450 0.9330]'#4DBEEE'

[0.6350 0.0780 0.1840]'#A2142F'

例: b.GridColor = [1 0 0]

例: b.GridColor = 'r'

例: b.GridColor = 'red'

例: b.GridColor = '#FF0000'

グリッド ラインの透明度。[0, 1] の範囲の値として指定します。1 の値は完全な不透明を意味し、0 の値は完全な透明を意味します。グリッド ラインを表示するには、GridVisible プロパティを 'on' に設定します。

例: b.GridAlpha = 0.5

グリッド ラインの幅。ポイント単位の正の値として指定します。グリッド ラインを表示するには、GridVisible プロパティを 'on' に設定します。

グリッド ラインのスタイル。次の表のいずれかのライン スタイルを指定します。

ライン スタイル説明結果として得られるライン
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

グリッド ラインを表示するには、GridVisible プロパティを 'on' に設定します。

例: b.GridLineStyle = '--'

ピクセルのリサンプルに使用する内挿法。双一次内挿では 'linear'、最近傍内挿では 'nearest' を指定します。

bigimageshow を表示。次のいずれかの値を指定します。

  • 'on'bigimageshow オブジェクトを表示します。

  • 'off' — オブジェクトを削除せずに非表示にします。ただし、非表示のオブジェクトのプロパティにアクセスすることはできます。

オブジェクト関数

showmask指定した包含しきい値でのマスク オーバーレイの表示
hidemaskbigimageshow オブジェクトのマスク オーバーレイの非表示

すべて折りたたむ

.TIF ファイルから bigimage オブジェクトを作成します。

bigimg = bigimage('tumor_091R.tif');

関数 bigimageshow を使用して、最も細かい解像度レベルで bigimage を表示します。グリッドを表示するには、名前と値のペアの引数 'GridVisible''on' に指定します。

b = bigimageshow(bigimg,'ResolutionLevel',1,'GridVisible','on')
b = 

  bigimageshow with properties:

              CData: [1x1 bigimage]
       CDataMapping: 'direct'
             Parent: [1x1 Axes]
    ResolutionLevel: 1
          GridLevel: 1

  Use GET to show all properties

bigimageshow オブジェクトのプロパティを設定することにより、表示設定を変更できます。'GridColor' プロパティを設定して、グリッドの色を黄色に変更します。

b.GridColor = 'y';

制限

  • Windows® システムで OpenGL® の一部のソフトウェア バージョンを使用する場合、Interpolation プロパティは 'nearest' のみをサポートしています。

参照

[1] Bejnordi, Babak Ehteshami, Mitko Veta, Paul Johannes van Diest, Bram van Ginneken, Nico Karssemeijer, Geert Litjens, Jeroen A. W. M. van der Laak, et al. “Diagnostic Assessment of Deep Learning Algorithms for Detection of Lymph Node Metastases in Women With Breast Cancer.” JAMA 318, no. 22 (December 12, 2017): 2199–2210. https://doi.org/10.1001/jama.2017.14585.

R2019b で導入