JEEP::JTimer Class Reference

Auxiliary class for CPU timing and usage. More...

#include <JTimer.hh>

Inheritance diagram for JEEP::JTimer:

Public Types
enum	JStatus_t { CLK_STOPPED = 0, CLK_RUNNING = 1 }
	Status of clock. More...
typedef unsigned long long	ull

Public Member Functions
	JTimer ()
	Default constructor. More...
	JTimer (const JTitle &title)
	Constructor. More...
void	reset ()
	Reset timer. More...
void	start ()
	Start timer. More...
void	stop ()
	Stop timer. More...
unsigned int	timing_get_cpu_percentage () const
	Get CPU usage. More...
void	print (std::ostream &out, const JScale_t scale=milli_t) const
	Print timer data. More...
void	print (std::ostream &out, const bool normalise, const JScale_t scale=milli_t) const
	Print timer data. More...
void	print (std::ostream &out, const double factor, const JScale_t scale=milli_t) const
	Print timer data. More...
const std::string &	getTitle () const
	Get title. More...
void	setTitle (const std::string &title)
	Set title. More...

Static Public Member Functions
static unsigned long long	timeval_to_usec (const struct timeval &tv)
	Convert timeval to micro-seconds. More...

Public Attributes
unsigned long long	usec_wall
unsigned long long	usec_ucpu
unsigned long long	usec_scpu
unsigned long long	counter

Protected Attributes
JStatus_t	status
std::string	title

Friends
std::ostream &	operator<< (std::ostream &out, const JTimer &timer)
	Print timer data. More...

Detailed Description

Auxiliary class for CPU timing and usage.

Definition at line 32 of file JTimer.hh.

Member Typedef Documentation

ull

typedef unsigned long long JEEP::JTimer::ull

Definition at line 37 of file JTimer.hh.

Member Enumeration Documentation

JStatus_t

enum JEEP::JTimer::JStatus_t

Status of clock.

Enumerator
CLK_STOPPED
CLK_RUNNING

Definition at line 42 of file JTimer.hh.

{ CLK_STOPPED = 0, CLK_RUNNING = 1 };

Constructor & Destructor Documentation

JTimer() [1/2]

JEEP::JTimer::JTimer ( )

inline

Default constructor.

Definition at line 48 of file JTimer.hh.

             :
      JTitle(),
      usec_wall(0ULL),
      usec_ucpu(0ULL),
      usec_scpu(0ULL),
      counter  (0ULL),
      status   (CLK_STOPPED)
    {}

JTimer() [2/2]

JEEP::JTimer::JTimer ( const JTitle &  title )

inline

Constructor.

Parameters

title

title

Definition at line 63 of file JTimer.hh.

                                :
      JTitle(title),
      usec_wall(0ULL),
      usec_ucpu(0ULL),
      usec_scpu(0ULL),
      counter  (0ULL),
      status   (CLK_STOPPED)
    {}

Member Function Documentation

reset()

void JEEP::JTimer::reset ( )

inline

Reset timer.

Definition at line 76 of file JTimer.hh.

    {
      usec_wall = 0;
      usec_ucpu = 0;
      usec_scpu = 0;
      counter   = 0;
      status    = CLK_STOPPED;
    }

start()

void JEEP::JTimer::start ( )

inline

Start timer.

Definition at line 89 of file JTimer.hh.

    {
      if (status == CLK_STOPPED) {
 
        struct timeval tv;
        struct rusage  usage;
        
        gettimeofday(&tv, NULL);
        getrusage(RUSAGE_SELF, &usage);
        
        usec_wall -= timeval_to_usec(tv);
        usec_ucpu -= timeval_to_usec(usage.ru_utime);
        usec_scpu -= timeval_to_usec(usage.ru_stime);
        
        status    = CLK_RUNNING;
        
        ++counter;
      }
    }

stop()

void JEEP::JTimer::stop ( )

inline

Stop timer.

