PURPOSE --
Get vists or proposals based on the input cycle number.
 
DEVELOPER --
Don Chance
 
MODIFICATION HISTORY --
Date        Who            What
====        ===            ====
5-20-05     Chance         Initial implementation
5-23-05     Chance         added visit_detail_report
8-17-05     Chance         modified hash-bang for move to python 2.4.1
4-18-06     Chance         warn if neither -proposals or -visits is input
7-18-06     Chance         add status, types, excluded_lrps parameters
6-21-07     Chance         fix bug when -detail is used
11-7-08     Chance         add scenario as an input option.
11-17-08    Chance         print the scenario name
5-10-12     Chance         add exectime option

Modules
		available proposal_util spss_sys_util spst_getopt sys time_util visit_util

Functions
		run(*args) Get  proposals/visits based on the input cycle number   Usage:    do get_by_cycle <cycle_number1> [<cycle_number2>...<cycle_numberN>]                                    [-proposals] [-visits] [-detail] [-output=<filename>]                                    [-status=<list>] [-types=<list>] [-excluded_lrps=<list>]                                    [-scenario_name=<name>] [-exectime] At least one cycle number must be input; multiple cycle numbers may be provided separated by whitespace.   If the optional parameter, '-proposals', is given, a list of proposals will be produced.   If the optional parameter, '-visits', is given, a list of visits will be produced.   The '-detail' option will produce an 'available-style' report when '-visits' is specified.   If the optional parameter -output=<filename> is given, all output will  go to <filename>.  Otherwise, output will go to the screen.   The -status list is a comma separated list (with no spaces and no quotes) of allowed prop_track status values. Allowed prop_track values are 'pi', 'implementation', 'scheduling', 'completed', 'withdrawn', 'failed', and 'n/a'.  The default is -status=pi,implementation,scheduling.   Similarly, the -types list is a comma separated list of allowed or disallowed coverpage type values.  Wildcards are allowed (_ for a single character or % for multiple characters) and any value may be disallowed by appending NO to it. For example, -types=NO%PARS will exclude all proposals (or visits from proposals) that end with PARS in the coverpage type field.  The default is -types=GO%,GTO%,CAL%,ENG%.   The -excluded_lrps will exclude proposals or visits from proposals that are in the listed LRPS.  By default, no LRPs are excluded.   -scenairo_name defaults to the default scenario name from relation constraint_scenarios   When -exectime is specified, instead of plan windows execution start time and end time are printed. Status defaults to "pi,implenetation,scheduling,completed" when exetime is specified. visit_detail_report(visits, fileId, scenario=None, use_exectime=False)

Data
		__version__ = '11/17/08'