fitsinfo

Информация о файле FITS

Синтаксис

info = fitsinfo(filename)

Описание

info = fitsinfo(filename) возвращает структуру, info, с полями, содержащими информацию о содержимом файла гибкой системы переноса изображений (FITS). filename - символьный вектор или строковый скаляр, указывающий имя файла FITS.

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

Имя поля	Описание	Тип возврата
`Filename`	Имя файла	Символьный вектор
`FileModDate`	Дата изменения файла	Символьный вектор
`FileSize`	Размер файла в байтах	`double`
`Contents`	Список расширений в файле в порядке их появления	Массив ячеек символьных векторов
`PrimaryData`	Информация о первичных данных в файле FITS	Структурный массив

PrimaryData

PrimaryData - это структура, описывающая основные данные в файле. В следующей таблице перечислены поля в порядке их отображения в структуре.

Имя поля	Описание	Тип возврата
`DataType`	Точность данных	Символьный вектор
`Size`	Размер каждого размера. Количество строк соответствует значению ключевого слова NAXIS2, а количество столбцов соответствует значению ключевого слова NAXIS1. Любые дальнейшие размеры соответствуют NAXIS3, NAXIS4 и так далее.	`double` множество
`DataSize`	Размер первичных данных в байтах	`double`
`MissingDataValue`	Значение, используемое для представления неопределенных данных	`double`
`Intercept`	Значение, используемое с `Slope`, чтобы вычислить фактические значения пикселей на основе значений пикселей массива, используя уравнение: `actual_value = Slope*array_value + Intercept`	`double`
`Slope`	Значение, используемое с `Intercept`, чтобы вычислить фактические значения пикселей на основе значений пикселей массива, используя уравнение: `actual_value = Slope*array_value + Intercept`	`double`
`Offset`	Количество байт от начала файла до расположения первого значения данных	`double`
`Keywords`	Массив ячеек number-of-keywords-by-3, содержащий ключевые слова, значения и комментарии заголовка в каждом столбце	Массив ячеек символьных векторов

Расширения файлов FITS

Файл FITS может также содержать дополнительные расширения. Если файл содержит любое из этих расширений, info структура может содержать эти дополнительные поля.

AsciiTable - числовая информация в табличном формате, сохраненная в виде символов ASCII
BinureTable - числовая информация в табличном формате, сохраненная в двоичном представлении
Изображение - многомерный массив пикселей
Неизвестно - нестандартное расширение

Расширение таблицы AsciiTable

AsciiTable содержит следующие поля, перечисленные в порядке их появления в структуре.

Имя поля	Описание	Тип возврата
`Rows`	Количество строк в таблице	`double`
`RowSize`	Количество символов в каждой строке	`double`
`NFields`	Количество полей в каждой строке	`double` множество
`FieldFormat`	A 1-по-`NFields` ячейка, содержащая форматы, в которых кодируется каждое поле. Форматы представляют собой FORTRAN-77 коды форматов.	Массив ячеек символьных векторов
`FieldPrecision`	A 1-по-`NFields` ячейка, содержащая точность данных в каждом поле	Массив ячеек символьных векторов
`FieldWidth`	A 1-по-`NFields` массив, содержащий количество символов в каждом поле	`double` множество
`FieldPos`	A 1-по-`NFields` массив чисел, представляющий начальный столбец для каждого поля	`double` множество
`DataSize`	Размер данных в таблице в байтах	`double`
`MissingDataValue`	A 1-по-`NFields` массив чисел, используемых для представления неопределенных данных в каждом поле	Массив ячеек символьных векторов
`Intercept`	A 1-по-`NFields` массив чисел, используемых вместе с `Slope` для вычисления фактических значений данных по значениям данных массива с использованием уравнения: `actual_value = Slope*array_value+Intercept`	`double` множество
`Slope`	A 1-по-`NFields` массив чисел, используемых с `Intercept` для вычисления истинных значений данных из значений данных массива с помощью уравнения: `actual_value = Slope*array_value+Intercept`	`double` множество
`Offset`	Количество байт от начала файла до расположения первого значения данных в таблице	`double`
`Keywords`	Массив ячеек number-of-keywords-by-3, содержащий все ключевые слова, значения и комментарии в заголовке таблицы ASCII	Массив ячеек символьных векторов

Расширение BinureTable

BinaryTable содержит следующие поля, перечисленные в порядке их появления в структуре.

