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.

Version 3.82, 2022-07-28