Produces a bar graph for a selected region of the results of the (MAT-LEI)
             TDRS selection tool
 
TITLE:      sel_tdrs_bargraph.py
DEVELOPER:  Alan Patterson, 10-Nov-2005
 
PURPOSE:    The tool generates a bar graph for a selected region of the
             results of the (MAT-LEI) TDRS selection tool
 
USAGE:      do sel_tdrs_bargraph  <file>  [-single]
 
             where: <file>          is the result file from the TDRS
                                     selection tool
                    -save           causes output files (.PS) to be created
                                     along with the screen display
                    -single         presents the graph in one large pane
                    -period_markers  causes the zoe and anode markers
                                     to appear.  (The plots will take
                                     longer to create with this option)
 
 RETURNS:   Nothing
 
 MOD HISTORY:
 Include recognition of keeper TDRS events        app  01/22/06
 Include -period_markers option                   app  01/24/06
 Add TDRS period color and marker                 app  01/30/06
 Add save plot file feature                       app  01/31/06
 Update documentation                             app  02/07/06
 Mod for simpler data file name                   app  02/08/06
 fix 000 day number                               drc  10/29/10
 code cleanup                                     drc   4/15/15

Modules
		calendar_util ccl_util os sms_util spss_sys_util spst_getopt sys time_util

Functions
		fig_plot(start, end, wins, anodetimes, zoetimes, fignum, figsize, state, old, passname, savefiles) get_calendar_data(cclname) run(*args) Creates a series of 'piano key' bargraph plots of the results of the Communication Advisor Tool (CAT)which is part of the MAT LEI process.   Usage:       do sel_tdrs_bargraph <selection_file>               where                 <selection_file>    is the selection output of the CAT                                     Default file extension is .sel                                     Default name is <msrunname>_<n>_<g>                                     n is the number of loads and g is the                                      gap limit used (10800 seconds default)                 -period_markers     puts the period markers on the plot                 -save               causes output files (.PS) to be created                                     along with the screen display                 -single             presents the whole week in one plot!                                     (which is very crowded but can be                                      expanded in the interactive gui)

Data
		__author__ = 'Alan Patterson' __version__ = '15.04.15'

Author
		Alan Patterson