Definition at line 113 of file JTimer.hh.

    {
      if (status == CLK_RUNNING) {
 
        struct timeval tv;
        struct rusage  usage;
        
        gettimeofday(&tv, NULL);
        getrusage(RUSAGE_SELF, &usage);
        
        usec_wall += timeval_to_usec(tv);
        usec_ucpu += timeval_to_usec(usage.ru_utime);
        usec_scpu += timeval_to_usec(usage.ru_stime);
      }
 
      status    = CLK_STOPPED;
    }

timing_get_cpu_percentage()

unsigned int JEEP::JTimer::timing_get_cpu_percentage ( ) const

inline

Get CPU usage.

Returns

CPU usage [%]

Definition at line 137 of file JTimer.hh.

    {
      return (100ULL * (usec_ucpu + usec_scpu) / (usec_wall+1));
    }

timeval_to_usec()

static unsigned long long JEEP::JTimer::timeval_to_usec ( const struct timeval &  tv )

inlinestatic

Convert timeval to micro-seconds.

Parameters

tv

timeval

Returns

time [us]

Definition at line 149 of file JTimer.hh.

    {
      return (unsigned long long) tv.tv_sec * 1000000ULL + (unsigned long long) tv.tv_usec;
    }

print() [1/3]

void JEEP::JTimer::print ( std::ostream &  out, const JScale_t  scale = milli_t  ) const

inline

Print timer data.

Parameters

out	output stream
scale	scale

Definition at line 161 of file JTimer.hh.

    {
      print(out, 1.0, scale);
    }

print() [2/3]

void JEEP::JTimer::print ( std::ostream &  out, const bool  normalise, const JScale_t  scale = milli_t  ) const

inline

Print timer data.

Parameters

out	output stream
normalise	normalise to number of starts
scale	scale

Definition at line 174 of file JTimer.hh.

    {
      double factor = 1.0;
 
      if (normalise && counter != 0) {
        factor = 1.0 / (double) counter;
      }
 
      print(out, factor, scale);
    }

print() [3/3]

void JEEP::JTimer::print ( std::ostream &  out, const double  factor, const JScale_t  scale = milli_t  ) const

inline

Print timer data.

Parameters

out	output stream
factor	multiplication factor
scale	scale

Definition at line 193 of file JTimer.hh.

    {
      using namespace std;
 
      const double y = factor * 1e-3 * getValue(milli_t) / getValue(scale);
      const char*  u = getUnit(scale);
 
      out << getTitle()  << endl;
      out << FIXED(10,3) << usec_wall * y << " " << u << "s elapsed" << endl;
      out << FIXED(10,3) << usec_ucpu * y << " " << u << "s user"    << endl;
      out << FIXED(10,3) << usec_scpu * y << " " << u << "s system"  << endl;
      out << setw( 3)    << timing_get_cpu_percentage() << "%CPU" << endl;
    }

getTitle()

const std::string& JLANG::JTitle::getTitle ( ) const

inlineinherited

Get title.

Returns

title

Definition at line 55 of file JTitle.hh.

    {
      return this->title;
    }

setTitle()

void JLANG::JTitle::setTitle ( const std::string &  title )

inlineinherited

Set title.

Parameters

title

title

Definition at line 66 of file JTitle.hh.

    {
      this->title = title;
    }

Friends And Related Function Documentation

operator<<

std::ostream& operator<< ( std::ostream &  out, const JTimer &  timer  )

friend

Print timer data.

Parameters

out	output stream
timer	timer

Returns

output stream

Definition at line 215 of file JTimer.hh.

    {
      timer.print(out);
 
      return out;
    }

Member Data Documentation

usec_wall

unsigned long long JEEP::JTimer::usec_wall

Definition at line 224 of file JTimer.hh.

usec_ucpu

unsigned long long JEEP::JTimer::usec_ucpu

Definition at line 225 of file JTimer.hh.

usec_scpu

unsigned long long JEEP::JTimer::usec_scpu

Definition at line 226 of file JTimer.hh.

counter

unsigned long long JEEP::JTimer::counter

Definition at line 227 of file JTimer.hh.

status

JStatus_t JEEP::JTimer::status

protected

Definition at line 230 of file JTimer.hh.

title

std::string JLANG::JTitle::title

protectedinherited

Definition at line 73 of file JTitle.hh.

---

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

• JTimer.hh