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.movRelHDU

Move relative number of HDUs from current HDU

Syntax

htype = moveRelHDU(fptr,nmove)

Description

htype = moveRelHDU(fptr,nmove) moves a relative number of HDUs forward or backward from the current HDU and returns the HDU type, htype, of the resulting HDU. The possible values for htype are:

'IMAGE_HDU'
'ASCII_TBL'
'BINARY_TBL'

This function corresponds to the fits_movrel_hdu (ffmrhd) function in the CFITSIO library C API.

Examples

Move through each HDU in succession, then move backwards twice by two HDUs.

import matlab.io.*
fptr = fits.openFile('tst0012.fits');
n = fits.getNumHDUs(fptr);
for j = 1:n
    htype = fits.movAbsHDU(fptr,j);
    fprintf('HDU %d:  "%s"\n',j,htype);
end
htype = fits.movRelHDU(fptr,-2);
n = fits.getHDUnum(fptr);
fprintf('HDU %d:  "%s"\n',n,htype);
htype = fits.movRelHDU(fptr,-2);
n = fits.getHDUnum(fptr);
fprintf('HDU %d:  "%s"\n',n,htype);
fits.closeFile(fptr);
Was this topic helpful?