Main Content

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

dicomread

DICOM イメージの読み取り

ページ内をすべて折りたたむ

構文

X = dicomread(filename)
X = dicomread(info)
X = dicomread(___,'frames',f)
X = dicomread(___,Name,Value)
[X,cmap] = dicomread(___)
[X,cmap,alpha] = dicomread(___)
[X,cmap,alpha,overlays] = dicomread(___)

説明

例

X = dicomread(filename) は Digital Imaging and Communications in Medicine (DICOM) 準拠ファイル filename からイメージ データを読み取ります。ボリュームを構成する一連のイメージを含む DICOM ファイルのグループを読み取るには、dicomreadVolume を使用します。

X = dicomread(info) は、DICOM メタデータ構造体 info で参照されたメッセージから DICOM イメージ データを読み取ります。

X = dicomread(___,'frames',f) は、イメージから f で指定されたフレームのみを読み取ります。

X = dicomread(___,Name,Value) は Name,Value ペアを使用してパーサーを構成し、DICOM イメージ データを読み取ります。

[X,cmap] = dicomread(___) はカラーマップ cmap も返します。

[X,cmap,alpha] = dicomread(___) は alpha、X のアルファ チャネル行列も返します。

[X,cmap,alpha,overlays] = dicomread(___) は DICOM ファイルからの任意のオーバーレイも返します。

例

すべて折りたたむ

ライブ スクリプトを開く

montage を使用して、DICOM ファイルからインデックス付きイメージを読み取って表示します。

[X, map] = dicomread('US-PAL-8-10x-echo.dcm');
montage(X, map, 'Size', [2 5]);

Figure contains an axes object. The axes object contains an object of type image.

imshow を使用して、DICOM ファイルからイメージを読み取って表示します。 

info = dicominfo('CT-MONO2-16-ankle.dcm');
Y = dicomread(info);
figure
imshow(Y,[]);

Figure contains an axes object. The axes object contains an object of type image.

入力引数

すべて折りたたむ

DICOM ファイルの名前。string スカラーまたは文字ベクトルとして指定します。

データ型: char | string

DICOM メタデータ。構造体として指定します。info 構造体は関数 dicominfo によって生成されます。

読み取るフレーム。整数のスカラー、整数ベクトルまたは 'all' を指定します。f が数値であるとき、dicomread は指定したフレーム番号だけをイメージから読み取ります。既定では、dicomread は DICOM イメージのすべてのフレームを読み取ります。

名前と値の引数

例: dicomread('CT-MONO2-16-ankle.dcm','UseVRHeuristic',false)

オプションの引数 Name,Value のコンマ区切りペアを指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を、任意の順番で指定できます。

値表現 (VR) モードの切り替えが不適切な DICOM 非準拠ファイルの読み取り。'UseVRHeuristic' および true または false から構成されるコンマ区切りのペアとして指定します。

true (既定値) に設定すると、dicomread は、VR モードの切り替えが不適切な特定の DICOM 非準拠ファイルを読み取ることができるように経験則を使用します。経験則が使用されると、dicomread は警告を表示します。まれに準拠ファイルが正しく読み取られないことがあります。このような準拠ファイルを読み取るには、UseVRHeuristic を false に設定します。

データ型: logical

出力引数

すべて折りたたむ

DICOM イメージ。次のいずれかとして返されます。

  • 単一フレームのグレースケール イメージまたはインデックス付きイメージを表す m 行 n 列の行列

  • 単一フレームのトゥルーカラー (RGB) イメージを表す m x n x 3 の配列

  • マルチフレーム イメージを表す 4 次元配列

データ型: int8 | int16 | uint8 | uint16

イメージ X と関連付けられたカラーマップ。

  • X がインデックス付きイメージの場合、cmap は、範囲 [0, 1] の値をもつ c 行 3 列の数値行列として返されます。各行は、カラーマップの単一色を構成する赤、緑、青の成分を指定する 3 要素の RGB 3 成分です。

  • X がグレースケール イメージまたはトゥルーカラー イメージの場合、cmap は空 ([]) になります。

データ型: double

イメージ X のアルファ チャネル行列。非負の整数から成る配列として返されます。ピクセルが不透明の場合、alpha の値は 0 になります。それ以外の場合は、cmap の行インデックスになります。alpha を使用するには、X の値の代わりに cmap 内の RGB 値を使う必要があります。alpha は X と同じ高さと幅を持ち、マルチフレーム イメージでは 4 次元です。alpha は X と同じデータ型です。

データ型: int8 | int16 | uint8 | uint16

DICOM ファイルからのオーバーレイ。各オーバーレイは X と同じ高さと幅をもつ 1 ビット白黒イメージです。ファイルに複数のオーバーレイがある場合、overlays は 4 次元マルチフレーム イメージになります。ファイルにオーバーレイがない場合、overlays は空 ([]) になります。

データ型: logical

ヒント

  • この関数はファイルのイメージを以下のいずれかのピクセル形式で読み取ります。

    • リトル エンディアン、暗黙的 VR、非圧縮

    • リトル エンディアン、明示的 VR、非圧縮

    • ビッグ エンディアン、明示的 VR、非圧縮

    • JPEG (非可逆または可逆)

    • JPEG2000 (非可逆または可逆)

    • 連長圧縮 (RLE)

    • GE 暗黙的 VR、LE - 非圧縮 BE ピクセル (1.2.840.113619.5.2)

バージョン履歴

R2006a より前に導入

参考

| | | | | | |