python.trfUtils.JobGroup Class Reference

JobGroup: a set of Job objects and pieces of information relevant to a given set of Job objects. More...

Inheritance diagram for python.trfUtils.JobGroup:

Collaboration diagram for python.trfUtils.JobGroup:

Public Member Functions
def	__init__ (self, jobs=None, name=None, timeout=None)
	initialisation method More...
def	name (self)
def	__str__ (self)
	return an object self description string @ detail This method returns an object description string consisting of a listing of the items of the object self. More...
def	timeoutStatus (self)
	return Boolean JobGroup timeout status More...
def	printout (self)
	print in a human-readable way the items of the object self More...

Public Attributes
	jobs
	className
	completeStatus
	timeStampSubmission
	timeout
	results

Private Attributes
	_name

Detailed Description

JobGroup: a set of Job objects and pieces of information relevant to a given set of Job objects.

A JobGroup is a set of Job objects and pieces of information relevant to a given set of Job objects. A JobGroup object comprises a name, a list of Job objects, a timeout and, ultimately, an ordered list of result objects. The timeout can be speecified or derived from the summation of the timeout specifications of the set of Job objects.

Parameters

name	the JobGroup object name
jobs	the list of Job objects
timeout	the JobGroup object timeout specification in seconds

Definition at line 787 of file trfUtils.py.

Constructor & Destructor Documentation

__init__()

def python.trfUtils.JobGroup.__init__	(		self,
			jobs = None,
			name = None,
			timeout = None
	)

initialisation method

Definition at line 790 of file trfUtils.py.

    def __init__(
        self,
        jobs = None,
        name = None,
        timeout = None
        ):
        self.jobs = jobs
        self.className = self.__class__.__name__
        self.completeStatus = False
        self.timeStampSubmission = None
        if name is None:
            self._name = uniqueIdentifier()
        else:
            self._name = name
        #self.timeStampSubmissionComplete = None #delete
        if timeout is None:
            self.timeout = 0
            for job in self.jobs:
                self.timeout += job.workFunctionTimeout
        self.results = []
 

Member Function Documentation

__str__()

def python.trfUtils.JobGroup.__str__

(

self

)

return an object self description string @ detail This method returns an object description string consisting of a listing of the items of the object self.

Returns

object description string

Definition at line 819 of file trfUtils.py.

    def __str__(self):
        descriptionString = ""
        for key, value in sorted(vars(self).items()):
            descriptionString += str("{key}:{value} ".format(
                key = key,
                value = value)
            )
        return descriptionString
 

name()

def python.trfUtils.JobGroup.name

(

self

)

Definition at line 812 of file trfUtils.py.

    def name(self):
        return self._name
 

printout()

def python.trfUtils.JobGroup.printout

(

self

)

print in a human-readable way the items of the object self

This function prints in a human-readable way the items of the object self.

Definition at line 850 of file trfUtils.py.

    def printout(self):
        printHR(vars(self))
 
 

timeoutStatus()

def python.trfUtils.JobGroup.timeoutStatus

(

self

)

return Boolean JobGroup timeout status

This method returns the timeout status of a JobGroup object. If the JobGroup object has not timed out, the Boolean False is returned. If the JobGroup object has timed out, the Boolean True is returned. If the JobGroup object has been completed or is not submitted, the Boolean False is returned.

Returns

Boolean indicating the JobGroup timeout status

Definition at line 835 of file trfUtils.py.

    def timeoutStatus(self):
        # If the JobGroup is complete or not submitted, then it is not timed
        # out.
        if self.completeStatus is True or self.timeStampSubmission is None:
            return False
        # If the JobGroup is not complete or submitted, then it may be timed
        # out.
        elif time.time() > self.timeout + self.timeStampSubmission:
            return True
        else:
            return False
 

Member Data Documentation

_name

python.trfUtils.JobGroup._name

private

Definition at line 796 of file trfUtils.py.

className

python.trfUtils.JobGroup.className

Definition at line 792 of file trfUtils.py.

completeStatus

python.trfUtils.JobGroup.completeStatus

Definition at line 793 of file trfUtils.py.

jobs

python.trfUtils.JobGroup.jobs

Definition at line 791 of file trfUtils.py.

results

python.trfUtils.JobGroup.results

Definition at line 804 of file trfUtils.py.

timeout

python.trfUtils.JobGroup.timeout

Definition at line 801 of file trfUtils.py.

timeStampSubmission

python.trfUtils.JobGroup.timeStampSubmission

Definition at line 794 of file trfUtils.py.

---

The documentation for this class was generated from the following file:

• trfUtils.py