; IDL TOOL NAME:  		pitch_plot.pro
; Diagnostics directory: 	/home/ppq/bigdisk/ppa/pitch_plot/pitch_plot_tool
; Public directory:	 	/home/ppq/idl_tools_public
;
; WRITTEN:	Pamela A. Puhl-Quinn, 11/12/96
; 		ppq, 2/4/97, recompiled, b1_43, exe: lz_pitch_plot_b1_43
;		ppq, 2/18/97, recompiled for TM 4 too, exe: lz_pitch_plot_b1_43
;		ppq, 6/16/97, recompiled, exe: lz_pitch_plot_b1_48
;
; This tool extracts PPA raw counts data from level-zero files and
; computes the probability function (used to normalize the raw counts).
; The raw counts divided by the probability function gives counts per
; second (cps).  You can view raw, prob, or cps as functions of pitch
; angle in time-ordered or energy ordered sequences (see keywords below).

; There will be 36 plots per page (36 energy levels) if you're in telemetry
; mode 3, and only 16 plots per page (16 energy levels) if you're in
; telemetry mode 4.


; USAGE:  
;    pitch_plot,960713,1028,/cps
;
; MANDATORY ARGUMENTS:
;		1st argument:  YYMMDD or YYYYMMDD
;		2nd argument: 'HH:MM:SS','HH:MM',HHMMSS,HHMM,HH.HHH,H
;
; MANDATORY KEYWORDS: (one at a time)
;   /cps		; PPA Counts per second (Raw counts/Probability)
;   /prob		; PPA Probability function
;   /raw_cnts		; PPA Raw counts
;   /eo_cps		; Energy ordered cps
;   /eo_prob		; Energy ordered prob
;   /eo_raw		; Energy ordered raw counts
;
; OPTIONAL KEYWORDS:
;   /nwindow		; specify the device window number
;   /print		; create a post-script file AND print at UIowa
;   /ps			; create a post-script file, idl.ps
;   /gif		; create a gif-file, idl.gif
