matlab.io.fits.readATblHdr

Read header information from current ASCII table

Syntax

[rowlen,nrows,ttype,tbcol,tform,tunit,extname] = matlab.io.fits.readATblHdr(fptr)

Description

[rowlen,nrows,ttype,tbcol,tform,tunit,extname] = matlab.io.fits.readATblHdr(fptr) returns header information for the current ASCII table.

Examples

collapse all

Get Header Information for ASCII Table

Open Live Script

Open a sample FITS file that has an ASCII table in the fifth HDU. Get header information for the table. Then close the sample file.

import matlab.io.*
fptr = fits.openFile("tst0012.fits");
fits.movAbsHDU(fptr,5);
[rowlen,nrows,ttype,tbcol,tform,tunit,extname] = fits.readATblHdr(fptr)

rowlen = 
59

nrows = 
53

ttype = 1×8 cell
    {'IDENT'}    {'Mag'}    {'Channel'}    {'Dist'}    {'Mass'}    {'Class'}    {'Type'}    {'Class_No'}

tbcol = 1×8

     1    11    18    22    33    54    54    55

tform = 1×8 cell
    {'A9'}    {'F6.2'}    {'I3'}    {'E10.4'}    {'D20.15'}    {'A5'}    {'A1'}    {'I4'}

tunit = 1×8 cell
    {0×0 char}    {0×0 char}    {0×0 char}    {'PC'}    {0×0 char}    {0×0 char}    {0×0 char}    {0×0 char}

extname = 
'Asciitable'

fits.closeFile(fptr)

Tips

This function corresponds to the fits_read_atblhdrll (ffghtbll) function in the CFITSIO library C API.
To use this function, you must be familiar with the CFITSIO C interface. You can access the CFITSIO documentation at the CFITSIO website.

Extended Capabilities

expand all

Thread-Based Environment
Run code in the background using MATLAB® `backgroundPool` or accelerate code with Parallel Computing Toolbox™ `ThreadPool`. (since R2026a)

The matlab.io.fits.readATblHdr function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History