read_par


This routine reads the `NSIDE', `MAX-LPOL' and `TFIELDS' keywords from a FITS-file. These keywords desribe Nside, maximum l value and number of datasets(maps) for the file. The file could eg. be a HEALPix map or precomputed Plm($ \theta$)


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


FORMAT

call read_par( filename, nside, lmax, tfields )


ARGUMENTS

name&dimensionality kind in/out description
       
filename(LEN=filenamelen) CHR IN filename of the FITS-file.
nside I4B OUT the `NSIDE' keyword from the FITS-header.
lmax I4B OUT the `MAX-LPOL' keyword from the FITS-header.
tfields I4B OUT the `TFIELDS' keyword from the FITS-header.


EXAMPLE:

call read_par('plm_128p.fits', nside, lmax, nhar)

Checks the Nside and maximum l value used for the precomputed Plm($ \theta$) that are stored in the file `plm_128p.fits'. If the file also contains tensor harmonics, nhar is returned with the value 3, otherwise it is 1.

MODULES & ROUTINES

This section lists the modules and routines used by read_par.

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_par


synfast,plmgen
executables that produce FITS-files with keywords relevant to this routine.

Eric Hivon 2003-02-07