read_fits_partial

This IDL facility reads FITS file containing incomplete (polarized) sky map.

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

FORMAT

IDL> READ_FITS_PARTIAL, File, Pixel, IQU[, COORDSYS=, EXTENSION=, HDR=, HELP=, NSIDE=, ORDERING=, UNITS=, XHDR=]

QUALIFIERS

File

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

Pixel

(OUT: INT, LONG or LONG64 vector of length $n_{\rm p}$),
index of observed (or valid) pixels

IQU

(OUT: FLOAT or DOUBLE array of size ($n_{\rm p}$, $n_{\rm c}$)),
value of I or I,Q,U signal in each observed pixel

KEYWORDS

COORDSYS=

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

EXTENSION=

(IN, optional),
0 based number of extension to read. default:0

HDR=

(OUT, optional),
String array containing the primary header.

HELP=

(IN, optional),
if set, an extensive help is displayed, and no file is read

NSIDE=

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

ORDERING=

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

UNITS=

(OUT, optional),
physical units of each column of the table (except PIXEL)

XHDR=

(OUT, optional),
String array containing the extension header.

DESCRIPTION

For more information on the FITS file format supported in HEALPix, including the one implemented in read_fits_partial, see https://healpix.sourceforge.io/data/examples/healpix_fits_specs.pdf

RELATED ROUTINES

This section lists the routines related to read_fits_partial

idl

version 6.4 or more is necessary to run read_fits_partial

write_fits_partial

This HEALPix IDL facility can be used to generate the FITS format partial maps complient with HEALPix convention and readable by read_fits_partial.

read_fits_cut4, read_fits_partial, read_fits_map

read_tqu, read_fits_s

HEALPix IDL routines to read cut-sky maps and partial maps, full-sky maps, polarized full-sky maps and arbitrary data sets from FITS files

sxpar

This IDL routine (included in HEALPix package) can be used to extract FITS keywords from the header(s) HDR or XHDR read with read_fits_partial.