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

Version 3.82, 2022-07-28