read_fits_cut4


This IDL facility reads a cut sky HEALPix map from a FITS file according to the HEALPix convention. The format used for the FITS file follows the one used for Boomerang98 and is adapted from COBE/DMR


Location in HEALPix directory tree: src/idl/fits/read_fits_cut4.pro


FORMAT

IDL> READ_FITS_CUT4 , File, Pixel, Signal [, N_Obs, Serror, HDR=, XHDR=, NSIDE=, ORDERING=, COORDSYS=]


QUALIFIERS


File
name of a FITS file in which the map is to be written

Pixel
(LONG vector),
index of observed (or valid) pixels

Signal
(FLOAT vector),
value of signal in each observed pixel

N_Obs
(LONG or INT vector, Optional),
number of observation per pixel

Serror
(FLOAT vector, Optional),
rms of signal in pixel. For white noise, this is $\propto 1/\sqrt{{\rm n\_obs}}$

HDR =
(optional),
String array containing the primary header.

XHDR =
(optional),
String array containing the extension header.

NSIDE=
(optional),
returns on output the HEALPix resolution parameter, as read from the FITS header. Set to -1 if not found

ORDERING=
(optional),
returns on output the pixel ordering, as read from the FITS header. Either 'RING' or 'NESTED' or ' ' (if not found).

COORDSYS=
(optional),
returns on output the astrophysical coordinate system used, as read from FITS header (value of keywords COORDSYS or SKYCOORD)


DESCRIPTION



RELATED ROUTINES

This section lists the routines related to read_fits_cut4


idl
version 5.0 or more is necessary to run read_fits_cut4
read_fits_map
This HEALPix IDL facility can be used to read in maps written by read_fits_cut4 .
sxaddpar
This IDL routine (included in HEALPix package) can be used to update or add FITS keywords to the header in Prim_stc and Exten_stc

Eric Hivon 2005-08-31