Exponenta Banner

dicomwrite

Запись изображений в файлы DICOM

Свернуть все на странице

Синтаксис

dicomwrite(X,filename)
dicomwrite(X,cmap,filename)
dicomwrite(___,meta_struct)
dicomwrite(___,info)
dicomwrite(___,'ObjectType',IOD)
dicomwrite(___,'SOPClassUID',UID)
dicomwrite(___,Name,Value)
status = dicomwrite(___)

Описание

dicomwrite(X,filename) записывает двоичное, полутоновое или труколорное изображение X в файл filename. dicomwrite создает файл Digital Imaging and Communications in Medicine (DICOM) или файл Digital Imaging and Communication in Security (DICOS).

dicomwrite(X,cmap,filename) записывает индексированное изображение X с цветовой картой cmap.

dicomwrite(___,meta_struct) задает дополнительные метаданные или опции файла в структуре meta_struct. Имена полей в meta_struct должны быть именами атрибутов или опций файла DICOM. Значение поля является значением, которое вы хотите назначить атрибуту или опции.

пример

dicomwrite(___,info) задает метаданные в структуре метаданных info, который производится dicominfo функция.

dicomwrite(___,'ObjectType',IOD) записывает файл, содержащий необходимые метаданные для конкретного типа информационного объекта DICOM (IOD). Для поддерживаемых IOD, dicomwrite проверяет наличие всех необходимых атрибутов метаданных, при необходимости создает отсутствующие атрибуты и по возможности задает значения по умолчанию. Использование этих поддерживаемых IOD является лучшим способом убедиться, что созданные файлы соответствуют спецификации DICOM. Для получения дополнительной информации см. советы».

dicomwrite(___,'SOPClassUID',UID) записывает файл, содержащий необходимые метаданные для определенного типа IOD, заданные с помощью уникального идентификатора DICOM (UID).

dicomwrite(___,Name,Value) записывает в файл DICOM с помощью Name,Value пар, чтобы повлиять на то, как файл записан. Можно задать несколько пары "имя-значение".

Можно также использовать Name,Value пар, чтобы задать дополнительные метаданные для записи в файл DICOM. Чтобы найти список атрибутов DICOM, которые можно задать, смотрите файл словаря данных, dicom-dict.txt, в комплекте с программным обеспечением Image Processing Toolbox™. Заключайте каждое имя атрибута в кавычки.

status = dicomwrite(___) возвращает информацию о метаданных и описаниях, используемых для генерации файла DICOM. Этот синтаксис может быть полезен, когда вы задаете info структура к dicomwrite функция.

Примеры

свернуть все

Открыть Live Script

Считайте изображение CT из выборки файла DICOM, включенного в тулбокс.

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

Запишите изображение CT в файл, создав дополнительное изображение для захвата.

dicomwrite(X, 'sc_file.dcm');

Запишите изображение CT X в файл DICOM вместе с его метаданными. Используйте dicominfo функция для извлечения метаданных из файла DICOM.

metadata = dicominfo('CT-MONO2-16-ankle.dcm');
dicomwrite(X, 'ct_file.dcm', metadata);

Скопируйте все метаданные из одного файла в другой. Когда вы устанавливаете параметр 'CreateMode' на 'copy', dicomwrite не проверяет метаданные, записанные в файл.

dicomwrite(X, 'ct_copy.dcm', metadata, 'CreateMode', 'copy');

Входные параметры

свернуть все

Изображение DICOM, заданное как одно из следующих.

  • A m -by- n матрица, представляющая однокадровое полутоновое изображение или индексированное изображение

  • A m -by- nмассив -by-3, представляющий изображение truecolor (RGB) с одним кадром

  • Массив 4-D, представляющий мультикадровое изображение.

Примечание

Если входной параметр X пуст, тогда dicomwrite функция запишет файл DICOM с пустыми данными об изображениях. Атрибуты метаданных для файла DICOM либо устанавливаются на значения по умолчанию, либо копируются из meta_struct если 'CreateMode' является 'Copy'.

Типы данных: int8 | int16 | uint8 | uint16

Карта цвета связана с индексированным изображением X, заданный как c -by-3 матрица. В карте цветов c цвета, каждый из которых представлен красным, зеленым и синим значением пикселя .

Типы данных: double

Имя файла DICOM для записи, заданное как вектор символов или строковый скаляр.

Типы данных: char | string

Необязательные метаданные или опции файла, заданные как struct. Имена полей в meta_struct должны быть именами атрибутов или опций файла DICOM. Значение поля является значением, которое вы хотите назначить атрибуту или опции.

Метаданные, произведенные dicominfo функция, заданная как структура.

Информационный объект DICOM, заданный как 'Secondary Capture Image Storage', 'CT Image Storage', или 'MR Image Storage'.

Типы данных: char | string

Уникальный идентификатор DICOM, соответствующий IOD, заданный как вектор символов или строковый скаляр.

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'CompressionMode', 'JPEG lossless'

Режим сжатия для использования при хранении изображения, заданный как разделенная разделенными запятой парами, состоящая из 'CompressionMode' и одно из следующих.

  • 'None'

  • 'JPEG lossless'

  • 'JPEG lossy'

  • 'JPEG2000 lossy'

  • 'JPEG2000 lossless'

  • 'RLE'

