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- 3 массива, представляющие истинный цвет одно системы координат (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'

Режим Compression, чтобы использовать при хранении изображения, заданного как разделенная запятой пара, состоящая из '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, один файл записан для каждой системы координат в изображении.

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

Передайте синтаксис, заданный как разделенная запятой пара, состоящая из '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 значение как 'ieee-be', затем необходимо задать VR как 'explicit'.

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

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

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

свернуть все

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

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

Поле

Описание

'BadAttribute'

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

'MissingCondition'

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

'MissingData'

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

'SuspectAttribute'

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

Советы

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

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

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

      Примечание

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

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

| | | | | |

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

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