READ_HXRS_4_SPEX [1] $SSW/hxrs/idl/read_hxrs_4_spex.pro
[Previous] [Next]

 NAME:
	READ_HXRS_4_SPEX

 PURPOSE:
       Based on settings, calls read_hxrs_fits to get parameters of interest.
		Used as an interface to Spex.


 CATEGORY:
       SPECTRAL FITTING, SPEX - HXRS

 CALLING SEQUENCE:

 CALLS: ***
	ATIME [1], ATIME [2], CHECKVAR [1], F_DIV, READ_HXRS_FITS [1], READ_HXRS_FITS [2]
	READ_HXRS_FITS [3], checkvar [2], edge_products
 INPUTS:
	Through keywords so you don't have to remember the input order.

 OUTPUTS:
	Through keywords so you don't have to remember the output order.

 KEYWORDS:
        file:	hxrs fits file name to read (input)
        ut:	time in seconds since 1-jan-1979, middle of datapoint,
			dblarr(2,n) (start and end of each interval) (output)
        syarray, nyarray, totyarray: shielded, nonsh and total raw counts/interval
        esyarray, enyarray,etotyarray: uncertainties, i.e. sqrt(yarray(10,N)
        deltat:	accumulation time interval, scalar, in seconds (output)
        slivetime, nlivetime, totlivetime: livetimes per interval for detectors and their total
        edges:	output energy loss bands in keV  fltarr(2,10) (output)
        h0:	primary header (string array) (output)
        h1:	header from first (time) extension (string array) (output)
        error:	if =1, then error reading file.  Otherwise 0. (output)

 CALLED BY:
	HXRS__DEFINE
 PROCEDURE:
	User may explicitly pass the name of a HXRS FITS file;
 	Sample call:
	read_hxrs_fits, file='hxrs_fits:hxrs_23.fits', ut=ut, syarray=syarray

 MODIFICATION HISTORY:
        Adapted from the get_hxrbs_fits routine
	Written by Kim Tolbert (NASA/GSFC), 9-sep-1994.
        Adapted for HXRS by Alan Kiplinger May 2000.
   5-June-2000 Paul Bilodeau, general re-organization, error handling


READ_HXRS_FITS [1] $SSW/hxrs/idl/read_hxrs_fits.pro
[Previous]

 NAME:
	READ_HXRS_FITS

 PURPOSE:
       Reads hxrs fits files into idl, then
       computes counts/sec and live times for shielded and non-shielded
       detectors and effective total livetime for sum of both s. and ns.

 CATEGORY:
       HXRS

 CALLING SEQUENCE:

 CALLS: ***
	FXPAR [1], FXPAR [2], MRDFITS [1], MRDFITS [2], anytim [1], anytim [2], anytim [3]
	anytim [4], anytim [5], edges_hxrs [1], edges_hxrs [2], edges_hxrs [3], printx [1]
	printx [2]
 INPUTS:
	Through keywords so you don't have to remember the input order.

 OUTPUTS:
	Through keywords so you don't have to remember the output order.

 KEYWORDS:
        file:	hxrs fits file name to read (input)
        ut:	time in seconds since 1-jan-1979, middle of datapoint,
		dblarr(2,n) (start and end of each interval) (output)
        syarray, nyarray, totyarray: shielded, nonsh and total raw counts/interval
        esyarray, enyarray,etotyarray: uncertainties, i.e. sqrt(yarray(10,N)
        deltat:	accumulation time interval, scalar, in seconds (output)
        slivetime, nlivetime, totlivetime: livetimes per interval for detectors and their total
        edges:	output energy loss bands in keV  fltarr(2,10) (output)
        h0:	primary header (string array) (output)
        h1:	header from first (time) extension (string array) (output)
        error:	if =1, then error reading file.  Otherwise 0. (output)

 CALLED BY:
	READ_HXRS_4_SPEX [1], READ_HXRS_4_SPEX [2], READ_HXRS_4_SPEX [3]
 PROCEDURE:
	User may explicitly pass the name of a HXRS FITS file;
 	Sample call:
	read_hxrs_fits, file='hxrs_fits:hxrs_23.fits', ut=ut, syarray=syarray

 MODIFICATION HISTORY:
        Adapted from the get_hxrbs_fits routine
	Written by Kim Tolbert (NASA/GSFC), 9-sep-1994.
        Adapted for HXRS by Alan Kiplinger May 2000.
   5-June-2000 Paul Bilodeau, general re-organization, error handling