Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

matlab.io.fits.readCol

Read rows of ASCII or binary table column

Syntax

[coldata,nullval] = readCol(fptr,colnum)
[coldata,nullval] = readCol(fptr,colnum,firstrow,numrows)

Description

[coldata,nullval] = readCol(fptr,colnum) reads an entire column from an ASCII or binary table column. nullval is a logical array specifying if a particular element of coldata should be treated as undefined. It is the same size as coldata.

[coldata,nullval] = readCol(fptr,colnum,firstrow,numrows) reads a subsection of rows from an ASCII or binary table column.

The MATLAB® data type returned by readCol corresponds to the data type returned by getEqColType.

This function corresponds to the fits_read_col (ffgcv) function in the CFITSIO library C API.

Examples

Read an entire column.

import matlab.io.*
fptr = fits.openFile('tst0012.fits');
fits.movAbsHDU(fptr,2);
colnum = fits.getColName(fptr,'flux');
fluxdata = fits.readCol(fptr,colnum);
fits.closeFile(fptr);

Read the first five rows in a column.

import matlab.io.*
fptr = fits.openFile('tst0012.fits');
fits.movAbsHDU(fptr,2);
colnum = fits.getColName(fptr,'flux');
fluxdata = fits.readCol(fptr,colnum,1,5);
fits.closeFile(fptr);

See Also

Was this topic helpful?