Plots the time coverage of the loads for the given MS run
 
TITLE:      generate_clevent_plots.py
DEVELOPER:  Alan Patterson, 28-May-2009
 
PURPOSE:    The tool generates plots useful for planning intercepts and
             otherwise useful for displaying lods, load uplinks and
             related TDRS coverage.
 
USAGE:      do generate_clevent_plots <MS_name>
             where: <MS_name> is the MS run name.
 
 RETURNS:   Nothing
 
 MOD HISTORY:
     o Allow for PASS smsname option                    app  060109
     o Cleaner PDF concatenation & SI transitions       app  060209
     o Add emphasis do certain 486 uplink windows       app  052912
     o Modified to compensate for changes to tdrs_util  drc  051513
     o updated for matplotlib version 1.3.1             drc  040415

Modules
		calendar_util file_util matplotlib metplot os pass_util sms_util spss_sys_util spst_getopt stpydb sys tdrs_util time_util

Functions
		addwins2(wins, wnames, col, vwidth, yval, plotrange, namesize) Adds horizontal bars representing time windows to the existing plot   wins          - list of time windows wnames        - either list of names associated with each window                       or None. col           - color of the horizontal bars vwidth        - vertical width of bars yval          - potion of bar in vertical direction plotrange     - time window for plot get_calendar_details(passname) get_intercepts(interceptfile) Read the intercept file and produces a list of intercept times and type  ('rebuild'  or  'patch').  If no intercepts times are found the list is empty       Returns         List of tuples   (time of intercept, type of intercept) get_load_windows(clopcatfile) Reads the clopcat.cat file and extracts time window information for each load.     Returns  loaddict       dictionary keyed on loadname                               secondary key  'uplink' or 'coverage'                                 data - time window              loadlist       list of loadnames get_plotrange(loadname, loaddict) Calculates the appropriate plot range for the specified load get_qload_hgatrackwins(qloadwin, hga1trackwins, hga2trackwins) Find the intersection of the Qload windows, HGA1 tracking windows and HGA2 tracking windows get_sus_on_cclist(cclname, start, end, types) Returns a time ordered list of tuples containing the baselined SU name, start time and end time for SUs that overlap the start-end window. Types can include any of m - main, i - interleaver and p - parallel plot_loadwind_bars2(loaddict, loadlist, num, msrunname, plotfile, verbose, marwins, fwdwins, hga1trackwins, hga2trackwins, interceptlist, scale, slews, sitrans, mainsus, altsus) Plots all the loads on separate subplots based on the Q (486) load windows     loaddict        - dictionary of load windows     loadlist        - list of loadnames     num             - number of subplots per page     msrunname       - MS run name     plotfile        - filename of plot file to be written (each                             page of subplots has _<i> appended to the name)     verbose         - flag to indicated verbose messages     marwins         - MAR window list     fwdwins         - Forward window list plot_page_bars2(loaddict, loadlist, n, num, isub, msrunname, verbose, marwins, fwdwins, hga1trackwins, hga2trackwins, interceptlist, scale, slews, sitrans, mainsus, altsus) plots the subplots on each page loaddict        - dictionary of loads loadlist        - time ordered list of load names n               - index to load in list (should be Q load) num             - number of subplots per page isub            - index to subplot msrunname       - MS runname verbose         - verbose flag marwins         - MAR window list fwdwins         - Forward window list interceptlist   - list of intercept times and types scale           - if non-zero defines range of X axis run(*args) Presents the time coverage of the loads for the given MS run   Usage:     do generate_clevent_plots   <MS_run_name>   [-save=filename]                                             [-number=<n>]                                             [-intercepts=<interceptfile>]                                             [-verbose]                                             [-autoscale]                                             [-sms=<passsmsname>]               where    MS_run_name    is the MS run name                      filename       is the name of the PDF plot file to create                                     [e.g.  load_coverage.ps]  If multiple                                     pages by default all pages are combined into                                     one output file.                      number         indicates the number of subplots per page                      interceptfile  is a file that provides intercept times                                       Format 1                                         <intercept time>   REBUILD|PATCH                                       Format 2                                         intercept report file                      autoscale      allows the X scale of each subplot to                                     be determined automatically.  Otherwise                                     the same scale is used for all subplots.                      passsmsname    overrides the assumed smsname from the                                     msrunname

Data
		BOX_ALPHA = 0.3 COL_INTERBOX = '#FFB6C1' COL_INTERCEPT = '#800080' COL_NLOAD = '#BC8F8F' COL_QLOAD = '#7B68EE' COL_QLOAD2 = '#483D8B' COL_SITRAN = '#FF8C00' COL_SLEW = '#8B4513' COL_SU = '#87CEEB' COL_TDRSFWD = '#008B8B' COL_TDRSHGA1 = '#FF0000' COL_TDRSHGA2 = '#008000' COL_TDRSMAR = '#FF00FF' COL_UPLINK = '#8DBC8F' COL_UPLINK2 = '#2E8B57' COL_UPLINKBOX = '#90EE90' ENDPAD = 3600 FONTSIZE_SULABEL = 6 NUMDEF = 1 STARTPAD = 3600 __author__ = 'Alan Patterson' __version__ = '15.04.08'

Author
		Alan Patterson