このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
dicomwrite
イメージを DICOM ファイルとして書き込む
構文
説明
dicomwrite(___,
は、前の構文の入力引数の組み合わせに加えて、オプションのメタデータまたはファイル オプションを構造体 meta_struct
)meta_struct
で指定します。meta_struct
内のフィールド名は DICOM ファイル属性名またはオプション名でなければなりません。フィールドの値は、属性またはオプションに割り当てる値にします。
dicomwrite(___,"SOPClassUID",
は、DICOM の固有識別子 (UID) を使用して指定した、特定のタイプの IOD に必要なメタデータを含むファイルを書き込みます。UID
)
dicomwrite(___,
は、名前と値の引数を使用して追加のオプションを指定します。また、この構文を使用して、個々のメタデータ属性とその値を指定して DICOM ファイルに書き込むこともできます。指定可能な DICOM 属性の一覧は、Image Processing Toolbox™ ソフトウェアに付属のデータ ディクショナリ ファイル Name,Value
)dicom-dict.txt
に記載されています。各属性名は引用符で囲みます。
例
入力引数
出力引数
ヒント
DICOM 形式の仕様には、作成可能な Information Object Definitions (IOD) がいくつか記載されています。これらの IOD は、さまざまな現実世界のモダリティ (MRI、X 線、超音波など) によって生成されるイメージおよびメタデータと対応しています。DICOM 仕様では、必要なメタデータのセットと、その他のメタデータの有効な値が IOD のタイプごとに定義されています。
dicomwrite
は、一部のIOD
(セカンダリ キャプチャ、コンピューター断層撮影、磁気共鳴) を完全に実装しています。これらの IOD の場合、dicomwrite
は、指定された IOD に必要なメタデータ属性がすべて存在するかを検証し、必要に応じて欠損している属性を作成して、可能であれば既定値を指定します。さらに、dicomwrite
は、指定された IOD の DICOM 仕様に含まれていない属性を削除します。この動作は、名前と値の引数CreateMode
が既定値である"Create"
の場合の動作です。サポートされている IOD で DICOM ファイルを操作する場合は、CreateMode
を"Create"
に設定することが、作成するファイルを DICOM 仕様に確実に準拠させる最善の方法です。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 に関する説明を参照してください。
関数
dicomwrite
は、DICOM ファイルを書き込む前に、名前と値の引数CreateMode
の値にかかわらず、名前に "Group Length
" を含むメタデータ属性を削除します。グループ長の属性を含めるとエラーが起こりやすく、DICOM 仕様では現在推奨されていません。他のソフトウェアまたはデバイスは、グループ長の属性なしで DICOM ファイルを読み取ることができます。
バージョン履歴
R2006a より前に導入