dump_alms*

This routine stores $a_{\ell m}$ values in a binary FITS file. The FITS file created will contain one integer column with $index=\ell^2+\ell+m+1$ and 2 single precision columns with real/imaginary $a_{\ell m}$ values. One can store temperature $a_{\ell m}$ or polarisation, $a^E_{\ell m}$ or $a^B_{\ell m}$. If temperature is specified, a FITS file is created. If polarisation is specified, an old FITS file is opened and extra extensions is created.

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

FORMAT

call dump_alms*( filename, alms, nlmax, header, nlheader, extno )

ARGUMENTS

name & dimensionality	kind	in/out	description
filename(LEN=filenamelen)	CHR	IN	filename for the FITS-file to store the $a_{\ell m}$ in.
nlmax	I4B	IN	maximum $\ell$ value to store.
alms(0:nlmax,0:nlmax)	SPC/ DPC	IN	array with $a_{\ell m}$, in the format used by eg. map2alm, so alms(l,m) corresponds to $a_{\ell m}$
extno	I4B	IN	extension number. If 0 is specified, a FITS file is created and $a_{\ell m}$ is stored in the first FITS extension as temperature $a_{\ell m}$. If 1 or 2 is specified, an already existing file is opened and a 2nd or 3rd extension is created, treating $a_{\ell m}$ as $a_{\ell m}^E$ or $a_{\ell m}^B$.
nlheader	I4B	IN	number of header lines to write to the file.
header(LEN=80) (1:nlheader)	CHR	IN	the header to the FITS-file.

EXAMPLE:

call dump_alms ('alms.fits', alms, 64, header, 100, 1)

Opens an already existing FITS file which contains temperature $a_{\ell m}$. An extra extension is added to the file where the $a_{\ell m}$ array are written in a three-column format as described above. 100 header lines are written to the file from the array header(1:80).

MODULES & ROUTINES

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

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 dump_alms*

fits2alms, read_conbintab

routines to read $a_{\ell m}$ from a FITS-file

alms2fits

has the same function as dump_alms* but is more general.