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

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 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=filenamelen) CHR IN the map(s) is (are) written to a FITS-file with this filename.
extno OPTIONAL 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 Nside=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 alm 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

Eric Hivon 2005-08-31