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

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

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

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

свернуть все

DICOM отображают в виде одного из следующих.

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

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

  • m-by-n-by-numChannels-by-numFrames массив, представляющий изображение сверхкадра. numChannels 1 для полутоновых изображений и 3 для изображений истинного цвета.

Примечание

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

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

Палитра сопоставила с индексируемым изображением XВ виде c-by-3 числовая матрица со значениями в области значений [0, 1]. Каждой строкой является трехэлементный триплет RGB, который задает красные, зеленые, и синие компоненты одного цвета палитры.

Типы данных: 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 имя аргумента и 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

Поддержка

Для просмотра документации необходимо авторизоваться на сайте