主要内容

dicomwrite

将映像写入DICOM文件

折叠所有页面

语法

dicomwrite (X,文件名)
dicomwrite (X,提出,文件名)
dicomwrite (___meta_struct)
dicomwrite (___信息)
dicomwrite (___“ObjectType”,IOD)
dicomwrite (___、“SOPClassUID UID)
dicomwrite (___、名称、值)
状态= dicomwrite(___）

描述

dicomwrite (X，文件名）写入二进制、灰度或真彩色图像X到文件文件名．的dicomwrite函数创建医学数字成像和通信(DICOM)文件或安全数字成像和通信(DICOS)文件。此语法用二级捕获DICOM信息对象(IOD)所需的元数据写入文件。

dicomwrite (X，提出，文件名）写入索引图像X与colormap提出．

dicomwrite (___，meta_struct）指定结构中的可选元数据或文件选项meta_struct，除了以前语法中的参数的任何组合。中的字段名称meta_struct必须是DICOM文件属性或选项的名称。字段的值是要分配给属性或选项的值。

例子

dicomwrite (___，信息）指定元数据结构中的元数据信息，是由dicominfo函数。

dicomwrite (___“ObjectType”,IOD的）为特定类型的DICOM信息对象(IOD)写入包含必要元数据的文件。对于支持的iod金宝app，dicomwrite验证所有必需的元数据属性是否存在于指定的IOD中，在必要时创建缺失的属性，并在可能的情况下指定默认值。此外,dicomwrite删除不属于指定IOD的DICOM规范的属性。有关更多信息，请参见提示．

dicomwrite (___“SOPClassUID”,UID）写入一个文件，其中包含使用DICOM唯一标识符(UID)指定的特定类型IOD的必要元数据。

dicomwrite (___，名称,值）使用名称-值参数指定其他选项。还可以使用此语法指定要写入DICOM文件的各个元数据属性及其值。要查找可以指定的DICOM属性列表，请查看数据字典文件，dicom-dict.txt，包括与图像处理工具箱™软件。将每个属性名称用引号括起来。

状态= dicomwrite (___）返回关于元数据和用于生成DICOM文件的描述的信息。类时，此语法可能很有用信息结构到dicomwrite函数。

例子

全部折叠

打开实时脚本

从DICOM文件中读取CT图像。

X = dicomread(“CT-MONO2-16-ankle.dcm”）;

将CT图像写入文件，创建二次捕获图像。该操作为二级捕获DICOM信息对象(IOD)创建一个具有必要元数据属性的DICOM文件。

dicomwrite (X,“sc_file.dcm”）;

将CT图像与其元数据一起写入DICOM文件。使用dicominfo函数从DICOM文件检索元数据。默认情况下，dicomwrite函数验证新文件中的元数据属性是否符合Secondary Capture IOD标准。

元数据= dicominfo(“CT-MONO2-16-ankle.dcm”）;dicomwrite (X,“ct_file.dcm”、元数据);

写X到另一个DICOM文件，并直接复制其元数据。当你设置CreateMode参数“复制”，dicomwrite不验证写入文件的元数据。

dicomwrite (X,“ct_copy.dcm”、元数据“CreateMode”，“复制”）;

输入参数

全部折叠

DICOM映像，指定为以下选项之一:

  • 一个米——- - - - - -n表示单帧灰度图像或索引图像的矩阵。

  • 一个米——- - - - - -n-by-3数组表示单帧真彩色(RGB)图像。

  • 表示多帧图像的4-D数组。

请注意

如果X是空的，那么dicomwrite函数用空映像数据写入DICOM文件。DICOM文件的元数据属性要么设置为默认值，要么从meta_struct,如果CreateMode指定为“复制”．

数据类型:int8|int16|uint8|uint16

与索引图像相关联的颜色映射X，指定为c-by-3数值矩阵，值范围为[0,1]。每一行都是一个三元素的RGB三元组，它指定了颜色图中单一颜色的红色、绿色和蓝色组件。

数据类型:双

要写入的DICOM文件的名称，指定为字符向量或字符串标量。

数据类型:字符|字符串

可选元数据或文件选项，以结构形式指定。中的字段名称meta_struct必须是DICOM文件属性或选项的名称。字段的值是要分配给属性或选项的值。

由dicominfo函数，指定为结构。

DICOM信息对象，指定为“二次捕获图像存储”，《CT图像存储》,或“磁共振图像存储”．

数据类型:字符|字符串

对应的DICOM唯一标识符IOD的，指定为字符向量或字符串标量。

数据类型:字符|字符串

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

例子:new_file dicomwrite (X。”dcm”,CompressionMode = " JPEG无损”)写入映像数据X到DICOM文件new_file.dcmJPEG无损压缩。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:new_file dicomwrite (X。”dcm”、“CompressionMode”、“JPEG无损”)写入映像数据X到DICOM文件new_file.dcmJPEG无损压缩。

存储图像时使用的压缩模式，指定为以下选项之一:

  • “没有”

  • “JPEG无损”

  • “JPEG有损压缩”

  • “如JPEG2000有损”

  • “如JPEG2000无损”

  • “RLE”

请注意

如果指定压缩模式，则dicomwrite属性指定的任何值尾数法或虚拟现实参数。

方法用于创建要放入新文件的数据，指定为以下选项之一:

  • “创造”-验证输入值，删除无关属性，并生成缺失的数据值。

  • “复制”-从输入中复制所有值，不生成缺失值。

有关选择创建方法的帮助，请参见提示．

DICOM数据字典的名称，指定为字符向量或字符串标量。默认文件为dicom-dict.mat．

文件的字节顺序，指定为“ieee-le”或“ieee-be”．

请注意

如果虚拟现实设置为“隐式”,然后尾数法必须“ieee-le”．的dicomwrite函数忽略此值CompressionMode或TransferSyntax．

将多帧图像写入一个文件，指定为逻辑文件1（真正的)或0（假)．当真正的，该函数创建一个文件，不管有多少帧X包含。当假，该函数为图像中的每一帧创建一个文件。

数据类型:逻辑

传输语法，指定为字符向量或字符串标量。TransferSyntax的值编码的UID尾数法，虚拟现实,CompressionMode选项。

请注意

如果指定传输语法，则dicomwrite属性指定的任何值尾数法，虚拟现实,CompressionMode选项。

保留元数据值，指定为逻辑0（假)或1（真正的)．当真正的，dicomwrite属性的现有值“BitStored”，“BitsAllocated”,“HighBit”元数据结构的字段。当假，dicomwrite根据像素数据的数据类型计算这些值。

请注意

当你指定CreateMode作为“创造”，dicomwrite忽略这个值。

数据类型:逻辑

将两个字母的值表示(VR)代码写入文件，指定为以下选项之一:

  • “隐式”-从数据字典中推断。

  • “明确”—将VR写入文件。

请注意

如果您指定尾数法值作为“ieee-be”，那么你必须指定虚拟现实作为“明确”．的dicomwrite函数忽略此值TransferSyntax或CompressionMode．

将私有数据写入指定为逻辑的文件0（假)或1（真正的)．

数据类型:逻辑

输出参数

全部折叠

属性的状态，作为结构返回。状态包含关于元数据和用于生成DICOM文件的描述的信息。如果没有指定元数据，dicomwrite返回一个空矩阵(［］)．

的状态结构包含这些字段。

场

描述

BadAttribute

属性的内部描述错误。它可能从数据字典中丢失，或者在其描述中有不正确的数据。

MissingCondition

该属性是有条件的，但是没有提供何时使用它的条件。

MissingData

没有为必须出现在文件中的属性提供数据。

SuspectAttribute

属性中的数据与DICOM规范中的枚举值列表不匹配。

提示

  • DICOM格式规范列出了几个可以创建的信息对象定义(iod)。这些iod对应于由不同的现实形态(如MRI、x射线和超声)产生的图像和元数据。对于每种类型的IOD, DICOM规范定义了必须显示的元数据集，以及其他元数据的可能值。

    • dicomwrite充分实现了有限数量的IOD的s(二次捕获，计算机断层扫描，磁共振)。对于这些iod，dicomwrite验证所有必需的元数据属性是否存在于指定的IOD中，在必要时创建缺失的属性，并在可能的情况下指定默认值。此外,dicomwrite删除不属于指定IOD的DICOM规范的属性。属性的默认值对应CreateMode名称-值参数,“创造”．如果您正在使用一个受支持的iod来处理DICOM文件，请设置金宝appCreateMode来“创造”是确保您创建的文件符合DICOM规范的最佳方法。

    • 为iod编写DICOM文件dicomwrite不完全支持，使用金宝app“复制”的值。CreateMode名称-值参数。在这种模式下，dicomwrite将映像数据写入包含您使用信息输入参数。此选项使您能够从具有相同模式或IOD的现有文件中获取元数据，并使用它创建具有不同图像像素数据的新DICOM文件。如果图像数据为空，dicomwrite不会将与图像相关的元数据属性写入新的DICOM文件。

      请注意

      因为dicomwrite将元数据复制到文件中而不进行验证“复制”模式下，可创建不符合DICOM标准的DICOM文件。例如，文件可能缺少必需的元数据，包含多余的元数据，或者元数据可能不再对应于用于生成原始图像的模态设置。当使用“复制”mode，确保您使用的元数据来自相同的modality和IOD。如果复制的图像与原始图像无关，请使用dicomuid为系列和研究元数据创建新的唯一标识符。有关适当的IOD值的更多信息，请参阅DICOM规范第3部分中的IOD描述。

  • 的dicomwrite函数使用“组的长度的值，然后再写入新的DICOM文件CreateMode名称-值参数。包含组长度属性很容易出错，目前DICOM规范不建议这样做。其他软件或设备可以读取没有组长属性的DICOM文件。

版本历史

R2006a之前介绍

另请参阅

||||||

主题