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
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)
...
-
Columns=
- (optional),
list of columns to be read from a binary table
can be a list of integer (1 based) indexing the columns positions
or a list of names matching the TTYPE* of the columns
by default, all columns are read
-
Extension=
- (optional),
extension unit to be read from FITS file:
either its 0-based ID number (ie, 0 for first extension after primary array)
or the case-insensitive value of its EXTNAME keyword.
default:0
KEYWORDS
-
/HELP
- if set, an extensive help is displayed and no
file is read
-
/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.4 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 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)
Version 3.30, 2015-10-08