libMesh::PerfData Class Reference

The PerfData class simply contains the performance data that is recorded for individual events. More...

#include <perf_log.h>

Public Member Functions
	PerfData ()
	Constructor. More...
void	start ()
void	restart ()
double	pause ()
double	pause_for (PerfData &other)
double	stopit ()

Public Attributes
double	tot_time
	Total time spent in this event. More...
double	tot_time_incl_sub
	Total time spent in this event, including sub-events. More...
struct timeval	tstart
	Structure defining when the event was last started. More...
struct timeval	tstart_incl_sub
	Structure defining when the event was last started, including sub-events. More...
unsigned int	count
	The number of times this event has been executed. More...
bool	open
	Flag indicating if we are currently monitoring this event. More...
int	called_recursively

Protected Member Functions
double	stop_or_pause (const bool do_stop)

Detailed Description

The PerfData class simply contains the performance data that is recorded for individual events.

Author

Benjamin Kirk

Date

2003

Data object managed by PerfLog

Definition at line 46 of file perf_log.h.

Constructor & Destructor Documentation

PerfData()

libMesh::PerfData::PerfData ( )

inline

Constructor.

Initializes data to be empty.

Definition at line 53 of file perf_log.h.

              :
    tot_time(0.),
    tot_time_incl_sub(0.),
    tstart(),
    tstart_incl_sub(),
    count(0),
    open(false),
    called_recursively(0)
  {}

Member Function Documentation

pause()

double libMesh::PerfData::pause ( )

inline

Definition at line 398 of file perf_log.h.

{
  return this->stop_or_pause(false);
}

References stop_or_pause().

pause_for()

double libMesh::PerfData::pause_for ( PerfData &  other )

inline

Definition at line 434 of file perf_log.h.

{
  gettimeofday (&(other.tstart), nullptr);
 
  const double elapsed_time = (static_cast<double>(other.tstart.tv_sec  - this->tstart.tv_sec) +
                               static_cast<double>(other.tstart.tv_usec - this->tstart.tv_usec)*1.e-6);
  this->tot_time += elapsed_time;
 
  other.count++;
  other.called_recursively++;
  other.tstart_incl_sub = other.tstart;
 
  return elapsed_time;
}

References called_recursively, count, tot_time, tstart, and tstart_incl_sub.

restart()

void libMesh::PerfData::restart ( )

inline

Definition at line 390 of file perf_log.h.

{
  gettimeofday (&(this->tstart), nullptr);
}

References tstart.

start()

void libMesh::PerfData::start ( )

inline

Definition at line 379 of file perf_log.h.

{
  this->count++;
  this->called_recursively++;
  gettimeofday (&(this->tstart), nullptr);
  this->tstart_incl_sub = this->tstart;
}

References called_recursively, count, tstart, and tstart_incl_sub.

Referenced by libMesh::PerfLog::fast_push().

stop_or_pause()

double libMesh::PerfData::stop_or_pause ( const bool  do_stop )

inlineprotected

Definition at line 405 of file perf_log.h.

{
  // save the start times, reuse the structure we have rather than create
  // a new one.
  const time_t
    tstart_tv_sec  = this->tstart.tv_sec,
    tstart_tv_usec = this->tstart.tv_usec;
 
  gettimeofday (&(this->tstart), nullptr);
 
  const double elapsed_time = (static_cast<double>(this->tstart.tv_sec  - tstart_tv_sec) +
                               static_cast<double>(this->tstart.tv_usec - tstart_tv_usec)*1.e-6);
 
  this->tot_time += elapsed_time;
 
  if (do_stop)
    {
      const double elapsed_time_incl_sub = (static_cast<double>(this->tstart.tv_sec  - this->tstart_incl_sub.tv_sec) +
                                            static_cast<double>(this->tstart.tv_usec - this->tstart_incl_sub.tv_usec)*1.e-6);
 
      this->tot_time_incl_sub += elapsed_time_incl_sub;
    }
 
  return elapsed_time;
}

References tot_time, tot_time_incl_sub, and tstart.

Referenced by pause(), and stopit().

stopit()

double libMesh::PerfData::stopit ( )

inline

Definition at line 452 of file perf_log.h.

{
  // stopit is just similar to pause except that it decrements the
  // recursive call counter
 
  this->called_recursively--;
  return this->stop_or_pause(true);
}

References called_recursively, and stop_or_pause().

Member Data Documentation

called_recursively

int libMesh::PerfData::called_recursively

Definition at line 105 of file perf_log.h.

Referenced by pause_for(), start(), and stopit().

count

unsigned int libMesh::PerfData::count

The number of times this event has been executed.

Definition at line 90 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), pause_for(), and start().

open

bool libMesh::PerfData::open

Flag indicating if we are currently monitoring this event.

Should only be true while the event is executing.

Definition at line 97 of file perf_log.h.

tot_time

double libMesh::PerfData::tot_time

Total time spent in this event.

Definition at line 67 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), pause_for(), and stop_or_pause().

tot_time_incl_sub

double libMesh::PerfData::tot_time_incl_sub

Total time spent in this event, including sub-events.

Definition at line 72 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), and stop_or_pause().

tstart

struct timeval libMesh::PerfData::tstart

Structure defining when the event was last started.

Definition at line 78 of file perf_log.h.

Referenced by pause_for(), restart(), start(), and stop_or_pause().

tstart_incl_sub

struct timeval libMesh::PerfData::tstart_incl_sub

Structure defining when the event was last started, including sub-events.

Definition at line 84 of file perf_log.h.

Referenced by pause_for(), and start().

---

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

• include/utils/perf_log.h