Main Content

fitsinfo

有关 FITS 文件的信息

语法

info = fitsinfo(filename)

说明

info = fitsinfo(filename) 返回结构体 info,该结构体的字段包含有关普适图像传输系统 (FITS) 文件的内容的信息。filename 是一个字符向量或字符串标量,用于指定 FITS 文件的名称。

info 结构体包含以下字段,这些字段以在结构体中的显示顺序列出。此外,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

一个关键字数目×3 的元胞数组,包含每列中标头的关键字、值和注释

字符向量元胞数组

FITS 文件扩展

FITS 文件还可以包含可选扩展。如果该文件包含其中任意扩展,则 info 结构体可以包含这些附加字段。

  • AsciiTable - 表格格式的数值信息,存储为 ASCII 字符

  • BinaryTable - 表格格式的数值信息,以二进制表示形式存储

  • Image - 多维像素数组

  • Unknown - 非标准扩展

AsciiTable 扩展

AsciiTable 结构体包含以下字段,这些字段以在结构体中的显示顺序列出。

字段名称

描述

返回类型

Rows

表中的行数

double

RowSize

每行中的字符数

double

NFields

每行中的字段数

double 数组

FieldFormat

一个 1×NFields 元胞,包含每个字段的编码格式。这些格式为 FORTRAN-77 格式代码。

字符向量元胞数组

FieldPrecision

一个 1×NFields 元胞,包含每个字段中的数据的精度

字符向量元胞数组

FieldWidth

一个 1×NFields 数组,包含每个字段中的字符数

double 数组

FieldPos

一个 1×NFields 数值数组,表示每个字段的起始列

double 数组

DataSize

表中的数据大小(以字节为单位)

double

MissingDataValue

一个 1×NFields 数值数组,用于表示每个字段中的未定义数据

字符向量元胞数组

Intercept

一个 1×NFields 数值数组,与 Slope 一起用于使用以下方程根据数组数据值来计算实际的数据值:actual_value = Slope*array_value+Intercept

double 数组

Slope

一个 1×NFields 数值数组,与 Intercept 一起用于使用以下方程根据数组数据值来计算实际的数据值:actual_value = Slope*array_value+Intercept

double 数组

Offset

从文件开头到表中第一个数据值的位置的字节数

double

Keywords

一个关键字数目×3 的元胞数组,包含 ASCII 表头中的所有关键字、值和注释

字符向量元胞数组

BinaryTable 扩展

BinaryTable 结构体包含以下字段,这些字段以在结构体中的显示顺序列出。

字段名称

描述

返回类型

Rows

表中的行数

double

RowSize

每行中的字节数

double

NFields

每行中的字段数

double

FieldFormat

一个 1×NFields 元胞数组,包含每个字段中的数据的数据类型。数据类型用 FITS 二进制表格格式代码表示。

字符向量元胞数组

FieldPrecision

一个 1×NFields 元胞,包含每个字段中的数据的精度

字符向量元胞数组

FieldSize

一个 1×NFields 数组,其中每个元素包含第 N 个字段中的值的数目

double 数组

DataSize

二进制表中的数据大小(以字节为单位)。包括超出主表的任何数据。

double

MissingDataValue

一个 1×NFields 数值数组,用于表示每个字段中的未定义数据

double 类型的元胞数组

Intercept

一个 1×NFields 数值数组,与 Slope 一起用于使用以下方程根据数组数据值来计算实际的数据值:actual_value = slope*array_value+Intercept

double 数组

Slope

一个 1×NFields 数值数组,与 Intercept 一起用于使用以下方程根据数组数据值来计算实际的数据值:actual_value = Slope*array_value+Intercept

double 数组

Offset

从文件开头到第一个数据值的位置的字节数

double

ExtensionSize

超出主表的任何数据的大小(以字节为单位)

double

ExtensionOffset

从文件开头到超出主表的任何数据的字节数

double

Keywords

一个关键字数目×3 的元胞数组,包含二进制表头中的所有关键字、值和注释

字符向量元胞数组

Image 扩展

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

一个关键字数目×3 的元胞数组,包含二进制表头中的所有关键字、值和注释

字符向量元胞数组

Unknown 结构体

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

一个关键字数目×3 的元胞数组,包含二进制表头中的所有关键字、值和注释

字符向量元胞数组

示例

全部折叠

使用 fitsinfo 获取有关 FITS 文件 tst0012.fits 的信息。返回的结构体包含 FilenameFileModDateFileSizeContentsPrimaryData。除了主要数据以外,该文件还包含 BinaryTableUnknownImageAsciiTable 扩展的示例。

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: {'A9'  'F6.2'  'I3'  'E10.4'  'D20.15'  'A5'  'A1'  'I4'}
      FieldPrecision: {'Char'  'Single'  'Integer'  'Single'  'Double'  'Char'  'Char'  'Integer'}
          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 扩展。例如,通过 FieldWidthFieldPos 字段,您可以确定行中每个字段的长度和位置。

版本历史记录

在 R2006a 之前推出