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 的元胞数组，包含二进制表头中的所有关键字、值和注释	字符向量元胞数组

示例

全部折叠

获取有关 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 字段，您可以确定行中每个字段的长度和位置。