Exponenta Banner
exponenta event banner

niftiwrite

Запись тома в файл в формате NIfTI

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

Синтаксис

niftiwrite (V, имя файла)
niftiwrite (V, имя файла, информация)
niftiwrite (V, имя файла, информация, имя, значение)

Описание

пример

niftiwrite(V,filename) записывает данные объемного изображения V в файл с использованием формата NIfTI (Neuroimaging Informatics Technology Initiative). По умолчанию niftiwrite создает объединенный файл NIfTI, содержащий метаданные и объемные данные. niftiwrite именует файл filename, добавление .nii расширение файла. niftiwrite заполняет метаданные, используя соответствующие значения по умолчанию и свойства тома, такие как размер и тип данных.

niftiwrite поддерживает оба NIfTI1 и NIfTI2 форматы файлов. NIfTI1 является форматом файла по умолчанию. Запись данных NifTI в NIfTI2 формат, используйте синтаксис с Name,Value аргументы пары. Укажите Version аргумент как 'NIfTI2'.

пример

niftiwrite(V,filename,info) записывает объемные данные V в файл, включая метаданные файла из info. Если метаданные не соответствуют содержимому и размеру изображения, то niftiwrite возвращает ошибку.

niftiwrite(V,filename,info,Name,Value) записывает объемные данные в файл, используя опции, указанные в Name,Value пар.

Примеры

свернуть все

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

Загрузка образа NIfTI с помощью его .nii имя файла.

V = niftiread('brain.nii');

Фильтрация изображения в 3-D с помощью медианного фильтра 3 на 3.

V = medfilt3(V);

Запись отфильтрованного изображения в .nii с использованием значений заголовка по умолчанию.

niftiwrite(V,'outbrain.nii');
Открыть сценарий в реальном времени

Считывание метаданных из файла NIfTI с помощью его .nii имя файла.

info = niftiinfo('brain.nii');

Считывание объемных данных из файла с помощью метаданных файла.

V = niftiread(info);

Изменить Description поле метаданных файла.

info.Description = 'Modified using MATLAB R2017b';

Запись объемных данных с измененными метаданными в новый .nii файл.

niftiwrite(V,'outbrain.nii',info);

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

свернуть все

Имя файла NIfTI, указанного как строковый скалярный или символьный вектор. По умолчанию niftiwrite создает файл комбинированного формата, который содержит метаданные и данные изображения и имеет расширение файла .nii. При указании 'Compressed' пара имя-значение, niftiwrite добавляет расширение файла .nii.gz. Если установить 'Combined' пара имя-значение к false, то niftiwrite создает два файла с одинаковым именем и различными расширениями. Один файл содержит метаданные, связанные с томом, и имеет расширение файла .hdr. Другой файл содержит данные изображения и имеет расширение .img.

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

Объемные данные, указанные как числовой массив.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Метаданные файла, указанные как структура, возвращаемая niftiinfo функция.

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

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

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

Пример: niftiwrite(V,'outbrain.nii','Compressed',true)

Тип создаваемого файла NIfTI, указанный как true или false. Если true (по умолчанию), niftiwrite создает один файл с расширением .nii. Если false, niftiwrite создает пару файлов с тем же именем, но с различными расширениями файлов: .hdr для файла, содержащего метаданные, и .img для файла, содержащего объемные данные.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Сжатие данных изображения, указанных как true или false. Если 'Compressed' является true, то niftiwrite создает сжатые файлы, используя gzip, с расширением имени файла .gz.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Полнота данных, указанных как 'little', для указания формата little-endian (по умолчанию) или 'big', для указания формата big-endian.

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

NIfTI формат данных, указанный как 'NIfTI1' или 'NIfTI2'.

  • Если указано как 'NIfTI1', то niftiwrite записывает входные данные в соответствии с NIfTI1 формат данных.

  • Если указано как 'NIfTI2', то niftiwrite записывает входные данные в соответствии с NIfTI2 формат данных.

  • Если не указано, то значение по умолчанию для 'Version' выбирается на основе максимального размера входных объемных данных.

    • Если максимальная размерность входа меньше или равна 32767, то значение по умолчанию равно NIfTI1.

    • Если максимальный размер входного значения больше 32767, то значение по умолчанию равно NIfTI2.

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

Ссылки

[1] Кокс, Р. В., Дж. Эшбернер, Х. Бреман, К. Фисселл, К. Хасельгроув, К. Дж. Холмс, Дж. Л. Ланкастер, Д. Э. Рекс, С. М. Смит, Дж. Б. Вудворд и С. К. Стротер. «(Вид) новый стандарт формата данных изображения: NiFTI-1». 10-е Годовое собрание Организации Отображения Человеческого мозга, Будапешта, Венгрия, июнь 2004.

См. также

|

Представлен в R2017b

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

Поддержка