This routine reads a FITS file containing a_lm values for constained realisation. The FITS file is supposed to contain one integer column with index=l²+l+m+1 and 2 or 4 single (or double) precision columns with real/imaginary a_lm values and real/imaginary standard deviation on these a_lm. It is supposed to contain either 1 or 3 extension(s) containing respectively the a_lm for T and if applicable E and B.

Location in HEALPix directory tree: src/f90/mod/fitstools.f90

FORMAT

call read_conbintab*( filename, alms, nalms [, units, extno] )

ARGUMENTS

name&dimensionality	kind	in/out	description

filename(LEN=`filenamelen`)	CHR	IN	filename of FITS file containing a_lm.
nalms	I4B	IN	Number of a_lm values to read from the file.
alms(0:nalms-1,1:6)	SP/ DP	OUT	the a_lm read from the file. alms(i,1) and alms(i,2) contain the l and m values for the ith a_lm . alms(i,3) and alms(i,4) contain the real and imaginary value of the ith a_lm . Finally, the standard deviation for the ith a_lm is contained in alms(i,5) (real) and alms(i,6) (imaginary).
units(len=20)(1:) (OPTIONAL)	CHR	OUT	character string containing the units of the a_lm
extno (OPTIONAL)	I4B	IN	extension (0 based) of the FITS file to be read

EXAMPLE:

call read_conbintab ('alms.fits',alms,65*66/2)

Read 65*66/2 (the number of a_lm needed to fill the whole range from l=0 to l=64) a_lm values from the file `alms.fits' into the array alms(0:65*66/2-1,1:6).

MODULES & ROUTINES

This section lists the modules and routines used by read_conbintab*.

fitstools: module, containing:
printerror: routine for printing FITS error messages.
cfitsio: library for FITS file handling.

RELATED ROUTINES

This section lists the routines related to read_conbintab*

alms2fits, dump_alms: routines to write a_lm to a FITS-file
fits2alms: has the same function as read_conbintab but is more general.
number_of_alms,[getsize_fits: can be used to find out the number of a_lm available in the file.

Eric Hivon 2010-06-18

Contact:

Site Manager:
Webmaster:
CL 03-2650