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 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 2003-02-07