Checks for CALIBRATION monthly metric files, processes them and publishes
              them
 
TITLE:      metric_calib_monthly.py
DEVELOPER:  Alan Patterson, 30-May-2008
 
PURPOSE:    The tool checks for the existence of CALIBRATION monthly metric
             data, retrieves and processes them into updated tables (text
             and Excel) and plots
 
USAGE:      do metric_calib_monthly             [-verbose]
                                              [-nodelete]
                                              [-nocleanup]
 
             where: -verbose     causes informational messages to appear.
 
 RETURNS:   Nothing
 
 MOD HISTORY:
     o update for metplot change                 app 061308
     o use updated bar_plot1 in metplot          app 061908
     o Python 2.5                                app 073009
     o remove dots after instr name              app 101113
     o code cleanup                              drc 043015

Modules
		matplotlib metplot os spss_sys_util spst_getopt sys time_util

Functions
		get_calresults(fil) get_top_limit(ymax, ystep) Calculate a 'top of plot' value - a value greater than the given maximum which is equal to an integral multiple of the step value.    i.e. top_limit = n * ystep                top_limit > ymax                top_limit < ymax + ystep make_cal_comp_plot(calcomp, instrlist, outplotfil, cflag) Produce Calibration Completion Bar Chart calcomp        is the table from an input metric file                         calresults.txt instrlist      is the list of instruments to include outplotfil     is the plot file to be produced make_res_plot(data, ylab, btitle, outplot, cflag) run(*args) Checks for monthly calibration metric data in input area, retrieves it, processes it and publishes results to output area.     Tables are updated (text and Excel) and plots are produced.   Usage:     do metric_calib_monthly [-verbose] [-noupdate] [-nodelete] [-nocleanup]               where      -verbose       causes information messages                        -noupdate      prevents modifying the tables                        -nodelete      prevents deleting of input files                        -nocleanup     prevents deleting of output files

Data
		ALERTADDR = ['jferrara@stsci.edu', 'workman@stsci.edu'] BASE_DIR = 'inside-access/metrics' FTPDICT = {'base_dir': 'inside-access/metrics', 'host': 'ftp.stsci.edu', 'nofilestring': 'No files in directory', 'user': 'anonymous', 'word': 'planinst@stsci.edu'} HOST = 'ftp.stsci.edu' METRIC_DICT = {'indir': 'CALIB_in', 'infiles': ['calresults.txt', 'calstats.txt', 'caldecon.txt'], 'name': 'Monthly Calibration', 'outdir': 'CALIB_out', 'outfiles': ['calstats.txt', 'calstats.xls', 'caldecon.txt', 'cal_comp1.pdf', 'cal_comp2.pdf', 'cal_results.pdf'], 'plotext': '.pdf', 'table': None} NOFILESTRING = 'No files in directory' TABLEDIR = '/data/scheduling/spss_flight_data/planinst/metrics/archive' USER = 'anonymous' WORD = 'planinst@stsci.edu' __author__ = 'Alan Patterson' __version__ = '15.04.30'

Author
		Alan Patterson