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, где filename задает имя Цифровой Обработки изображений и Коммуникаций в Медицине (DICOM) файл, чтобы создать.

dicomwrite(X,cmap,filename) пишет индексируемое изображение X с палитрой cmap.

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

пример

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

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

Примеры

свернуть все

Скрипт Open 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' 'копировать', dicomwrite не проверяет метаданные, записанные в файл.

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

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

свернуть все

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

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

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

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

Типы данных: 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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

  • 'None'

  • 'JPEG lossless'

  • 'JPEG lossy'

  • 'JPEG2000 lossy'

  • 'JPEG2000 lossless'

  • 'RLE'

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

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

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

Для справки, выбирающей метод создания, смотрите Советы.

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

Порядок байтов файла, заданного как пара, разделенная запятой, состоящая из 'Endian' и 'Little' или 'Big'.

Примечание

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

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

Типы данных: логический

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

Примечание

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

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

Типы данных: логический

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

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

  • 'explicit' — Запишите VR в файл.

Примечание

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

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

Типы данных: логический

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

свернуть все

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

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

Поле

Описание

'BadAttribute'

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

'MissingCondition'

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

'MissingData'

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

'SuspectAttribute'

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

Советы

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

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

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

      Примечание

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

Смотрите также

| | | | | |

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

Документация Image Processing Toolbox
Поддержка