Имя поля	Описание	Тип возврата
`Rows`	Количество строк в таблице	`double`
`RowSize`	Количество байт в каждой строке	`double`
`NFields`	Количество полей в каждой строке	`double`
`FieldFormat`	A 1-по-`NFields` массив ячеек, содержащий тип данных в каждом поле. Тип данных представлен двоичным кодом формата таблицы FITS.	Массив ячеек символьных векторов
`FieldPrecision`	A 1-по-`NFields` ячейка, содержащая точность данных в каждом поле	Массив ячеек символьных векторов
`FieldSize`	A 1-по-`NFields` массив, где каждый элемент содержит количество значений в N-ом поле	`double` множество
`DataSize`	Размер данных в двоичной таблице, в байтах. Включает все данные за пределами основной таблицы.	`double`
`MissingDataValue`	1-по-`NFields` массив чисел, используемых для представления неопределенных данных в каждом поле	Массив ячеек `double`
`Intercept`	A 1-по-`NFields` массив чисел, используемый вместе с параметром «Уклон» для вычисления фактических значений данных массива по уравнению: `actual_value = slope*array_value+Intercept`	`double` множество
`Slope`	A 1-по-`NFields` массив чисел, используемый с функцией «Перехват» для вычисления истинных значений данных по значениям данных массива с использованием уравнения: `actual_value = Slope*array_value+Intercept`	`double` множество
`Offset`	Количество байт от начала файла до расположения первого значения данных	`double`
`ExtensionSize`	Размер любых данных за пределами основной таблицы, в байтах	`double`
`ExtensionOffset`	Количество байт от начала файла до любых данных за пределами основной таблицы	`double`
`Keywords`	Массив ячеек number-of-keywords-by-3, содержащий все ключевые слова, значения и комментарии в заголовке двоичной таблицы	Массив ячеек символьных векторов

Расширение изображения

Image содержит следующие поля, перечисленные в порядке их появления в структуре.

Имя поля	Описание	Тип возврата
`DataType`	Точность данных	Символьный вектор
`Size`	Размер каждого размера. Количество строк соответствует значению ключевого слова NAXIS2, а количество столбцов соответствует значению ключевого слова NAXIS1. Любые дальнейшие размеры соответствуют NAXIS3, NAXIS4 и так далее.	`double` множество
`DataSize`	Размер данных в расширении Image в байтах	`double`
`Offset`	Число байт от начала файла до первого значения данных	`double`
`MissingDataValue`	Значение, используемое для представления неопределенных данных	`double`
`Intercept`	Значение, используемое с `Slope`, чтобы вычислить фактические значения пикселей на основе значений пикселей массива, используя уравнение: `actual_value = Slope*array_value+Intercept`	`double`
`Slope`	Значение, используемое с `Intercept`, чтобы вычислить фактические значения пикселей на основе значений пикселей массива, используя уравнение: `actual_value = Slope*array_value + Intercept`	`double`
`Keywords`	Массив ячеек number-of-keywords-by-3, содержащий все ключевые слова, значения и комментарии в заголовке двоичной таблицы	Массив ячеек символьных векторов

Неизвестная структура

Unknown содержит следующие поля, перечисленные в порядке их появления в структуре.

Имя поля	Описание	Тип возврата
`DataType`	Точность данных	Символьный вектор
`Size`	Размеры каждого размера	`double` множество
`DataSize`	Размер данных в нестандартных расширениях, в байтах	`double`
`Offset`	Число байт от начала файла до первого значения данных	`double`
`MissingDataValue`	Представление неопределенных данных	`double`
`Intercept`	Значение, используемое с `Slope`, для вычисления фактических значений данных по значениям данных массива, используя уравнение: `actual_value = Slope*array_value+Intercept`	`double`
`Slope`	Значение, используемое с `Intercept`, для вычисления фактических значений данных по значениям данных массива, используя уравнение: `actual_value = Slope*array_value+Intercept`	`double`
`Keywords`	Массив ячеек number-of-keywords-by-3, содержащий все ключевые слова, значения и комментарии в заголовке двоичной таблицы	Массив ячеек символьных векторов

Примеры

свернуть все

Получить информацию о файле FITS

Открыть сценарий в реальном времени

Использовать fitsinfo для получения информации о файле FITS tst0012.fits. Возвращенная структура содержит Filename, FileModDate, FileSize, Contents, и PrimaryData. В дополнение к основным данным, файл также содержит пример расширений BinaryTable, Unknown, Image, и AsciiTable.

S = fitsinfo('tst0012.fits');

Просмотр PrimaryData поле.

S.PrimaryData

ans = struct with fields:
            DataType: 'single'
                Size: [109 102]
            DataSize: 44472
    MissingDataValue: []
           Intercept: 0
               Slope: 1
              Offset: 2880
            Keywords: {25x3 cell}

PrimaryData описывает данные в файле. Например, Size поле указывает, что данные являются матрицей 109 на 102.

Просмотр AsciiTable поле.

S.AsciiTable

ans = struct with fields:
                Rows: 53
             RowSize: 59
             NFields: 8
         FieldFormat: {1x8 cell}
      FieldPrecision: {1x8 cell}
          FieldWidth: [9 6.2000 3 10.4000 20.1500 5 1 4]
            FieldPos: [1 11 18 22 33 54 54 55]
            DataSize: 3127
    MissingDataValue: {'*'  '---.--'  '  *'  []  '*'  '*'  '*'  ''}
           Intercept: [0 0 -70.2000 0 0 0 0 0]
               Slope: [1 1 2.1000 1 1 1 1 1]
              Offset: 103680
            Keywords: {65x3 cell}

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

См. также

fitsdisp | fitsread | fitswrite

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

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