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.

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