read_conbintab


This routine reads a FITS file containing alm values for constained realisation. The FITS file is supposed to contain one integer column with index = l2 + l + m + 1 and 2 or 4 single precision columns with real/imaginary alm values and real/imaginary standard deviation on these alm.


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


FORMAT

call read_conbintab( filename,alms,nalms )


ARGUMENTS

name&dimensionality kind in/out description
       
filename(LEN=filenamelen) CHR IN filename of FITS-file containing alm.
nalms I4B IN Number of alm values to read from the file.
alms(0:nalms-1,1:6) SP OUT the alm read from the file. alms(i,1) and alms(i,2) contain the l and m values for the ith alm . alms(i,3) and alms(i,4) contain the real and imaginary value of the ith alm . Finally, the standard deviation for the ith alm is contained in alms(i,5) (real) and alms(i,6) (imaginary).


EXAMPLE:

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

Read 65*66/2 (the number of alm needed to fill the whole range from l=0 to l=64) alm 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 alm to a FITS-file
fits2alms
has the same function as read_conbintab but is more general.

Eric Hivon 2003-02-07