主要内容

dicomwrite

编写图像DICOM文件

所有的页面崩溃

语法

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

描述

dicomwrite (X,文件名)写入二进制、灰度或真彩图像X到文件文件名。的dicomwrite函数创建一个医学数字成像和通信(DICOM)文件或数码影像和通信安全(德克士)文件。这个语法写一个文件和必要的辅助捕获DICOM信息对象的元数据(IOD)。

dicomwrite (X,提出,文件名)写索引图像X与colormap提出。

dicomwrite (___,meta_struct)指定可选的元数据结构或文件选项meta_struct除了参数从以前的语法的任意组合。字段的名称meta_struct必须DICOM文件属性的名称或选择。一个字段的值是你想要的值分配给属性或选项。

例子

dicomwrite (___,信息)指定元数据的元数据结构信息,这是产生的dicominfo函数。

dicomwrite (___“ObjectType”,IOD的)写一个文件包含必要的元数据为特定类型的DICOM对象信息(IOD)。在iod的支持,金宝appdicomwrite验证所需的所有元数据属性存在指定的IOD,如果有必要创建缺失的属性,并指定默认值。此外,dicomwrite删除属性不指定IOD DICOM规范的一部分。有关更多信息,请参见提示。

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

dicomwrite (___,名称,值)使用名称-值参数指定附加选项。您还可以使用该语法来指定各个元数据属性和它们的值写DICOM文件。找到DICOM属性的列表,您可以指定将数据字典文件,dicom-dict.txt,包括图像处理工具箱™软件。在报价附上每个属性的名字。

状态= dicomwrite (___)返回的信息元数据和用于生成DICOM文件的描述。这个语法是有用的,当你可以指定一个信息结构dicomwrite函数。

例子

全部折叠

打开生活的脚本

从DICOM文件读取CT图像。

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

CT图像写入一个文件,创建一个辅助捕获图像。此操作将创建一个DICOM文件必要的元数据属性二级捕获DICOM信息对象(IOD)。

dicomwrite (X,“sc_file.dcm”);

写CT图像DICOM文件及其元数据。使用dicominfo函数来检索从DICOM文件的元数据。默认情况下,dicomwrite功能验证新文件的元数据属性符合二级捕获IOD标准。

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

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

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

输入参数

全部折叠

DICOM图像,指定这些选项之一:

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

  • 一个米——- - - - - -n3数组代表一个单帧真彩图像(RGB)。

  • 四维数组代表多帧图像。

请注意

如果X是空的,然后呢dicomwrite函数写了DICOM文件与空的图像数据。DICOM文件的元数据属性设置为默认值或抄袭meta_struct,如果CreateMode被指定为“复制”。

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

Colormap与索引相关的图片X指定为一个c3数字矩阵中的值区间[0,1]。每一行是一个三元素RGB值,指定了红色、绿色和蓝色的组件的单个colormap的颜色。

数据类型:双

DICOM文件写名称,指定为一个特征向量或字符串标量。

数据类型:字符|字符串

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

产生的元数据dicominfo函数,指定为一个结构。

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

数据类型:字符|字符串

DICOM对应一个唯一标识符IOD的,指定为一个特征向量或字符串标量。

数据类型:字符|字符串

名称-值参数

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

例子:new_file dicomwrite (X。”dcm”, CompressionMode = " JPEG无损”)写的图像数据XDICOM文件new_file.dcm与JPEG无损压缩。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

例子:new_file dicomwrite (X。”dcm”、“CompressionMode”、“JPEG无损”)写的图像数据XDICOM文件new_file.dcm与JPEG无损压缩。

压缩模式存储图像时使用,指定这些选项之一:

  • “没有”

  • “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,并建置规范定义的元数据集必须存在,以及可能的其他元数据的值。

    • dicomwrite完全实现了数量有限的IOD的(二次捕获、计算机断层扫描磁共振)。对于这些碘,dicomwrite验证所需的所有元数据属性存在指定的IOD,如果有必要创建缺失的属性,并指定默认值。此外,dicomwrite删除属性不指定IOD DICOM规范的一部分。这种行为对应的默认值CreateMode名称-值参数,“创造”。如果你正在与DICOM文件的支持碘,设置金宝appCreateMode来“创造”最好的办法是确保您创建的文件符合DICOM规范。

    • 写的iod的DICOM文件dicomwrite不完全支持,使用金宝app“复制”值CreateMode名称-值参数。在这种模式下,dicomwrite将图像数据写到一个文件包括您指定使用的元数据信息输入参数。此选项使您能够将元数据从现有文件相同的形态或碘和使用它来创建一个新的DICOM文件与不同的图像像素数据。如果图像数据是空的,dicomwrite不写与图像相关的元数据属性的新的DICOM文件。

      请注意

      因为dicomwrite没有验证元数据文件副本“复制”模式中,您可以创建一个DICOM文件不符合DICOM标准。例如,文件可能缺少所需的元数据,包含多余的元数据或元数据可能不再对应形态设置用于生成原始图像。当使用“复制”模式,确保你使用的元数据是相同的形态和碘。如果你复制与原始图像,使用dicomuid创建新的独特的系列研究元数据的标识符。看到DICOM IOD第3部分中描述的规范有关适当IOD值的更多信息。

  • 的dicomwrite函数删除元数据属性与“组的长度“在他们的名字写一个新的DICOM文件之前,不管的价值CreateMode名称-值参数。包括组长度属性是容易出错,目前不是推荐的DICOM规范。没有集团的其他软件或设备可以读取DICOM文件长度属性。

版本历史

之前介绍过的R2006a

另请参阅

||||||

主题