input_tod*

This routine reads a large binary table (for instance a Time Ordered Data set) from a FITS file. The user can choose to read only a section of the table, starting from an arbitrary position. The data can be read into a single or double precision array.

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


FORMAT

call input_tod*( filename, tod, npix, ntods[, header, firstpix, fmissval] )

Arguments appearing in italic are optional.


ARGUMENTS

name & dimensionality kind in/out description
       
filename(LEN=filenamelen) CHR IN FITS file to be read from
tod(0:npix-1,1:ntods) SP/ DP OUT array constructed from the data present in the file (from the sample firstpix to firstpix + npix - 1. Missing pixels or time samples are filled with fmissval.
npix I8B IN number of pixels or samples to be read. See Note below.
ntods I4B IN number of columns to read
header(LEN=80)(1:) CHR OUT FITS extension header
firstpix I8B IN first pixel (or time sample) to read from (0 based). default:0. See Note below.
fmissval SP/ DP IN value to be given to missing pixels, its default value is 0. Should be of the same type as tod.
Note : Indices and number of data elements larger than $2^{31}$ are only accessible in FITS files on computers with 64 bit enabled compilers and with some specific compilation options of cfitsio (see cfitsio documentation).


MODULES & ROUTINES

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

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

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.
write_bintabh
subroutine to write large arrays into FITS files
output_map
subroutine to write a FITS file from a HEALPix map
input_map
subroutine to read a HEALPix map (either full sky of cut sky) from a FITS file

Version 3.82, 2022-07-28