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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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)

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