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 ()
PerfData &	operator+= (const PerfData &other)
	Sums timing results from other. More...

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 53 of file perf_log.h.

Constructor & Destructor Documentation

PerfData()

libMesh::PerfData::PerfData ( )

inline

Constructor.

Initializes data to be empty.

Definition at line 60 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

operator+=()

PerfData& libMesh::PerfData::operator+= ( const PerfData &  other )

inline

Sums timing results from other.

Definition at line 115 of file perf_log.h.

References count, libMesh::libmesh_assert(), open, tot_time, and tot_time_incl_sub.

  {
    libmesh_assert(!open);
    tot_time += other.tot_time;
    tot_time_incl_sub += other.tot_time_incl_sub;
    count += other.count;

    return *this;
  }

pause()

double libMesh::PerfData::pause ( )

inline

Definition at line 426 of file perf_log.h.

{
  return this->stop_or_pause(false);
}

pause_for()

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

inline

Definition at line 462 of file perf_log.h.

References called_recursively, count, gettimeofday(), tstart, libMesh::PerfLog::tstart, tstart_incl_sub, timeval::tv_sec, and timeval::tv_usec.

{
  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 418 of file perf_log.h.

References gettimeofday(), and libMesh::PerfLog::tstart.

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

start()

void libMesh::PerfData::start ( )

inline

Definition at line 407 of file perf_log.h.

References gettimeofday(), and libMesh::PerfLog::tstart.

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 433 of file perf_log.h.

References gettimeofday(), libMesh::PerfLog::tstart, timeval::tv_sec, and timeval::tv_usec.

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

Member Data Documentation

called_recursively

int libMesh::PerfData::called_recursively

Definition at line 125 of file perf_log.h.

Referenced by pause_for().

count

unsigned int libMesh::PerfData::count

The number of times this event has been executed.

Definition at line 97 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), operator+=(), and pause_for().

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 104 of file perf_log.h.

Referenced by operator+=().

tot_time

double libMesh::PerfData::tot_time

Total time spent in this event.

Definition at line 74 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), and operator+=().

tot_time_incl_sub

double libMesh::PerfData::tot_time_incl_sub

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

Definition at line 79 of file perf_log.h.

Referenced by libMesh::PerfLog::get_perf_info(), and operator+=().

tstart

struct timeval libMesh::PerfData::tstart

Structure defining when the event was last started.

Definition at line 85 of file perf_log.h.

Referenced by pause_for().

tstart_incl_sub

struct timeval libMesh::PerfData::tstart_incl_sub

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

Definition at line 91 of file perf_log.h.

Referenced by pause_for().

---

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

• include/utils/perf_log.h