dicomwrite

将映像写入DICOM文件

折叠所有页面

语法

dicomwrite (X,文件名)

dicomwrite (X,提出,文件名)

dicomwrite (___meta_struct)

dicomwrite (___信息)

dicomwrite (___ObjectType, IOD)

dicomwrite (___、“SOPClassUID”UID)

dicomwrite (___、名称、值)

状态= dicomwrite(___）

描述

dicomwrite (X，文件名）写入二进制、灰度或真彩色图像X到文件文件名．的dicomwrite函数创建医学数字成像和通信(DICOM)文件或安全数字成像和通信(DICOS)文件。

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

dicomwrite (___，meta_struct）在结构中指定可选元数据或文件选项meta_struct．中的字段名称meta_struct必须是DICOM文件属性或选项的名称。字段的值是要分配给属性或选项的值。

例子

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

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

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

dicomwrite (___，名称,值）写入DICOM文件时使用名称-值参数来影响文件的写入方式。

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

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

例子

全部折叠

将数据写入DICOM文件

打开实时脚本

从工具箱中包含的示例DICOM文件中读取CT图像。

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

将CT图像写入文件，创建二次捕获图像。

dicomwrite (X,“sc_file.dcm”）;

写入CT图像，X到DICOM文件及其元数据。使用dicominfo函数从DICOM文件检索元数据。

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

将所有元数据从一个文件复制到另一个文件。当你设置“CreateMode”参数“复制”，dicomwrite不验证写入文件的元数据。

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

输入参数

全部折叠

`X`- - - - - -DICOM图像
米——- - - - - -n矩阵|米——- - - - - -n3组|米——- - - - - -n——- - - - - -numChannels——- - - - - -numFrames数组

DICOM映像，指定为下列之一。

一个米——- - - - - -n表示单帧灰度图像或索引图像的矩阵
一个米——- - - - - -n-by-3数组表示单帧真彩色(RGB)图像
一个米——- - - - - -n——- - - - - -numChannels——- - - - - -numFrames表示多帧图像的数组。numChannels为1表示灰度图像，为3表示真彩色图像。

请注意

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

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

`提出`- - - - - -Colormap
c3矩阵|`［］`

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

数据类型:双

`文件名`- - - - - -DICOM文件名称
特征向量|字符串标量

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

数据类型:字符|字符串

`meta_struct`- - - - - -可选的元数据或文件选项
结构体

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

`信息`- - - - - -由`dicominfo`函数
结构

由dicominfo函数，指定为结构。

`IOD的`- - - - - -DICOM信息对象
`“二次捕获图像存储”`(默认)|`“CT图像存储”`|`“磁共振图像存储”`

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

数据类型:字符|字符串

`UID`- - - - - -DICOM唯一标识符
特征向量|字符串标量

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

数据类型:字符|字符串

名称-值参数

的可选逗号分隔对名称,值参数。名字参数名称和价值对应的值。名字必须出现在引号内。您可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家．

例子:“CompressionMode”，JPEG无损的

`CompressionMode`- - - - - -压缩模式
`“没有”`(默认)|`JPEG无损的`|`JPEG有损压缩的`|……

存储图像时使用的压缩模式，指定为由逗号分隔的对组成“CompressionMode”下面是其中之一。

“没有”
JPEG无损的
JPEG有损压缩的
如JPEG2000有损的
“如JPEG2000无损”
“RLE”

`CreateMode`- - - - - -用于创建数据的方法
`“创建”`(默认)|`“复制”`

方法用于创建要放入新文件的数据，指定为逗号分隔的对，由“CreateMode”下面是其中之一。

“创建”-验证输入值并生成缺失数据值。
“复制”-从输入中复制所有值，不生成缺失值。

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

`字典`- - - - - -DICOM数据字典名称
特征向量|字符串标量

DICOM数据字典的名称，指定为逗号分隔的对，由“字典”和字符向量或字符串标量。默认文件为dicom-dict.mat．

`尾数法`- - - - - -字节次序
`“ieee-le”`(默认)|`“ieee-be”`

文件的字节顺序，指定为逗号分隔的对，由“尾数法”而且“ieee-le”或“ieee-be”．

请注意

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

`MultiframeSingleFile`- - - - - -将多帧图像写入一个文件
`真正的`(默认)|`假`

将多帧图像写入一个文件，指定为由逗号分隔的对组成“MultiframeSingleFile”而且真正的或假．当真正的，不管有多少帧，都会创建一个文件X包含。当假，为图像中的每一帧写入一个文件。

数据类型:逻辑

`TransferSyntax`- - - - - -传输语法
特征向量|字符串标量

传输语法，指定为逗号分隔的对，由“TransferSyntax”和字符向量或字符串标量。TransferSyntax的值编码的UID尾数法，虚拟现实,CompressionMode选项。

请注意

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

`UseMetadataBitDepths`- - - - - -保留元数据值
`假`(默认)|`真正的`

保留元数据值“BitStored”，“BitsAllocated”,“HighBit”，指定为逗号分隔的对，由“UseMetadataBitDepths”而且假或真正的．当真正的，dicomwrite保留现有值。当假(默认),dicomwrite根据像素数据的数据类型计算这些值。当CreateMode是“创建”，dicomwrite忽略此字段。

数据类型:逻辑

`虚拟现实`- - - - - -将两个字母的值表示(VR)代码写入文件
`“隐式”`(默认)|`“明确”`

将两个字母的值表示(VR)代码写入文件，指定为由逗号分隔的对组成“虚拟现实”下面是其中之一。

“隐式”-从数据字典中推断。
“明确”—将VR写入文件。

请注意

如果您指定尾数法值作为“ieee-be”，那么你必须指定虚拟现实作为“明确”．

`WritePrivate`- - - - - -将私有数据写入文件
`假`(默认)|`真正的`

将私有数据写入文件，指定为由逗号分隔的对组成“WritePrivate”而且假或真正的．

数据类型:逻辑

输出参数

全部折叠

`状态`-属性状态
struct |`［］`

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

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

场	描述
`“BadAttribute”`	该属性的内部描述是坏的。它可能从数据字典中丢失，或者在其描述中有不正确的数据。
`“MissingCondition”`	该属性是有条件的，但没有提供何时使用它的条件。
`“MissingData”`	没有为必须出现在文件中的属性提供数据。
`“SuspectAttribute”`	属性中的数据与DICOM规范中的枚举值列表不匹配。

提示

DICOM格式规范列出了几个可以创建的信息对象定义(iod)。这些iod对应于由不同的现实形态(例如MR、x射线、超声等)产生的图像和元数据。对于每种类型的IOD, DICOM规范定义了必须显示的元数据集和其他元数据的可能值。
- dicomwrite充分实现了有限数量的IOD的s.对于这些iod，dicomwrite验证是否存在所有必需的元数据属性，在必要时创建缺失的属性，并在可能的情况下指定默认值。使用这些受支持的iod是金宝app确保所创建的文件符合DICOM规范的最佳方法。这是dicomwrite的默认行为CreateMode选项值“创建”．
- 为iod编写DICOM文件dicomwrite没有实现，使用“复制”的值。CreateMode选择。在这种模式下，dicomwrite将图像数据写入包含作为参数指定的元数据的文件，如上面的信息语法。此选项的目的是从具有相同模式或IOD的现有文件中获取元数据，并使用它创建具有不同图像像素数据的新DICOM文件。如果图像数据为空，dicomwrite不会将与图像相关的元数据属性写入新的DICOM文件。
  
  请注意
  
  因为dicomwrite将元数据复制到文件中而不进行验证“复制”模式下，可能会创建一个不符合DICOM标准的DICOM文件。例如，文件可能缺少必需的元数据，包含多余的元数据，或者元数据可能不再对应于用于生成原始图像的模态设置。当使用“复制”mode，确保您使用的元数据来自相同的modality和IOD。如果复制的图像与原始图像无关，请使用dicomuid为系列和研究元数据创建新的唯一标识符。有关适当的IOD值的更多信息，请参阅DICOM规范第3部分中的IOD描述。

另请参阅

主题

R2006a之前介绍

dicomwrite

语法

描述

例子

将数据写入DICOM文件

输入参数

`X`- - - - - -DICOM图像
米——- - - - - -n矩阵|米——- - - - - -n3组|米——- - - - - -n——- - - - - -numChannels——- - - - - -numFrames数组

`提出`- - - - - -Colormap
c3矩阵|`［］`

`文件名`- - - - - -DICOM文件名称
特征向量|字符串标量

`meta_struct`- - - - - -可选的元数据或文件选项
结构体

`信息`- - - - - -由`dicominfo`函数
结构

`IOD的`- - - - - -DICOM信息对象
`“二次捕获图像存储”`(默认)|`“CT图像存储”`|`“磁共振图像存储”`

`UID`- - - - - -DICOM唯一标识符
特征向量|字符串标量

名称-值参数

`CompressionMode`- - - - - -压缩模式
`“没有”`(默认)|`JPEG无损的`|`JPEG有损压缩的`|……

`CreateMode`- - - - - -用于创建数据的方法
`“创建”`(默认)|`“复制”`

`字典`- - - - - -DICOM数据字典名称
特征向量|字符串标量

`尾数法`- - - - - -字节次序
`“ieee-le”`(默认)|`“ieee-be”`

`MultiframeSingleFile`- - - - - -将多帧图像写入一个文件
`真正的`(默认)|`假`

`TransferSyntax`- - - - - -传输语法
特征向量|字符串标量

`UseMetadataBitDepths`- - - - - -保留元数据值
`假`(默认)|`真正的`

`虚拟现实`- - - - - -将两个字母的值表示(VR)代码写入文件
`“隐式”`(默认)|`“明确”`

`WritePrivate`- - - - - -将私有数据写入文件
`假`(默认)|`真正的`

输出参数

`状态`-属性状态
struct |`［］`

提示

另请参阅

主题

图像处理工具箱文档

金宝app

用MATLAB介绍深度学习

dicomwrite

语法

描述

例子

将数据写入DICOM文件

输入参数

X- - - - - -DICOM图像米——- - - - - -n矩阵|米——- - - - - -n3组|米——- - - - - -n——- - - - - -numChannels——- - - - - -numFrames数组

提出- - - - - -Colormapc3矩阵|［］

文件名- - - - - -DICOM文件名称特征向量|字符串标量

meta_struct- - - - - -可选的元数据或文件选项结构体

信息- - - - - -由dicominfo函数结构

IOD的- - - - - -DICOM信息对象“二次捕获图像存储”(默认)|“CT图像存储”|“磁共振图像存储”

UID- - - - - -DICOM唯一标识符特征向量|字符串标量

名称-值参数

CompressionMode- - - - - -压缩模式“没有”(默认)|JPEG无损的|JPEG有损压缩的|……

CreateMode- - - - - -用于创建数据的方法“创建”(默认)|“复制”

字典- - - - - -DICOM数据字典名称特征向量|字符串标量

尾数法- - - - - -字节次序“ieee-le”(默认)|“ieee-be”

MultiframeSingleFile- - - - - -将多帧图像写入一个文件真正的(默认)|假

TransferSyntax- - - - - -传输语法特征向量|字符串标量

UseMetadataBitDepths- - - - - -保留元数据值假(默认)|真正的

虚拟现实- - - - - -将两个字母的值表示(VR)代码写入文件“隐式”(默认)|“明确”

WritePrivate- - - - - -将私有数据写入文件假(默认)|真正的

输出参数

状态-属性状态struct |［］

提示

另请参阅

主题

图像处理工具箱文档

金宝app

用MATLAB介绍深度学习

`X`- - - - - -DICOM图像
米——- - - - - -n矩阵|米——- - - - - -n3组|米——- - - - - -n——- - - - - -numChannels——- - - - - -numFrames数组

`提出`- - - - - -Colormap
c3矩阵|`［］`

`文件名`- - - - - -DICOM文件名称
特征向量|字符串标量

`meta_struct`- - - - - -可选的元数据或文件选项
结构体

`信息`- - - - - -由`dicominfo`函数
结构

`IOD的`- - - - - -DICOM信息对象
`“二次捕获图像存储”`(默认)|`“CT图像存储”`|`“磁共振图像存储”`

`UID`- - - - - -DICOM唯一标识符
特征向量|字符串标量

`CompressionMode`- - - - - -压缩模式
`“没有”`(默认)|`JPEG无损的`|`JPEG有损压缩的`|……

`CreateMode`- - - - - -用于创建数据的方法
`“创建”`(默认)|`“复制”`

`字典`- - - - - -DICOM数据字典名称
特征向量|字符串标量

`尾数法`- - - - - -字节次序
`“ieee-le”`(默认)|`“ieee-be”`

`MultiframeSingleFile`- - - - - -将多帧图像写入一个文件
`真正的`(默认)|`假`

`TransferSyntax`- - - - - -传输语法
特征向量|字符串标量

`UseMetadataBitDepths`- - - - - -保留元数据值
`假`(默认)|`真正的`

`虚拟现实`- - - - - -将两个字母的值表示(VR)代码写入文件
`“隐式”`(默认)|`“明确”`

`WritePrivate`- - - - - -将私有数据写入文件
`假`(默认)|`真正的`

`状态`-属性状态
struct |`［］`