Exponenta Banner
exponenta event banner

fitsread

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

свернуть все на странице

Синтаксис

data = fitsread (имя файла)
data = fitsread (имя файла, «raw»)
data = fitsread (имя файла, внешнее имя)
data = fitsread (имя файла, внешнее имя, индекс)
data = fitsread (имя файла,..., имя, значение)

Описание

пример

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

пример

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

пример

data = fitsread(filename,extname) считывает данные из расширения файла FITS, указанного extname. Файл FITS содержит основные данные и может дополнительно содержать любое количество необязательных компонентов, называемых расширениями в терминологии 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 содержит основные данные и может дополнительно содержать любое количество необязательных компонентов, называемых расширениями в терминологии FITS. Чтобы определить содержимое файла FITS, просмотрите Contents поле структуры, возвращенное fitsinfo.

Extname

Описание

'primary'

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

'asciitable'

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

'binarytable'

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

'image'

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

'unknown'

Считывание данных с неизвестного внутреннего абонента.

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

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

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

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

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

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

Описание

start

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

[start stop]

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

[start increment stop]

Начальная и конечная точки размера, а также приращение, на которое производится считывание.

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

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

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

Ссылки

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

open cfitsiocopyright.txt

См. также

| |

Темы

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

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

Поддержка