fitsread

读取 FITS 文件中的数据

语法

data = fitsread(filename)

data = fitsread(filename,extname)

data = fitsread(filename,extname,index)

data = fitsread(filename,Name,Value)

说明

data = fitsread(filename) 读取普适图像传输系统 (FITS) 文件中的主要数据。filename 指定为字符向量或字符串标量。该函数将未定义的数据值替换为 NaN，根据斜率和截距值来缩放数值数据，并始终返回双精度值。

data = fitsread(filename,extname) 读取 extname 指定的 FITS 文件扩展中的数据。

data = fitsread(filename,extname,index) 读取 extname 指定的 FITS 文件扩展中的数据。如果文件中包含多个指定扩展，则 index 将指定要读取的扩展。

Name,Value 对组参数指定的附加选项读取 FITS 文件中的数据。

输入参数filename用于指定 FITS 文件名的字符向量或字符串标量。

extnameFITS 文件中数据数组或扩展的名称，指定为下表中列出的字符向量或字符串标量之一。要确定 FITS 的内容，请查看 fitsinfo 返回的结构体中的 Contents 字段。

数据数组或扩展

Extname说明'primary'读取主要数据数组中的数据。

'asciitable'读取 ASCII 表扩展中的数据。返回的值 data 为 1 维元胞数组。

'binarytable'读取二进制表扩展中的数据。返回的值 data 为 1 维元胞数组。

'image'读取 Image 扩展中的数据。

'unknown'读取 Unknown 扩展中的数据。

index用于指定要读取的扩展的数值(如果文件中存在多个扩展)。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称，Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数，如 Name1,Value1,...,NameN,ValueN 所示。'info'fitsinfo 返回的 info 结构体，用于指定要读取的数据的位置。

注意

使用 fitsinfo 返回的 info 结构体指定 FITS 文件中的数据的位置，可以显著地提高性能，尤其是在读取文件中的多个图像时。

'PixelRegion'元胞数组 {rows,cols,...}，用于指定要从文件中读取的子图像区域的边界。每个维度 (rows, cols) 都是一个以 START、[START

STOP] 或 [START INCREMENT STOP] 形式提供的 1×基准索引的向量。此参数仅对主要扩展或图像延拓有效。

'raw'指定 fitsread 不应缩放从文件中读取的数据或将未定义的值替换为 NaN。从文件中读取的数据具有相同的类，就像存储在文件中一样。

'TableColumns'包含从 1 开始的索引的向量，用于指定要从 ASCII 或二进制表扩展中读取的列。该向量应包含以递增顺序指定的表数据的唯一有效索引。此参数仅对 ASCII 扩展或二进制扩展有效。

'TableRows'包含 1×基准索引的向量，用于指定要从 ASCII 或二进制表扩展中读取的行。该向量应包含以递增顺序指定的表数据的唯一有效索引。此参数仅对 ASCII 扩展或二进制扩展有效。

输出参数data从 FITS 文件返回的数据。

示例

读取 FITS 文件中的主要数据

data = fitsread('tst0012.fits');

Name Size Bytes Class Attributes

data 109x102 88944 double

检查可用扩展，使用 extname 选项读取“image”扩展。

info = fitsinfo('tst0012.fits');

% List of contents, includes any extensions if present.

disp(info.Contents);

imageData = fitsread('tst0012.fits','image');

对 'image' 扩展的第五个平面×2 进行二次抽样。

info = fitsinfo('tst0012.fits');

rowend = info.Image.Size(1);

colend = info.Image.Size(2);

primaryData = fitsread('tst0012.fits','image',...

'Info', info,...

'PixelRegion',{[1 2 rowend], [1 2 colend], 5 });

隔行读取 ASCII 表中的数据。

info = fitsinfo('tst0012.fits');

rowend = info.AsciiTable.Rows;

tableData = fitsread('tst0012.fits','asciitable',...

'Info',info,...

'TableRows',[1:2:rowend]);

读取二进制表中的第一列、第二列和第五列的所有数据。

info = fitsinfo('tst0012.fits');

rowend = info.BinaryTable.Rows;

tableData = fitsread('tst0012.fits','binarytable',...

'Info',info,...

'TableColumns',[1 2 5]);

详细信息

扩展

FITS 文件包含主要数据，并且可以有选择性地包含任意数目的可选组件(FITS 术语中称为扩展)。

在 R2006a 之前推出