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与彩色地图提出．

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

例子

dicomwrite (＿＿＿，信息）指定元数据结构中的元数据信息，这是由此产生的dicominfo函数。

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

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

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”参数设置为“copy”时，dicomwrite.不验证写入文件的元数据。

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

输入参数

全部折叠

`X`- - - - - -DICOM图像
米——`n`矩阵|米——`n`3组|四维数组

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

一个米-经过-n表示单帧灰度图像或索引图像的矩阵
一个米-经过-n-by-3数组表示单帧真色(RGB)图像
表示多帧图像的4-D数组。

请注意

如果输入X是空的，那么呢dicomwrite.函数写一个带有空图像数据的DICOM文件。DICOM文件的元数据属性要么设置为默认值，要么从中复制meta_struct如果“CreateMode”是“复制”．

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

`提出`- - - - - -彩色地图
c3矩阵|`[]`

与索引图像相关联的颜色地图X,指定为c3矩阵。有c颜色图中的颜色，每个颜色由红色，绿色和蓝色像素值表示。

数据类型:双

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

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

数据类型:char|字符串

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

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

`信息`- - - - - -产生的元数据`dicominfo`函数
结构体

由此产生的元数据dicominfo函数，指定为结构。

`IOD.`- - - - - -DICOM信息对象
`'二次捕获图像存储'`(默认)|`CT图像存储的`|`“图像存储先生”`

DICOM信息对象，指定为'二次捕获图像存储'，CT图像存储的,或“图像存储先生”．

数据类型:char|字符串

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

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

数据类型:char|字符串

名称-值对的观点

指定可选的逗号分隔对名称,值论点。的名字参数名和价值是对应的值。的名字必须出现在引号内。您可以按如下顺序指定几个名称和值对参数name1，value1，...，namen，valuen．

例子：“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)代码写入文件，指定为由'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文件。例如，该文件可能缺少所需的元数据，包含多余的元数据，或者元数据可能不再对应于用于生成原始映像的模式设置。当使用“复制”模式，确保您使用的元数据来自相同的模式和IOD。如果你制作的副本与原始图像无关，请使用dicomuid为系列和研究元数据创建新的唯一标识符。有关适当的IOD值的更多信息，请参阅DICOM规范的第3部分中的IOD描述。

另请参阅

主题

之前介绍过的R2006a

dicomwrite.

语法

描述

例子

向DICOM文件写入数据

输入参数

`X`- - - - - -DICOM图像
米——`n`矩阵|米——`n`3组|四维数组

`提出`- - - - - -彩色地图
c3矩阵|`[]`

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

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

`信息`- - - - - -产生的元数据`dicominfo`函数
结构体

`IOD.`- - - - - -DICOM信息对象
`'二次捕获图像存储'`(默认)|`CT图像存储的`|`“图像存储先生”`

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

名称-值对的观点

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

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

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

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

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

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

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

`'vr'`- - - - - -将两个字母的值表示(VR)代码写入文件
`'隐含'`(默认)|`“明确”`

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

输出参数

`状态`—属性状态
struct |`[]`

尖端

另请参阅

主题

图像处理工具箱文档

金宝app

与Matlab引入深度学习

dicomwrite.

语法

描述

例子

向DICOM文件写入数据

输入参数

X- - - - - -DICOM图像米——n矩阵|米——n3组|四维数组

提出- - - - - -彩色地图c3矩阵|[]

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

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

信息- - - - - -产生的元数据dicominfo函数结构体

IOD.- - - - - -DICOM信息对象'二次捕获图像存储'(默认)|CT图像存储的|“图像存储先生”

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

名称-值对的观点

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

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

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

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

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

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

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

'vr'- - - - - -将两个字母的值表示(VR)代码写入文件'隐含'(默认)|“明确”

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

输出参数

状态—属性状态struct |[]

尖端

另请参阅

主题

图像处理工具箱文档

金宝app

与Matlab引入深度学习

`X`- - - - - -DICOM图像
米——`n`矩阵|米——`n`3组|四维数组

`提出`- - - - - -彩色地图
c3矩阵|`[]`

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

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

`信息`- - - - - -产生的元数据`dicominfo`函数
结构体

`IOD.`- - - - - -DICOM信息对象
`'二次捕获图像存储'`(默认)|`CT图像存储的`|`“图像存储先生”`

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

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

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

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

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

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

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

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

`'vr'`- - - - - -将两个字母的值表示(VR)代码写入文件
`'隐含'`(默认)|`“明确”`

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

`状态`—属性状态
struct |`[]`