healpy.fitsfunc.read_alm

healpy.fitsfunc.read_alm(filename, hdu=1, return_mmax=False)

Read alm from a fits file.

In the fits file, the alm are written with explicit index scheme, index = l**2+l+m+1, while healpix cxx uses index = m*(2*lmax+1-m)/2+l. The conversion is done in this function.

Parameters:
filenamestr or HDUList or HDU or pathlib.Path instance

The name of the fits file to read

hduint, or tuple of int, optional

The header to read. Start at 0. Default: hdu=1

return_mmaxbool, optional

If true, both the alms and mmax is returned in a tuple. Default: return_mmax=False

Returns:
alms[, mmax]complex array or tuple of a complex array and an int

The alms read from the file and optionally mmax read from the file