input_map


This routine reads a HEALPix map from a FITS file. This can deal with full sky as well as cut sky maps


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


FORMAT

call input_map( filename, map, npixtot, nmaps [, fmissval, header, units, extno] )


ARGUMENTS

name&dimensionality kind in/out description
       
filename(LEN=filenamelen) CHR IN FITS file to be read from, containing a full sky or cut sky map
map(0:npixtot-1,1:nmaps) SP OUT full sky map(s) constructed from the data present in the file, missing pixels are filled with fmissval
npixtot I4B IN number of pixels in the full sky map
nmaps I4B IN number of maps in the file
fmissval (OPTIONAL) SP IN value to be given to missing pixels, its default value is 0
header(LEN=80)(1:) (OPTIONAL) CHR OUT FITS extension header
units(LEN=20)(1:nmaps) (OPTIONAL) CHR OUT maps units
extno (OPTIONAL) I4B IN extension number to read the data from (0 based).default:0 (the first extension is read)


MODULES & ROUTINES

This section lists the modules and routines used by input_map.

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 input_map


anafast
executable that reads a HEALPix map and analyses it.
synfast
executable that generate full sky HEALPix maps
getsize_fits
subroutine to know the size of a FITS file.
output_map
subroutine to write a FITS file from a HEALPix map
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