write_bintab*

This routine creates a binary FITS-file from a HEALPix map. The routine can save a temperature map or both temperature and polarisation maps (T,Q,U) to the file.

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

FORMAT

call write_bintab*( map, npix, nmap, header, nlheader, filename[, extno] )

Arguments appearing in italic are optional.

ARGUMENTS

name & dimensionality	kind	in/out	description
map(0:npix-1,1:nmap)	SP/ DP	IN	the map to write to the FITS-file.
npix	I4B/ I8B	IN	Number of pixels in the map.
nmap	I4B	IN	number of maps to be written, 1 for temperature only, and 3 for (T,Q,U).
header(LEN=80) (1:nlheader)	CHR	IN	The header for the FITS-file.
nlheader	I4B	IN	number of header lines to write to the file.
filename(LEN=*)	CHR	IN	the map(s) is (are) written to a FITS-file with this filename.
extno	I4B	IN	extension number in which to write the data (0 based). default:0

EXAMPLE:

call write_bintab (map,12*32**2,3,header,120,'map.fits')

Makes a binary FITS-file called `map.fits' from the HEALPix maps (T,Q,U) in the array map(0:12*32**2-1,1:3). The number of pixels 12*32**2 corresponds to the number of pixels in a $N_{\mathrm{side}}=32$ HEALPix map. The header for the FITS-file is given in the string array header and the number of lines in the header is 120.

MODULES & ROUTINES

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

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

input_map, read_bintab

routines which read a file created by write_bintab*.

map2alm

subroutine which analyse a map and returns the $a_{\ell m}$ coeffecients.

output_map

subroutine which calls write_bintab*

write_bintabh

subroutine to write a large array into a FITS file piece by piece

input_tod*

subroutine to read an arbitrary subsection of a large binary table

write_minimal_header

routine to write minimal FITS header