dicomwrite

将图像写入DICOM文件

页面上倒塌

语法

dicomwrite（x，filename）

dicomwrite（x，cmap，filename）

dicomwrite（＿＿＿meta_struct)

dicomwrite（＿＿＿信息)

dicomwrite（＿＿＿，'ObjectType'，IOD）

dicomwrite（＿＿＿、“SOPClassUID”UID)

dicomwrite（＿＿＿、名称、值)

状态= dicomwrite (＿＿＿）

描述

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

dicomwrite（X，CMAP.，文档名称）写入索引图像X彩色地图CMAP.．

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

例子

dicomwrite（＿＿＿，信息）指定元数据结构中的元数据信息，是由dicominfo.函数。

dicomwrite（＿＿＿，'ObjectType'，IOD的）写入一个文件，其中包含特定类型的DICOM信息对象(IOD)所需的元数据。对于支持的iod万博1manbetx，dicomwrite验证是否存在所有必需的元数据属性，在必要时创建缺失的属性，并在可能的地方指定默认值。使用这些受支持的iod是万博1manbetx确保您创建的文件符合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`-By-3阵列|4-D阵列

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

一个米——- - - - - -n表示单帧灰度图像或索引图像的矩阵
一个米——- - - - - -n-By-3数组代表单帧TrueColor（RGB）图像
代表多帧图像的4-D阵列。

请注意

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

数据类型：INT8.|int16|uint8.|uint16

`CMAP.`- - - - - -彩色地图
c3矩阵|`［］`

彩色地图与索引图像相关联X，指定为c-By-3矩阵。有c颜色映射中的颜色，每一种颜色都用红、绿、蓝像素值表示。

数据类型：双倍的

`文档名称`- - - - - -DICOM文件的名称
字符向量|字符串标量

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

数据类型：字符|细绳

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

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

`信息`- - - - - -元数据由`dicominfo.`函数
结构体

生成的元数据dicominfo.函数，指定为结构。

`IOD的`- - - - - -DICOM信息对象
`“二次捕捉图像存储”`（默认）|`'CT图像存储'`|`“图像存储先生”`

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

数据类型：字符|细绳

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

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

数据类型：字符|细绳

名称-值对的观点

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

例子:'compresspectrmode'，'JPEG无损'

`'compresspectrmode'`- - - - - -压缩模式
`'没有任何'`（默认）|`'JPEG无损'`|`'JPEG损失'`|......

在存储图像时要使用的压缩模式，指定为包括的逗号分隔对'compresspectrmode'下面是其中之一。

'没有任何'
'JPEG无损'
'JPEG损失'
'jpeg2000损失'
'jpeg2000无损'
'rle'

`'createmode'`- - - - - -用于创建数据的方法
`“创建”`（默认）|`“复制”`

用于创建数据以放入新文件的方法，指定为包含的逗号分隔对'createmode'下面是其中之一。

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

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

`'字典'`- - - - - -DICOM数据字典的名称
字符向量|字符串标量

DICOM数据字典名称，由逗号分隔的对组成'字典'以及字符向量或字符串标量。默认文件为dicom-dict.mat．

`'endian'`- - - - - -字节订购
`'IEEE-LE'`（默认）|`“ieee-be”`

文件的字节排序，指定为逗号分隔对，由'endian'和'IEEE-LE'或者“ieee-be”．

请注意

如果VR.被设置为'隐含',然后尾数法必须'IEEE-LE'．dicomwrite忽略这个值如果CompressionMode或者TransferSyntax被设置。

`“MultiframeSingleFile”`- - - - - -将多帧映像写入一个文件
`真的`（默认）|`假`

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

数据类型：逻辑

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

传输语法，指定为逗号分隔的配对“TransferSyntax”以及字符向量或字符串标量。TransferSyntax是一个UID，它为尾数法，VR.,CompressionMode选项。

请注意

如果您指定了传输语法，那么dicomwrite属性指定的任何值尾数法，VR.,CompressionMode选项。

`“UseMetadataBitDepths”`- - - - - -保存元数据值
`假`（默认）|`真的`

保留元数据值“BitStored”，'bitsallocated',“哈哈”，指定为逗号分隔的对，由“UseMetadataBitDepths”和假或者真的．当真的，dicomwrite保留现有的价值观。当假（默认），dicomwrite根据像素数据的数据类型计算这些值。当CreateMode是“创建”，dicomwrite忽略这个字段。

数据类型：逻辑

`“虚拟现实”`- - - - - -将两个字母值表示（VR）代码写入文件
`“隐式”`（默认）|`'显式'`

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

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

请注意

如果指定尾数法价值“ieee-be”，则必须指定VR.作为'显式'．

`'writeprivate'`- - - - - -将私有数据写入文件
`假`（默认）|`真的`

将私有数据写入文件，指定为包含的逗号分隔对'writeprivate'和假或者真的．

数据类型：逻辑

输出参数

全部折叠

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

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

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

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

提示

DICOM格式规范列出了几种可以创建的信息对象定义(iod)。这些iod对应于不同真实世界模式(例如磁共振、x射线、超声等)产生的图像和元数据。对于每种IOD类型，DICOM规范定义了必须存在的元数据集和其他元数据的可能值。
- dicomwrite充分实现有限数量的IOD的对于这些iod，dicomwrite验证是否存在所有必需的元数据属性，在必要时创建缺失的属性，并在可能的地方指定默认值。使用这些受支持的iod是万博1manbetx确保您创建的文件符合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`-By-3阵列|4-D阵列

`CMAP.`- - - - - -彩色地图
c3矩阵|`［］`

`文档名称`- - - - - -DICOM文件的名称
字符向量|字符串标量

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

`信息`- - - - - -元数据由`dicominfo.`函数
结构体

`IOD的`- - - - - -DICOM信息对象
`“二次捕捉图像存储”`（默认）|`'CT图像存储'`|`“图像存储先生”`

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

名称-值对的观点

`'compresspectrmode'`- - - - - -压缩模式
`'没有任何'`（默认）|`'JPEG无损'`|`'JPEG损失'`|......

`'createmode'`- - - - - -用于创建数据的方法
`“创建”`（默认）|`“复制”`

`'字典'`- - - - - -DICOM数据字典的名称
字符向量|字符串标量

`'endian'`- - - - - -字节订购
`'IEEE-LE'`（默认）|`“ieee-be”`

`“MultiframeSingleFile”`- - - - - -将多帧映像写入一个文件
`真的`（默认）|`假`

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

`“UseMetadataBitDepths”`- - - - - -保存元数据值
`假`（默认）|`真的`

`“虚拟现实”`- - - - - -将两个字母值表示（VR）代码写入文件
`“隐式”`（默认）|`'显式'`

`'writeprivate'`- - - - - -将私有数据写入文件
`假`（默认）|`真的`

输出参数

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

提示

另请参阅

主题

图像处理工具箱文档

万博1manbetx

介绍基于MATLAB的深度学习

dicomwrite

语法

描述

例子

将数据写入DICOM文件

输入参数

X- - - - - -DICOM图像米——n矩阵|米——n-By-3阵列|4-D阵列

CMAP.- - - - - -彩色地图c3矩阵|［］

文档名称- - - - - -DICOM文件的名称字符向量|字符串标量

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

信息- - - - - -元数据由dicominfo.函数结构体

IOD的- - - - - -DICOM信息对象“二次捕捉图像存储”（默认）|'CT图像存储'|“图像存储先生”

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

名称-值对的观点

'compresspectrmode'- - - - - -压缩模式'没有任何'（默认）|'JPEG无损'|'JPEG损失'|......

'createmode'- - - - - -用于创建数据的方法“创建”（默认）|“复制”

'字典'- - - - - -DICOM数据字典的名称字符向量|字符串标量

'endian'- - - - - -字节订购'IEEE-LE'（默认）|“ieee-be”

“MultiframeSingleFile”- - - - - -将多帧映像写入一个文件真的（默认）|假

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

“UseMetadataBitDepths”- - - - - -保存元数据值假（默认）|真的

“虚拟现实”- - - - - -将两个字母值表示（VR）代码写入文件“隐式”（默认）|'显式'

'writeprivate'- - - - - -将私有数据写入文件假（默认）|真的

输出参数

状态-属性状态struct |［］

提示

另请参阅

主题

图像处理工具箱文档

万博1manbetx

介绍基于MATLAB的深度学习

`X`- - - - - -DICOM图像
米——`n`矩阵|米——`n`-By-3阵列|4-D阵列

`CMAP.`- - - - - -彩色地图
c3矩阵|`［］`

`文档名称`- - - - - -DICOM文件的名称
字符向量|字符串标量

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

`信息`- - - - - -元数据由`dicominfo.`函数
结构体

`IOD的`- - - - - -DICOM信息对象
`“二次捕捉图像存储”`（默认）|`'CT图像存储'`|`“图像存储先生”`

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

`'compresspectrmode'`- - - - - -压缩模式
`'没有任何'`（默认）|`'JPEG无损'`|`'JPEG损失'`|......

`'createmode'`- - - - - -用于创建数据的方法
`“创建”`（默认）|`“复制”`

`'字典'`- - - - - -DICOM数据字典的名称
字符向量|字符串标量

`'endian'`- - - - - -字节订购
`'IEEE-LE'`（默认）|`“ieee-be”`

`“MultiframeSingleFile”`- - - - - -将多帧映像写入一个文件
`真的`（默认）|`假`

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

`“UseMetadataBitDepths”`- - - - - -保存元数据值
`假`（默认）|`真的`

`“虚拟现实”`- - - - - -将两个字母值表示（VR）代码写入文件
`“隐式”`（默认）|`'显式'`

`'writeprivate'`- - - - - -将私有数据写入文件
`假`（默认）|`真的`

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