Метод, используемый для создания данных для помещения в новый файл, заданный как разделенная разделенными запятой парами, состоящая из 'CreateMode' и одно из следующих.

  • 'Create' - Проверьте входные значения и сгенерируйте отсутствующие значения данных.

  • 'Copy' - Скопируйте все значения из входов и не генерируйте отсутствующие значения.

Для получения справки по выбору метода создания смотрите Советы.

Имя словаря данных DICOM, заданное как разделенная разделенными запятой парами, состоящая из 'Dictionary' и вектор символов или строковый скаляр. Файл по умолчанию dicom-dict.mat.

Упорядоченное расположение байтов файла, заданный как разделенная разделенными запятой парами, состоящая из 'Endian' и 'ieee-le' или 'ieee-be'.

Примечание

Если VR установлено в 'Implicit', затем Endian должен быть 'ieee-le'. dicomwrite игнорирует это значение, если CompressionMode или TransferSyntax задан.

Запись многоадресного изображения в один файл, заданная как разделенная разделенными запятой парами, состоящая из 'MultiframeSingleFile' и true или false. Когда true, один файл создается независимо от того, сколько систем координат X содержит. Когда falseодин файл записывается для каждой системы координат в изображении.

Типы данных: logical

Синтаксис передачи, заданный как разделенная разделенными запятой парами, состоящая из 'TransferSyntax' и вектор символов или строковый скаляр. TransferSyntax UID, который кодирует значения для Endian, VR, и CompressionMode опции.

Примечание

Если вы задаете синтаксис передачи, то dicomwrite игнорирует все значения, заданные для Endian, VR, и CompressionMode опции.

Сохраните значения метаданных 'BitStored', 'BitsAllocated', и 'HighBit', заданная как разделенная разделенными запятой парами, состоящая из 'UseMetadataBitDepths' и false или true. Когда true, dicomwrite сохраняет существующие значения. Когда false (по умолчанию), dicomwrite вычисляет эти значения на основе типа данных пиксельных данных. Когда CreateMode является 'Create', dicomwrite игнорирует это поле.

Типы данных: logical

Напишите в файл код представления двухбуквенного значения (VR), заданный как разделенная разделенными запятой парами, состоящая из 'VR' и одно из следующих.

  • 'implicit' - Вывод из словаря данных.

  • 'explicit' - Запись VR в файл.

Примечание

Если вы задаете Endian значение как 'ieee-be', затем необходимо указать VR как 'explicit'.

Запись частных данных в файл, заданная как разделенная разделенными запятой парами, состоящая из 'WritePrivate' и false или true.

Типы данных: logical

Выходные аргументы

свернуть все

Статус атрибутов, возвращенный как структура. status содержит информацию о метаданных и описаниях, используемых для генерации файла DICOM. Если метаданные не заданы, dicomwrite возвращает пустую матрицу ([]).

The status структура содержит эти поля.

Область

Описание

'BadAttribute'

Внутреннее описание атрибута плохое. Возможно, он отсутствует в словаре данных или имеет неправильные данные в его описании.

'MissingCondition'

Атрибут является условным, но не было предусмотрено условие, когда его использовать.

'MissingData'

Данные для атрибута, который должен находиться в файле, не были предоставлены.

'SuspectAttribute'

Данные в атрибуте не совпадают со списком перечисленных значений в спецификации DICOM.

Совет

  • В спецификации формата DICOM перечислены несколько определений информационных объектов (IOD), которые могут быть созданы. Эти IOD соответствуют изображениям и метаданным, полученным различными реальными модальностями (для примера, MR, рентгеновского, ультразвука и т.д.). Для каждого типа IOD спецификация DICOM определяет набор метаданных, которые должны присутствовать, и возможные значения для других метаданных.

    • dicomwrite полностью реализует ограниченное количество IODs. Для этих IOD, dicomwrite проверяет наличие всех необходимых атрибутов метаданных, при необходимости создает отсутствующие атрибуты и по возможности задает значения по умолчанию. Использование этих поддерживаемых IOD является лучшим способом убедиться, что созданные файлы соответствуют спецификации DICOM. Это dicomwrite поведение по умолчанию и соответствует CreateMode значение опции 'Create'.

    • Запись файлов DICOM для IOD, которые dicomwrite не реализует, используйте 'Copy' значение для CreateMode опция. В этом режиме dicomwrite записывает данные изображения в файл, включая метаданные, которые вы задаете в качестве параметра, показанные выше в info синтаксис. Цель этой опции состоит в том, чтобы взять метаданные из существующего файла той же модальности или IOD и использовать его, чтобы создать новый файл DICOM с различными пиксельными данными изображения. Если данные изображения пусты, dicomwrite не записывает атрибуты метаданных, связанных с изображением, в новый файл DICOM.

      Примечание

      Потому что dicomwrite копирует метаданные в файл без верификации в 'Copy' можно создать файл DICOM, который не соответствует стандарту DICOM. Для примера в файле могут отсутствовать требуемые метаданные, содержаться лишние метаданные или метаданные могут больше не соответствовать настройкам режима, используемым для генерации оригинального изображения. При использовании 'Copy' убедитесь, что метаданные, которые вы используете, от той же модальности и IOD. Если созданная вами копия не связана с оригинальным изображением, используйте dicomuid создание новых уникальных идентификаторов для последовательных и исследуемых метаданных. Для получения дополнительной информации о соответствующих значениях IOD см. описание IOD в Части 3 спецификации DICOM.

См. также

| | | | | |

Темы

Представлено до R2006a

Документация по Image Processing Toolbox

Поддержка