NAME

pha_all -- For all diodes, plot the differential, Gaussian fit, and thresholds.

USAGE

pha_all

DESCRIPTION

pha_all uses the output of the phaz task to plot summary graphs of the results for all the diodes of a Pulse Height Analysis (PHA) observation. In particular, for each diode, a graph of the differential distribution, the fitted Gaussian, scale of the graph, and the chosen threshold is drawn. 16 diodes will appear on a page for a total of 32 pages. The output can appear on the terminal or can be redirected to a plotting device.

PARAMETERS

(difphd = "") [file name]

The image containing the differential pulse height distribution produced by the phaz task. If this parameter is left blank, the image name will be taken from the phaz.difphd parameter.

(fitphd = "") [file name]

The image containing the fitted pulse height distribution produced by the phaz task. If blank, the image name will be taken from the phaz.fitphd parameter.

(table = "") [file name]

The table containing the threshold statistics produced by the phaz task. If blank, the table name will be taken from the phaz.table parameter.

(t= 0.) [real]

The initial threshold level of the first input threshold observation. If this is "0.", the value will be taken from the phaz.t0 parameter.

(delt = 0.) [real]

The step size in threshold levels between threshold observations. If this is "0.", the value will be taken from the phaz.delt parameter.

(device = "stdgraph") [string]

Output device on which the graph will be printed.

(left = 0.) [real]

The left boundary on the graphics device, specified from 0. to 1., where the graphs will appear.

(right = 1.) [real]

The right boundary on the graphics device, specified from 0. to 1., where the graphs will appear.

(bottom = 0.) [real]

The bottom boundary on the graphics device, specified from 0. to 1., where the graphs will appear.

(top = 1.) [real]

The top boundary on the graphics device, specified from 0. to 1., where the graphs will appear.

(verbose = yes) [real]

Display the number of diodes that have been drawn as task progresses?

EXAMPLES

1. Run the phaz task and then produce the summary graphs of all the diodes.

cl> phaz z06i0501t.doh[*] z06i0501t.x0h[*]
cl> pha_all

2. Produce the summary graphs on a different set of data, contained in the files difphd_old, fitphd_old, phaz_old, that were based on a different set of thresholds that started at 20 and incremented by 2. Send the plots to the standard plot device.

cl> pha_all difphd=difphd_old fitphd=fitphd_old table=phaz_old \
>>> t0=20. delt=2. device=stdplot

BUGS

REFERENCES

Author: Jonathan Eisenhamer

HELP

For assistance using this or any other tasks, please contact help@stsci.edu or call the help desk at 410-338-1082.

SEE ALSO

phaz, pha_center, pha_diode, pha_rms, pha_sig2rms, pha_summary, pha_text