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

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 に設定します。

データ型: 論理値

出力引数

すべて折りたたむ

`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)

参考

dicomread

構文

説明