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/BR2021bd/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 имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: data = fitsread('tst0012.fits','PixelRegion',{[1 2 100],[1 2 100]})

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

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

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

Описание

start

Стартовая точка в размерности. Точка остановки по умолчанию является концом размерности.

запуск stop]

Запустите и остановите точки в размерности.

запуск increment stop]

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

Пиксельный параметр области допустим только для первичных расширений или расширений изображений.

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

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

Советы

  • Дополнительные сведения см. в cfitsiocopyright.txt файл. Просмотрите этот файл с помощью open функция.

    open cfitsiocopyright.txt

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