fitsread

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

Описание

пример

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

пример

data = fitsread(filename,'raw') считывает первичные данные файла FITS без корректировки. Этот синтаксис не масштабирует данные, считанные из файла, заменяет неопределенные значения на NaN. Возвращенные данные поддерживают тип класса, заданный в файле.

пример

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

пример

data = fitsread(filename,extname,index) также задает индекс, когда существует несколько одинаковых типов расширений.

пример

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

Примеры

свернуть все

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

data = fitsread('tst0012.fits');

Исследуйте переменный выход data.

whos data
  Name        Size             Bytes  Class     Attributes

  data      109x102            88944  double              

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

data = fitsread('tst0012.fits', 'raw');

Исследуйте переменный выход data.

whos data
  Name        Size             Bytes  Class     Attributes

  data      109x102            44472  single              

Исследуйте расширения файла FITS и считайте данные с расширения изображения.

Перечислите содержимое файла FITS, включая любые расширения, если они имеются.

info = fitsinfo('tst0012.fits');
disp(info.Contents);
  Columns 1 through 4

    {'Primary'}    {'Binary Table'}    {'Unknown'}    {'Image'}

  Column 5

    {'ASCII Table'}

Считайте данные с расширения изображения файла FITS.

imageData = fitsread('tst0012.fits','image');

Считайте подвыборку данных из файла FITS.

Сначала получите информацию о файле FITS.

info = fitsinfo('tst0012.fits')
info = struct with fields:
       Filename: '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/tst0012.fits'
    FileModDate: '12-Mar-2001 18:37:46'
       FileSize: 109440
       Contents: {1x5 cell}
    PrimaryData: [1x1 struct]
    BinaryTable: [1x1 struct]
        Unknown: [1x1 struct]
          Image: [1x1 struct]
     AsciiTable: [1x1 struct]

Запросите размеры каждой размерности расширения изображения.

info.Image.Size
ans = 1×3

    31    73     5

Сохраните размеры строк и столбцов.

rowend = info.Image.Size(1);
colend = info.Image.Size(2);

Прочтите каждую другую строку и столбец из пятого элемента третьей размерности файла FITS.

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

Считывайте каждую другую строку из таблицы ASCII файла FITS.

Определите количество строк в таблице ASCII.

info = fitsinfo('tst0012.fits');
rowend = info.AsciiTable.Rows;

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

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

Считайте все данные для первого, второго и пятого столбцов двоичной таблицы файла FITS.

Определите количество строк в двоичной таблице.

info      = fitsinfo('tst0012.fits');
rowend    = info.BinaryTable.Rows;

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

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

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

свернуть все

Имя файла, заданное как вектор символов или строковый скаляр.

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

Extname

Описание

'primary'

Считайте данные из первичного массива данных.

'asciitable'

Считайте данные из расширения таблицы ASCII как одномерный массив ячеек.

'binarytable'

Считайте данные из бинарного расширения таблицы как одномерный массив ячеек.

'image'

Считайте данные с расширения изображения.

'unknown'

Считайте данные с неизвестного расширения.

Индекс, заданный как скаляр, указывающий, какое расширение считать, если существует несколько расширений одного типа.

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

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

Информация, заданная как массив структур, задающий местоположение считываемых данных. Массив структур может быть получен посредством fitsinfo. Определение Info может значительно повысить эффективность, особенно при считывании нескольких изображений из файла.

Пиксельная область, заданная как массив ячеек из векторов. Каждый вектор соответствует размерности данных. Чтобы задать субрегион, который будет считываться из Nth- размерности, используйте вектор Nth в массиве ячеек. Каждый вектор в массиве ячеек должен быть отформатирован как один из следующих.

Векторный формат

Описание

start

Начальная точка внутри размерности. Остановочной точкой по умолчанию является конец размерности.

[start stop]

Начальная и стоповая точки внутри размерности.

[start increment stop]

Начальная и стоповая точки размерности и шаг, на который нужно считать.

Параметр pixel region действителен только для основного или расширений изображений.

Считываемые столбцы, заданные как одномерный массив, содержащий индексы столбцов для чтения из расширения ASCII или двоичной таблицы. Вектор должен содержать уникальные и действительные индексы в данных таблицы, заданных в порядке увеличения. Этот параметр действителен только для ASCII или двоичных расширений.

Строки для чтения, заданные как одномерный массив, содержащий индексы строк для чтения из расширения ASCII или двоичной таблицы. Вектор должен содержать уникальные и действительные индексы в данных таблицы, заданных в порядке увеличения. Этот параметр действителен только для ASCII или двоичных расширений.

Ссылки

Информацию об авторских правах см. в cfitsiocopyright.txt файл. Просмотр этого файла с помощью open функция.

open cfitsiocopyright.txt

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