;+
; NAME: merope_payload.pro   +++(sswidl only)+++
; Brian Larsen 
; Space Science and Engineering Lab
; larsen@ssel.montana.edu
; 
;
; PURPOSE: Bin the MEROPE geiger tube data into a format that is useable
; in the analysis of the data
;
; INPUTS: 'data filename' (note the quotes -> ')
;
; OPTIONAL INPUTS:
; binsize=    - sets binsize (default=10)
; /notitles   - omits the standard titles on output
; /ylog       - plot the y axis as a log scale 	
; title=      - add a custom title
; subtitle=   - add a custom subtitle
; xtitle=     - add a custom x title
; ytitle=     - add a custom y title
; xrange=     - set xrange to a value different than whole histogram
;               eg: xrange=[2,5] 
; ps=         - sets output to postscript and filename (remember
;               quotes ' ;)
; /portait    - when using ps plots in portriat mode
; /nostats    - do not calculate statistics on the histogram (output
;               to screen)
; jpg=        - sets output to jpg and filename (remember quotes ' ;)
;
; OUTPUTS:
; histogram plot of the data file with specified bin size
;
; COMMON BLOCKS:
; none (this should change)
;
; SIDE EFFECTS:
; none (that i know of)
;
; RESTRICTIONS:
; a little limited, use it and you'll see
;
; EXAMPLE:
; merope_payload, '06212002a.payload', binsize=20
;
; MODIFICATION HISTORY:
; 06-20-2002 (BAL) first draft written and data display thought through
; 06-25-2002 a lot of i/o added as well as interface to strip.c for data
; formatting.  (BAL)
; 06-27-2002 (BAL) 
; - added a case statement for keywords and neatened things up a lot
; - used read_ascii to make the interface to strip.c no longer needed
; 07-01-2002
; - found plot_hist and implemented it and its options (looks nice)
; - implemented a ps option for plotting
; 07-02-2002
; - implemented merope2rt() as a way to keep all the secs/tick in onle
;      place for all routines.
; - various cosmetic chamges in the code to shorten it (trim, etc)
; 07-18-2002
; - added statistics on the screen report
; - added support for jpg output
;
;-