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

dicomwrite

イメージを DICOM ファイルとして書き込む

説明

dicomwrite(X,filename) はバイナリ イメージ、グレースケール イメージまたはトゥルーカラー イメージ X をファイル filename に書き込みます。ここで、filename は、作成される Digital Imaging and Communications in Medicine (DICOM) ファイルの名前を指定します。

dicomwrite(X,cmap,filename) はカラーマップ cmap を使用してインデックス付きイメージ X を書き込みます。

dicomwrite(___,meta_struct) は構造体 meta_struct でオプションのメタデータまたはファイル オプションを指定します。meta_struct 内のフィールド名は DICOM ファイル属性名またはオプション名でなければなりません。フィールドの値は、属性またはオプションに割り当てる値にします。

dicomwrite(___,info) は、関数 dicominfo によって生成されるメタデータ構造体 info 内のメタデータを指定します。

dicomwrite(___,'ObjectType',IOD) は、特定のタイプの DICOM Information Object (IOD) に必要なメタデータを含むファイルを書き込みます。dicomwrite はサポートされる IOD に対して、必要なメタデータ属性がすべて存在することを検証し、必要に応じて欠損している属性を作成して、可能であれば既定値を指定します。確実に DICOM 仕様に準拠するファイルを作成するには、サポートされている IOD を使用することをお勧めします。詳細は、ヒントを参照してください。

dicomwrite(___,'SOPClassUID',UID) は、DICOM の固有識別子 (UID) を使用して指定した、特定のタイプの IOD に必要なメタデータを含むファイルを書き込みます。

dicomwrite(___,Name,Value) はファイルの書き込み方法に影響する Name,Value ペアを使用して、DICOM ファイルに書き込みます。名前と値のペアは複数指定できます。

Name,Value ペアを使用し、オプションのメタデータも指定して DICOM ファイルに書き込みます。指定可能な DICOM 属性の一覧は、Image Processing Toolbox™ ソフトウェアに付属のデータ ディクショナリ ファイル dicom-dict.txt に記載されています。各属性名は引用符で囲みます。

status = dicomwrite(___) は、DICOM ファイルを生成するために使用されるメタデータとその記述に関する情報を返します。この構文は、info 構造体を関数 dicomwrite に指定する場合に便利です。

すべて折りたたむ

ツールボックスに付属するサンプル DICOM ファイルから CT イメージを読み取ります。

X = dicomread('CT-MONO2-16-ankle.dcm');

CT イメージをファイルに書き込んでセカンダリ キャプチャ イメージを作成します。

dicomwrite(X, 'sc_file.dcm');

CT イメージ X をメタデータと共に DICOM ファイルに書き込みます。関数 dicominfo を使用して DICOM ファイルからメタデータを取得します。

metadata = dicominfo('CT-MONO2-16-ankle.dcm');
dicomwrite(X, 'ct_file.dcm', metadata);

あるファイルのすべてのメタデータを別のファイルにコピーします。'CreateMode' パラメーターを 'copy' に設定すると、dicomwrite では、ファイルに書き込まれるメタデータの確認は行われません。

dicomwrite(X, 'ct_copy.dcm', metadata, 'CreateMode', 'copy');

入力引数

すべて折りたたむ

DICOM イメージ。次のいずれかに指定します。

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

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

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

メモ

入力 X が空の場合、関数 dicomwrite は空のイメージ データを使用して DICOM ファイルを書き込みます。DICOM ファイルのメタデータ属性は、既定値に設定されるか、'CreateMode''Copy' の場合は meta_struct からコピーされます。

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

インデックス付きイメージ X と関連付けられたカラーマップ。c 行 3 列の行列として指定します。カラーマップに c カラーがあります。それぞれ赤、緑または青のピクセル値を表します。

データ型: double

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

データ型: char | string

オプションのメタデータまたはファイル オプション。構造体として指定します。meta_struct 内のフィールド名は DICOM ファイル属性名またはオプション名でなければなりません。フィールドの値は、属性またはオプションに割り当てる値にします。

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

DICOM 情報オブジェクト。'Secondary Capture Image Storage''CT Image Storage' または 'MR Image Storage' を指定します。

データ型: char | string

IOD に対応する DICOM の固有識別子。string スカラーまたは文字ベクトルとして指定します。

データ型: char | string

名前と値のペアの引数

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

例: 'CompressionMode','JPEG lossless'

イメージを格納するときに使用する圧縮モード。'CompressionMode' と次のいずれかから構成されるコンマ区切りのペアとして指定します。

  • 'None'

  • 'JPEG lossless'

  • 'JPEG lossy'

  • 'JPEG2000 lossy'

  • 'JPEG2000 lossless'

  • 'RLE'

データを作成し新しいファイルに格納する方法。'CreateMode' と次のいずれかから構成されるコンマ区切りのペアとして指定します。

  • 'Create' — 入力値を確認して、欠損したデータ値を生成します。

  • 'Copy' — 入力からすべての値をコピーして、欠損値を生成しません。

作成方法の選択についてのヘルプは、ヒントを参照してください。

