lsst.dax.apdb.timer.Timer Class Reference

Inheritance diagram for lsst.dax.apdb.timer.Timer:

Public Member Functions
def	__init__ (self, name="", doPrint=True)
def	start (self)
def	stop (self)
def	dump (self)
def	__str__ (self)
def	__enter__ (self)
def	__exit__ (self, exc_type, exc_val, exc_tb)

Detailed Description

Instance of this class can be used to track consumed time.

This class is also a context manager and can be used in
a `with` statement. By default it prints consumed CPU time
and real time spent in a context.

Example:

    with Timer('SelectTimer'):
        engine.execute('SELECT ...')

Definition at line 37 of file timer.py.

Constructor & Destructor Documentation

__init__()

def lsst.dax.apdb.timer.Timer.__init__	(		self,
			name = "",
			doPrint = True
	)

@param name:  Time name, will be printed together with statistics
@param doPrint: if True then print statistics on exist from context

Definition at line 51 of file timer.py.

    def __init__(self, name="", doPrint=True):
        """
        @param name:  Time name, will be printed together with statistics
        @param doPrint: if True then print statistics on exist from context
        """
        self._name = name
        self._print = doPrint
 
        self._startReal = None
        self._startUser = None
        self._startSys = None
        self._sumReal = 0.
        self._sumUser = 0.
        self._sumSys = 0.
 

Member Function Documentation

__enter__()

def lsst.dax.apdb.timer.Timer.__enter__

(

self

)

Enter context, start timer

Definition at line 111 of file timer.py.

    def __enter__(self):
        """
        Enter context, start timer
        """
        self.start()
        return self
 

__exit__()

def lsst.dax.apdb.timer.Timer.__exit__	(		self,
			exc_type,
			exc_val,
			exc_tb
	)

Exit context, stop and dump timer

Definition at line 118 of file timer.py.

    def __exit__(self, exc_type, exc_val, exc_tb):
        """
        Exit context, stop and dump timer
        """
        if exc_type is None:
            self.stop()
            if self._print:
                self.dump()
        return False

__str__()

def lsst.dax.apdb.timer.Timer.__str__

(

self

)

Definition at line 97 of file timer.py.

    def __str__(self):
        real = self._sumReal
        user = self._sumUser
        sys = self._sumSys
        if self._startReal is not None:
            real += time.time() - self._startReal
            ru = resource.getrusage(resource.RUSAGE_SELF)
            user += ru.ru_utime - self._startUser
            sys += ru.ru_stime - self._startSys
        info = "real=%.3f user=%.3f sys=%.3f" % (real, user, sys)
        if self._name:
            info = self._name + ": " + info
        return info
 

dump()

def lsst.dax.apdb.timer.Timer.dump

(

self

)

Dump timer statistics

Definition at line 90 of file timer.py.

    def dump(self):
        """
        Dump timer statistics
        """
        _LOG.info("%s", self)
        return self
 

start()

def lsst.dax.apdb.timer.Timer.start

(

self

)

Start timer.

Definition at line 66 of file timer.py.

    def start(self):
        """
        Start timer.
        """
        self._startReal = time.time()
        ru = resource.getrusage(resource.RUSAGE_SELF)
        self._startUser = ru.ru_utime
        self._startSys = ru.ru_stime
        return self
 

stop()

def lsst.dax.apdb.timer.Timer.stop

(

self

)

Stop timer.

Definition at line 76 of file timer.py.

    def stop(self):
        """
        Stop timer.
        """
        if self._startReal is not None:
            self._sumReal += time.time() - self._startReal
            ru = resource.getrusage(resource.RUSAGE_SELF)
            self._sumUser += ru.ru_utime - self._startUser
            self._sumSys += ru.ru_stime - self._startSys
            self._startReal = None
            self._startUser = None
            self._startSys = None
        return self
 

---

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

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-0.7.0/Linux64/dax_apdb/22.0.1-2-gb66926d+6312710a6c/python/lsst/dax/apdb/timer.py