read_dbintab

This routine reads a double precision binary array from a FITS-file. It is used by HEALPix to read precomputed $P_{\ell m}(\theta)$ values and pixel window functions.

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


FORMAT

call read_dbintab( filename, map, npixtot, nmaps, nullval, anynull, units )


ARGUMENTS

name & dimensionality kind in/out description
       
filename(LEN=filenamelen) CHR IN filename of FITS-file containing the double precision array.
npixtot I4B IN Number of values to be read from the file.
nmaps I4B IN number of 1-dim. arrays, 1 for scalar $P_{\ell m}\!\!$ s and pixel windows, 3 for scalar and tensor $P_{\ell m}\!\!$ s.
map(0:npixtot-1,1:nmaps) DP OUT the array read from the FITS-file.
nullval DP OUT value of missing pixels in the array.
anynull LGT OUT TRUE, if there are missing pixels, and FALSE otherwise.
units(len=20)(1:nmaps) CHR OUT respective physical units of the maps in the FITS file.


EXAMPLE:

call read_dbintab ('plm_32.fits',plm,65*66*32,1,nullval,anynull)
Reads precomputed scalar $P_{\ell m}(\theta)$ from the file `plm_32.fits'. The values are returned in the array plm(0:65*66*32,1:1). The number of values 65*66*32 is the number of precomputed $P_{\ell m}(\theta)$ for a $N_{\mathrm{side}}=32$, $\ell_{\mathrm{max}}=64$ map. If there are missing values in the file, anynull is TRUE and nullval contains the values of these pixels.


MODULES & ROUTINES

This section lists the modules and routines used by read_dbintab.

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_dbintab

plmgen
Executable to create files with precomputed $P_{\ell m}(\theta)$.
write_plm
Routine to create a file to be read by read_dbintab.

Version 3.82, 2022-07-28