dump_alms*


This routine stores alm values in a binary FITS file. The FITS file created will contain one integer column with index=l2+l+m+1 and 2 single precision columns with real/imaginary alm values. One can store temperature alm or polarisation, aElm or aBlm. 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 alm in.
nlmax I4B IN maximum l value to store.
alms(0:nlmax,0:nlmax) SPC/ DPC IN array with alm, in the format used by eg. map2alm, so alms(l,m) corresponds to alm
extno I4B IN extension number. If 0 is specified, a FITS file is created and alm is stored in the first FITS extension as temperature alm. If 1 or 2 is specified, an already existing file is opened and a 2nd or 3rd extension is created, treating alm as almE or almB.
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 alm. An extra extension is added to the file where the alm 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 alm from a FITS-file
alms2fits
has the same function as dump_alms* but is more general.

Version 3.31, 2017-01-06