DICOM データ ディクショナリ名。'Dictionary' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。既定のファイルは dicom-dict.mat です。

ファイルのバイト順。'Endian''ieee-le' または 'ieee-be' から構成されるコンマ区切りのペアとして指定します。

メモ

VR'Implicit' に設定されている場合、Endian'ieee-le' でなければなりません。CompressionMode または TransferSyntax が設定されている場合、dicomwrite はこの値を無視します。

マルチフレーム イメージの 1 ファイルへの書き込み。'MultiframeSingleFile' および true、または false から構成されるコンマ区切りのペアとして指定します。true の場合は、X 内のフレーム数にかかわらず、ファイルが 1 つ作成されます。false の場合は、イメージ内の各フレームに対してファイルが 1 つずつ作成されます。

データ型: logical

転送構文。'TransferSyntax' と文字ベクトルまたは string スカラーで構成されるコンマ区切りのペアとして指定します。TransferSyntax は UID で、EndianVR および CompressionMode オプションの値をエンコードします。

メモ

転送構文が指定されている場合、dicomwriteEndianVR、および CompressionMode オプションに指定された値をすべて無視します。

メタデータ値 'BitStored''BitsAllocated' および 'HighBit' の維持。'UseMetadataBitDepths'false または true で構成されるコンマ区切りのペアとして指定します。true の場合、dicomwrite は既存の値を保持します。false (既定の設定) の場合、dicomwrite はピクセル データのデータ型に基づいてこれらの値を計算します。CreateMode'Create' の場合、dicomwrite はこのフィールドを無視します。

データ型: logical

2 文字値表現 (VR) コードのファイルへの書き込み。'VR' と、以下のいずれかで構成されるコンマ区切りのペアとして指定します。

  • 'implicit' — データ ディクショナリから推測します。

  • 'explicit' — VR をファイルに書き込みます。

メモ

Endian に値 'ieee-be' を指定した場合は、VR'explicit' を指定しなければなりません。

ファイルへのプライベート データの書き込み。'WritePrivate' および false、または true から構成されるコンマ区切りのペアとして指定します。

データ型: logical

出力引数

すべて折りたたむ

属性のステータス。構造体として返されます。status は、DICOM ファイルを生成するために使用されるメタデータとその記述に関する情報が含まれます。メタデータを指定しない場合、dicomwrite は空の行列 ([]) を返します。

status 構造体には次のフィールドがあります。

フィールド

説明

'BadAttribute'

属性の内部記述が正しくありません。データ ディクショナリから欠損しているか、記述に正しくないデータが含まれている可能性があります。

'MissingCondition'

属性が条件付きですが、属性をどのようなとき使用するかに関する条件が指定されていません。

'MissingData'

ファイルに含めなければならない属性に関するデータが指定されていません。

'SuspectAttribute'

属性のデータが DICOM 仕様に含まれている列挙値のリストと一致していません。

ヒント

  • DICOM 形式の仕様には、作成可能な Information Object Definitions (IOD) がいくつか記載されています。これらの IOD は、さまざまな現実世界のモダリティ (MR、X 線、超音波など) によって生成されるイメージおよびメタデータと対応しています。DICOM 仕様では、必要なメタデータのセットと他のメタデータの有効な値が IOD のタイプごとに定義されています。

    • dicomwrite は限られた数の IOD を完全に実装します。これらの IOD に対して、dicomwrite は必要なメタデータ属性がすべて存在することを検証し、必要に応じて欠損している属性を作成して、可能であれば既定値を指定します。確実に DICOM 仕様に準拠するファイルを作成するには、サポートされている IOD を使用することをお勧めします。これは dicomwrite の既定の動作であり、'Create'CreateMode オプションの値に相当します。

    • dicomwrite によって実装されない IOD に対応した DICOM ファイルを書き込むには、CreateMode オプションに 'Copy' 値を指定します。このモードの dicomwrite では、パラメーターとして指定したメタデータも含め、イメージ データがファイルに書き込まれます (前述の info 構文を参照)。このオプションの目的は、同じモダリティまたは IOD の既存のファイルからメタデータを取得して、それに基づいて別のイメージ ピクセル データをもつ新しい DICOM ファイルを作成することです。イメージ データが空の場合、dicomwrite は、イメージに関連するメタデータ属性を新しい DICOM ファイルに書き込みません。

      メモ

      dicomwrite'Copy' モードにおいて検証なしでメタデータをファイルにコピーするため、DICOM 基準に準拠しない DICOM ファイルを作成することが可能です。たとえば、必要なメタデータがファイルから欠損しているか、余分なメタデータが含まれているか、または、元のイメージを生成するために使われるモダリティの設定にメタデータが対応しなくなっている可能性があります。'Copy' モードを使用する場合は、使用するメタデータが同じモダリティと IOD のものであることを確認してください。作成するコピーが元のイメージと関連していない場合は、dicomuid を使用してメタデータの series と study に対する新規の固有識別子を作成してください。適切な IOD 値の詳細は、DICOM 仕様 Part 3 の IOD に関する説明を参照してください。

R2006a より前に導入