NAME

pha_diode -- Plot a detailed summary of individual diodes' PHA.

USAGE

pha_diode diodes

DESCRIPTION

pha_diode uses the output of the phaz task to plot a detailed summary of a Pulse Height Analysis (PHA) for individual diodes. Specifically, a plot of the integrated pulse height distribution, the differential pulse height distribution, the Gaussian fit to the differential, the statistics on that fit, and the final threshold determination are produced. The diodes to be plotted are specified either interactively (STDIN) or by using a file containing a list of diode numbers (see the description of the diodes parameter).

PARAMETERS

diodes [file name]

Text file containing a list of diodes for which detailed plots will be produced. The diodes file should contain a list of one diode number per line. If no value is passed to diodes, the default is to take input from standard input. If this is set to "dev$null", then no plots are produced.

(intphd = "") [file name]

Image containing the integral pulse height distribution produced by the phaz task. If blank, the image name will be taken from the intphd parameter of the phaz task.

(difphd = "") [file name]

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

(fitphd = "") [file name]

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]

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]

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 "0.", this value will be taken from the phaz.delt parameter.

(device = "stdgraph") [string]

Device on which the graphs 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 number of diodes drawn as task progresses?

EXAMPLES

1. Run the phaz task and then produce the detailed graphs for the list of diodes contained in the file short_list.txt.

cl> phaz z06i0501t.doh[*] z06i0501t.x0h[*]
cl> pha_diode short_list.txt

The file short_list.txt has the following contents:

1
110
150
279
512

2. Produce the summary graphs on a different set of data, contained in the files intphd_old, 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. Also, take the diode list from standard input. The diodes that will be examined are 1, 110, 150, 279, and 512. The "end-of-file" character is control-Z.

cl> pha_diode "" intphd=intphd_old difphd=difphd_old fitphd=fitphd_old \
>>> table=phaz_old t0=20. delt=2. device=stdplot
diode_list: 1
<<graph is drawn>>
diode_list: 110
<<graph is drawn>>
diode_list: 150
<<graph is drawn>>
diode_list: 279
<<graph is drawn>>
diode_list: 512
<<graph is drawn>>
diode_list: <<control_Z is hit>>

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_all, pha_center, pha_rms, pha_sig2rms, pha_summary, pha_text