dicomwrite

将映像写入DICOM文件

折叠所有页面

语法

dicomwrite (X,文件名)

dicomwrite (X,提出,文件名)

dicomwrite (___meta_struct)

dicomwrite (___信息)

dicomwrite (___ObjectType, IOD)

dicomwrite (___、“SOPClassUID”UID)

dicomwrite (___、名称、值)

状态= dicomwrite(___）

描述

dicomwrite (X，文件名）写入二进制、灰度或真彩色图像X到文件文件名,在那里文件名指定要创建的医学数字成像和通信(DICOM)文件的名称。

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

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

例子

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

dicomwrite (___“ObjectType”,IOD的）为特定类型的DICOM信息对象(IOD)写入包含必要元数据的文件。对于支持的iod万博1manbetx，dicomwrite验证是否存在所有必需的元数据属性，在必要时创建缺失的属性，并在可能的情况下指定默认值。使用这些受支持的iod是万博1manbetx确保所创建的文件符合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'参数为'copy'时，dicomwrite不验证写入文件的元数据。

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

输入参数

全部折叠

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

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

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

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

`提出`- - - - - -彩色地图
c3矩阵|`［］`

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

数据类型:双

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

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

数据类型:字符|字符串

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

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

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

由dicominfo函数，指定为结构。

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

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

数据类型:字符|字符串

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

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

数据类型:字符|字符串

名称-值对参数

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

例子:“CompressionMode”，JPEG无损的

全部折叠

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

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

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

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

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

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

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

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

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

`“尾数法”`- - - - - -字节次序
`“小”`(默认)|`“大”`

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

请注意

如果虚拟现实设置为“明确”,然后尾数法必须“大”．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写入文件。

请注意

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

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

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

数据类型:逻辑

输出参数

全部折叠

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

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

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

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

提示

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

另请参阅

R2006a之前介绍

这个话题有用吗?

文档

dicomwrite

语法

描述

例子

将数据写入DICOM文件

输入参数

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

`提出`- - - - - -彩色地图
c3矩阵|`［］`

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

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

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

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

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

名称-值对参数

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

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

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

`“尾数法”`- - - - - -字节次序
`“小”`(默认)|`“大”`

请注意

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

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

请注意

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

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

请注意

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

输出参数

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

提示

请注意

另请参阅

R2006a之前介绍

图像处理工具箱文档

万博1manbetx

试试MATLAB、Sim万博1manbetxulink和其他产品s manbetx 845

文档

dicomwrite

语法

描述

例子

将数据写入DICOM文件

输入参数

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

提出- - - - - -彩色地图c3矩阵|［］

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

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

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

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

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

名称-值对参数

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

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

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

“尾数法”- - - - - -字节次序“小”(默认)|“大”

请注意

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

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

请注意

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

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

请注意

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

输出参数

状态-属性状态struct |［］

提示

请注意

另请参阅

R2006a之前介绍

图像处理工具箱文档

万博1manbetx

试试MATLAB、Sim万博1manbetxulink和其他产品s manbetx 845

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

`提出`- - - - - -彩色地图
c3矩阵|`［］`

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

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

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

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

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

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

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

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

`“尾数法”`- - - - - -字节次序
`“小”`(默认)|`“大”`

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

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

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

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

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

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