fitsread

Считайте данные из файла FITS

Синтаксис

data = fitsread(filename) data = fitsread(filename,extname) data = fitsread(filename,extname,index) data = fitsread(filename,Name,Value)

Описание

data = fitsread(filename) считывает первичные данные файла Гибкой системы передачи изображения (FITS). filename задан как вектор символов или строковый скаляр. Функция заменяет неопределенные значения данных на NaN и числовые данные шкал наклоном и значениями прерывания, всегда возвращая значения двойной точности.

data = fitsread(filename,extname) считывает данные из расширения файла FITS, заданного extname.

data = fitsread(filename,extname,index) считывает данные из расширения файла FITS, заданного extname . Если существует больше чем одно из заданных расширений в файле, index задает тот, чтобы читать.

data = fitsread(filename,Name,Value) считывает данные из файла FITS с дополнительными опциями, заданными одним или несколькими Name,Value парные аргументы.

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

filename

Вектор символов или строковый скаляр, задающий имя файла FITS.

extname

Имя массива данных или расширения в файле FITS в виде одного из векторов символов или строковых скаляров в таблице, которая следует. Чтобы определить содержимое FITS, просмотрите Contents поле структуры возвращено fitsinfo.

Массивы данных или расширения

Extname	Описание
`'primary'`	Считайте данные из массива первичных данных.
`'asciitable'`	Считайте данные из расширения ТАБЛИЦЫ ASCII. Возвращаемое значение, `data`, 1D массив ячеек.
`'binarytable'`	Считайте данные из Бинарного Табличного расширения. Возвращаемое значение, `data`, 1D массив ячеек.
`'image'`	Считайте данные из расширения Изображений.
`'unknown'`	Считайте данные из Неизвестного расширения.

index

Числовое значение, задающее, который расширение читать, если больше чем один существует в файле.

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

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

`'info'`	`info` структура возвращена `fitsinfo` определение местоположения данных, чтобы читать. Примечание Используя `info` структура возвращена `fitsinfo` задавать местоположение данных в файле FITS может значительно улучшать производительность, особенно при чтении повторных изображений из файла.
`'PixelRegion'`	Массив ячеек `{rows,cols,...}` определение контуров области подызображений, чтобы читать из файла. Каждая размерность (`rows`, `cols`) вектор индексов на основе 1, учитывая любого как `START`, `[START STOP]`, или `[START INCREMENT STOP]`. Этот параметр допустим только для расширений изображений или первичного.
`'raw'`	Задает тот `fitsread` не должен масштабировать данные, считанные из файла, или заменять неопределенные значения на `NaN`. Данные, считанные из файла, являются тем же классом, как это хранится в файле.
`'TableColumns'`	Вектор индексов на основе 1, задающих столбцы, чтобы читать из расширения таблицы ASCII или Binary. Этот вектор должен содержать уникальные и допустимые индексы в табличные данные, заданные в увеличивающемся порядке. Этот параметр допустим только для ASCII или Бинарных расширений.
`'TableRows'`	Вектор индексов на основе 1, задающих строки, чтобы читать из расширения таблицы ASCII или Binary. Этот вектор должен содержать уникальные и допустимые индексы в табличные данные, заданные в увеличивающемся порядке. Этот параметр допустим только для ASCII или Бинарных расширений.

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

data

Данные возвращены в файл FITS.

Примеры

Считайте первичные данные из файла FITS

data = fitsread('tst0012.fits');

Name        Size             Bytes  Class     Attributes

data      109x102            88944  double

Смотрите доступные расширения, считайте расширение 'изображений' использование extname опция.

info = fitsinfo('tst0012.fits');
 % List of contents, includes any extensions if present.
 disp(info.Contents);
 imageData = fitsread('tst0012.fits','image');

Подпроизведите пятую плоскость расширения 'изображений' 2.

info        = fitsinfo('tst0012.fits');
 rowend      = info.Image.Size(1);
 colend      = info.Image.Size(2);
 primaryData = fitsread('tst0012.fits','image',...
              'Info', info,...
              'PixelRegion',{[1 2 rowend], [1 2 colend], 5 });

Считайте любую строку из таблицы ASCII.

info      = fitsinfo('tst0012.fits');
rowend    = info.AsciiTable.Rows; 
tableData = fitsread('tst0012.fits','asciitable',...
                    'Info',info,...
                    'TableRows',[1:2:rowend]);

Считывайте все данные для первых, вторых и пятых колонн таблицы Binary.

info      = fitsinfo('tst0012.fits');
rowend    = info.BinaryTable.Rows;       
tableData = fitsread('tst0012.fits','binarytable',...
                    'Info',info,...
                    'TableColumns',[1 2 5]);

Больше о

свернуть все

расширение

Файл FITS содержит первичные данные и может опционально содержать любое количество дополнительных компонентов, названных extensions в терминологии FITS.

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

fitsdisp | fitsinfo | fitswrite

Темы

Импорт файлов Гибкой системы передачи изображения (FITS)

Документация