libMesh::PerfData Class Reference

Data object managed by PerfLog. More...

#include <perf_log.h>

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

Public Attributes
double	tot_time
double	tot_time_incl_sub
struct timeval	tstart
struct timeval	tstart_incl_sub
unsigned int	count
bool	open
int	called_recursively

Protected Member Functions
double	stop_or_pause (const bool do_stop)

Detailed Description

Data object managed by PerfLog.

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

Author

Benjamin Kirk

Date

2003

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.

References stop_or_pause().

{
  return this->stop_or_pause(false);
}

pause_for()

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

inline

Definition at line 434 of file perf_log.h.

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

{
  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;
}

restart()

void libMesh::PerfData::restart ( )

inline

Definition at line 390 of file perf_log.h.

References tstart.

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

start()

void libMesh::PerfData::start ( )

inline

Definition at line 379 of file perf_log.h.

References called_recursively, count, tstart, and tstart_incl_sub.

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

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

stop_or_pause()

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

inlineprotected

Definition at line 405 of file perf_log.h.

References tot_time, tot_time_incl_sub, tstart, and tstart_incl_sub.

Referenced by pause(), and stopit().

{
  // 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;
}

stopit()

double libMesh::PerfData::stopit ( )

inline

Definition at line 452 of file perf_log.h.

References called_recursively, and stop_or_pause().

{
  // stopit is just similar to pause except that it decrements the
  // recursive call counter

  this->called_recursively--;
  return this->stop_or_pause(true);
}

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(), start(), and stop_or_pause().

---

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

• perf_log.h