NASA - Jet Propulsion Laboratory
    + View the NASA Portal
Search JPL
Jet Propulsion Laboratory Home Earth Solar System Stars & Galaxies Technology
Introduction Background Software Links


read_fits_s


This IDL facility reads a FITS file into an IDL structure.


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


FORMAT

IDL> READ_FITS_S , File, Prim_stc, [Xten_stc, MERGE=, EXTENSION=]


QUALIFIERS


File
name of a FITS file containing the healpix map(s) in an extension or in the image field

Prim_stc
variable containing on output an IDL structure with the following fields:
- primary header (tag : 0, tag name : HDR)
- primary image (if any, tag : 1, tag name : IMG)

Xten_stc
(optional),
variable containing on output an IDL structure with the following fields:
- extension header (tag : 0, tag name : HDR)
- data column 1 (if any, tag : 1, tag name given by TTYPE1 (with all spaces removed and only letters, digits and underscore)
- data column 2 (if any, tag : 2, tag name given by TTYPE2)
...

EXTENSION=
(optional),
scalar integer containing on input the extension to be read (0 based)
default:0


KEYWORDS


MERGE=
if set Prim_stc contains :
- the concatenated primary and extension header (tag name : HDR)
- primary image (if any, tag name : IMG)
- data column 1 ...
and Exten_stc is set to 0
default:: not set (or set to 0)


DESCRIPTION


read_fits_s reads in any type of FITS file (Image, Binary table or Ascii table) and outputs the data in IDL structures


RELATED ROUTINES

This section lists the routines related to read_fits_s


idl
version 6.1 or more is necessary to run read_fits_s
synfast
This HEALPix facility will generate the FITS format sky map that can be read by read_fits_s .
read_fits_cut4, read_fits_map
read_tqu, read_fits_s
HEALPix IDL routines to read cut-sky maps, full-sky maps, polarized full-sky maps and arbitrary data sets from FITS files
write_fits_sb
This HEALPix IDL facility can be used to generate FITS format sky maps readable by read_fits_s .


EXAMPLE:

read_fits_s , 'dmr_skymap_90a_4yr.fits', pdata, xdata

read_fits_s reads in the file 'dmr_skymap_90a_4yr.fits'. On output, pdata contains the primary header and xdata is a structure whose first field is the extension header, and the other fields are vectors with respective tag names PIXEL, SIGNAL, N_OBS, SERROR, ... (see help,/struc,xdata)

Eric Hivon 2010-06-18
Privacy / Copyright
FIRST GOV Contact: NASA Home Page Site Manager:
Webmaster:

CL 03-2650