Python API: samMis v8_1_5
samMis.plotIncoming()

Just having some fun...
This is the python interface to the command 'sammis plot incoming data'.
Command Description:

Generate the plots of incoming data (i.e., declared data) by dataTier.
  
The plots that are generated by default are:
 pastDay-incomingFiles,    pastDay-incomingGbytes,    pastDay-incomingEvents,
 pastWeek-incomingFiles,   pastWeek-incomingGbytes,   pastWeek-incomingEvents,
 pastMonth-incomingFiles,  pastMonth-incomingGbytes,  pastMonth-incomingEvents,
 pastYear-incomingFiles,   pastYear-incomingGbytes,   pastYear-incomingEvents,
 all-incomingFiles,        all-incomingGbytes,        all-incomingEvents,

plus the integrated total of each of the above.

You may use "--start-date=dd-mon-yyyy --end-date=dd-mon-yyyy" to
specify particular dates, overriding the default plot dates.

You may use "--all" along with "--nodaily", "--noweekly", etc.,
  OR,       "--noall" along with "--daily", "--weekly", etc.,
to produce a subset of the default plots.

The default if no start-date, end-date, etc., is specified, is "--all".
          

Python Usage:
	from SamMis import samMis
	result = samMis.plotIncoming(...)

Return value: 

Arguments are passed as keyword-value pairs, as in:
	 myfunc(arg1='myarg', arg2='anotherarg', d=1)

Argument Keyword Description:
	(*) indicates that this keyword is required
	>>> indicates that either the API object or the CLI equivalent (<<<) is required
====================================================================================================================================
    KEYWORD                    DATA TYPE            DESCRIPTION
------------------------------------------------------------------------------------------------------------------------------------
    all                        SamBoolean           create all plots except those turned off on the command line
    c                          SamBoolean           automatically close all servants after each method call
    corbaCallTimeout           int                  time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
    d                          SamBoolean           debug mode
    daily                      SamBoolean           create the plot for the past 24 hours
    endDate                    SamTime              end of a particular date range for which to make plots (dd-mon-yyyy); default TODAY
    html                       string               name of the HTML file to generate, wherein all plots can be scanned and viewed (default: ./IncomingDataByDataTier.html)
    monthly                    SamBoolean           create the plot for the past month
    noall                      SamBoolean           do not create any plots except those specified on the command line
    nodaily                    SamBoolean           skip the plot for the past 24 hours
    nohtml                     SamBoolean           do not generate an HTML page wrapping the standard plots
    nomonthly                  SamBoolean           skip the plot for the past month
    nostartOfTime              SamBoolean           skip the plot for cumulative totals since time began
    noweekly                   SamBoolean           skip the plot for the past 7 days
    noyearly                   SamBoolean           skip the plot for the past year
    output                     string               output file base name, for user-specified date ranges (ignored otherwise)
    retryInterval              int                  retry interval base in seconds; will multiply this base times retryCount (default: 5)
    retryJitter                int                  retry jitter, random jitter added to base retry interval times retryCount (default: 5)
    retryMaxCount              int                  number of times to retry CORBA calls for retriable exceptions (default: 25; zero implies no retries)
    reuseColors                SamBoolean           re-use the colors in the color palatte (by default turned OFF; merge stragglers as "other")
    s                          SamBoolean           retrySilently mode (do not issue messages to stderr on proxy retries)
    startDate                  SamTime              beginning of a particular date range for which to make plots (dd-mon-yyyy)
    startOfTime                SamBoolean           create the plot for cumulative totals since time began
    t                          SamBoolean           time-it mode (print additional info on timings)
    v                          SamBoolean           verbose mode
    weekly                     SamBoolean           create the plot for the past 7 days
    yearly                     SamBoolean           create the plot for the past year
====================================================================================================================================

Mutually exclusive keywords:	
	(all || noall) 
	
	(daily || nodaily) 
	
	(monthly || nomonthly) 
	
	(start-of-time || nostart-of-time) 
	
	(weekly || noweekly) 
	
	(yearly || noyearly) 

Incompatible keyword combinations:	
	(noall, daily, weekly, monthly, yearly, start-of-time) OR (start-date, end-date) OR (all, nodaily, noweekly, nomonthly, 
	    noyearly, nostart-of-time) 

Environment Defaults:
	c = os.environ['SAM_PYAPI_AUTO_CLOSE_SERVANTS']
	corbaCallTimeout = os.environ['SAM_PYAPI_CORBA_CALL_TIMEOUT']
	retryInterval = os.environ['SAM_PYAPI_RETRY_INTERVAL']
	retryJitter = os.environ['SAM_PYAPI_RETRY_JITTER']
	retryMaxCount = os.environ['SAM_PYAPI_RETRY_MAX_COUNT']
	s = os.environ['SAM_PYAPI_RETRY_SILENTLY']



See Also: