Exponenta Banner
exponenta event banner

dicomwrite

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

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

Синтаксис

dicomwrite (X, имя файла)
dicomwrite (X, cmap, имя файла)
dicomwrite (___, meta _ struct)
dicomwrite (___, информация)
dicomwrite (___, «ObjectType», IOD)
dicomwrite (___, «SOPClassUID», UID)
dicomwrite (___, имя, значение)
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, входит в состав программного обеспечения Toolbox™ обработки изображений. Заключите каждое имя атрибута в кавычки.

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

Примеры

свернуть все

Открыть сценарий в реальном времени

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

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

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

dicomwrite(X, 'sc_file.dcm');

Запишите изображение КТ 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, указанный как один из следующих.

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

  • 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

Дополнительные метаданные или параметры файла, указанные как структура. Имена полей в 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 возвращает пустую матрицу ([]).

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

Область

Описание

'BadAttribute'

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

'MissingCondition'

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

'MissingData'

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

'SuspectAttribute'

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

Совет

  • Спецификация формата DICOM содержит несколько определений информационных объектов (IOD), которые могут быть созданы. Эти ИОД соответствуют изображениям и метаданным, полученным в различных реальных условиях (например, МР, рентген, ультразвук и т.д.). Для каждого типа 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

Документация по инструментам обработки изображений

Поддержка