Main Content

matlab.io.fits.createImg

创建 FITS 图像

语法

createImg(fptr,bitpix,naxes)

说明

createImg(fptr,bitpix,naxes) 使用指定数据类型 bitpix 和大小 naxes 创建新的主图像或图像延拓。如果 FITS 当前为空,则会创建主数组;否则,会向文件追加新图像延拓。

naxes 的前两个元素对应于 NAXIS2 和 NAXIS1 关键字,其他所有元素则对应于 NAXIS3, NAXIS4 ...NAXISn 关键字。

将数据类型 bitpix 指定为包含 CFITSIO 名称或对应 MATLAB® 数据类型的字符向量或字符串标量。

'byte_img''uint8'
'short_img''int16'
'long_img''int32'
'longlong_img''int64'
'float_img''single'
'double_img''double'

此函数对应于 CFITSIO 库 C API 中的 fits_create_imgll(ffcrimll) 函数。

示例

在新 FITS 文件中创建两个图像。第一个图像为 100 行(NAXIS2 关键字)、200 列(NAXIS1 关键字),第二个图像为 256 行(NAXIS2 关键字)、512 列(NAXIS1 关键字)、3 个平面(NAXIS3 关键字)。

import matlab.io.*
fptr = fits.createFile('myfile.fits');
fits.createImg(fptr,'int16',[100 200]);
fits.createImg(fptr,'byte_img',[256 512 3]);
fits.closeFile(fptr);
fitsdisp('myfile.fits');