NAME

hsi_rqe - apply hsi relative quantum efficiency factor


VERSION

hsi_rqe D19980821


PARAMETERS

hsi_rqe uses an IRAF-compatible parameter interface. A template parameter file is in /proj/axaf/simul/lib/uparm/hsi_rqe.par.

input

The input bpipe ray stream to process. If it is the string stdin, it reads from the UNIX standard input stream.

output

the destination for the output rays. if it is the string stdout, it writes to the UNIX standard output stream. It writes bpipe formatted rays.

logfile

The name of the log file to be used.

rqe_file

The /rdb table containing the relative quantum efficiency. The rays must be monochromatic with energy consistent with that of the rqe table.

pore_theta

Angle of the pore axis from the vertical (in degrees).

pore_phi

Angle (in degrees) of the pore axis from the from the +X axis (saotrace coordinates); the +Y axis is at +90 degrees.

debug

A list of debug flags. The presently supported flags are:

log_bad_angles

If the angle falls outside the range covered by the rqe table, log the information to the log file. If the ray packet includes a ray id, the ray id is printed; otherwise, the packet number is printed.

help

Boolean. Print a help message and exit.

version

Boolean. Print the version number and exit.


DESCRIPTION

hsi_rqe reads BPipe format rays and applies a relative quantum efficiency (RQE) appropriate to the HSI at a given energy. The rays are assumed to be monochromatic at the appropriate energy. The RQE data are read in from an /rdb; the currently available tables are in /proj/axaf/simul/databases/detectors/hsi_rqe.

If the angle the ray makes with the pore axis falls outside the range covered by the tables, the ray is not passed on; the number of such rays is accumulated and reported in the log file. A debug option, log_bad_angles allows some information about these rays to be logged.


AUTHOR

Terry Gaetz ( tgaetz@cfa.harvard.edu )