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

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 ファイルからの任意のオーバーレイも返します。

例

DICOM ファイルの読み取り

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

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

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

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

入力引数

filename — DICOM ファイル名

文字ベクトル | string スカラー

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

データ型: char | string

info — DICOM メタデータ

構造体

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

f — 読み取るフレーム

'all' (既定値) | 整数 | 整数のベクトル

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

名前と値のペアの引数

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

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

'UseVRHeuristic' — VR モードの切り替えが不適切な DICOM 非準拠ファイルの読み取り

true (既定値) | false

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

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

データ型: logical

出力引数

X — DICOM イメージ

m 行 n 列の行列 | m x n x 3 の配列 | 4 次元配列

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

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

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

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

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

cmap — カラーマップ

c 列 3 行の行列 | []

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

• X がインデックス付きイメージの場合、cmap は c 行 3 列の行列として返されます。カラーマップに c カラーがあります。それぞれ赤、緑または青のピクセル値を表します。

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

データ型: double

alpha — アルファ チャネル行列

m 行 n 列の非負の整数の行列 | 非負の整数から成る 4 次元配列

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

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

overlays — オーバーレイ

m 行 n 列のバイナリ行列 | 4 次元バイナリ配列 | []

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

データ型: logical

ヒント

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

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

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

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

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

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

  • 連長圧縮 (RLE)

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

参考

dicomanon | dicomdict | dicomdisp | dicominfo | dicomlookup | dicomreadVolume | dicomuid | dicomwrite

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがシステム上にあります。代わりにこのバージョンを開きますか?

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