Timer support and logging. More...

#include <vtkTimerLog.h>

Inheritance diagram for vtkTimerLog:

Collaboration diagram for vtkTimerLog:

Public Types
typedef vtkObject	Superclass
Public Member Functions
virtual const char *	GetClassName ()
virtual int	IsA (const char *type)
void	PrintSelf (ostream &os, vtkIndent indent)
void	StartTimer ()
void	StopTimer ()
double	GetElapsedTime ()
Static Public Member Functions
static vtkTimerLog *	New ()
static int	IsTypeOf (const char *type)
static vtkTimerLog *	SafeDownCast (vtkObject *o)
static void	DumpLog (const char *filename)
static void	MarkEvent (const char *EventString)
static void	ResetLog ()
static void	AllocateLog ()
static void	CleanupLog ()
static double	GetUniversalTime ()
static double	GetCPUTime ()
static double	GetCurrentTime ()

static void	SetLogging (int v)
static int	GetLogging ()
static void	LoggingOn ()
static void	LoggingOff ()

static void	SetMaxEntries (int a)
static int	GetMaxEntries ()

static void	FormatAndMarkEvent (const char *EventString,...)

static void	MarkStartEvent (const char *EventString)
static void	MarkEndEvent (const char *EventString)
static void	DumpLogWithIndents (ostream *os, double threshold)

static int	GetNumberOfEvents ()
static int	GetEventIndent (int i)
static double	GetEventWallTime (int i)
static const char *	GetEventString (int i)
Protected Member Functions
	vtkTimerLog ()
virtual	~vtkTimerLog ()
Static Protected Member Functions
static vtkTimerLogEntry *	GetEvent (int i)
static void	DumpEntry (ostream &os, int index, double time, double deltatime, int tick, int deltatick, const char *event)
Protected Attributes
double	StartTime
double	EndTime
Static Protected Attributes
static int	Logging
static int	Indent
static int	MaxEntries
static int	NextEntry
static int	WrapFlag
static int	TicksPerSecond
static vtkTimerLogEntry *	TimerLog
static timeval	FirstWallTime
static timeval	CurrentWallTime
static tms	FirstCpuTicks
static tms	CurrentCpuTicks

Detailed Description

Timer support and logging.

vtkTimerLog contains walltime and cputime measurements associated with a given event. These results can be later analyzed when "dumping out" the table.

In addition, vtkTimerLog allows the user to simply get the current time, and to start/stop a simple timer separate from the timing table logging.

Examples:: vtkTimerLog (Examples)

Tests:: vtkTimerLog (Tests)

Definition at line 82 of file vtkTimerLog.h.

Member Typedef Documentation

typedef vtkObject vtkTimerLog::Superclass

Reimplemented from vtkObject.

Definition at line 87 of file vtkTimerLog.h.

Constructor & Destructor Documentation

vtkTimerLog::vtkTimerLog ( ) [inline, protected]

Definition at line 183 of file vtkTimerLog.h.

virtual vtkTimerLog::~vtkTimerLog ( ) [inline, protected, virtual]

Definition at line 184 of file vtkTimerLog.h.

Member Function Documentation

static vtkTimerLog* vtkTimerLog::New ( ) [static]

Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

Reimplemented from vtkObject.

virtual const char* vtkTimerLog::GetClassName ( ) [virtual]

Reimplemented from vtkObject.

static int vtkTimerLog::IsTypeOf ( const char * name ) [static]

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

virtual int vtkTimerLog::IsA ( const char * name ) [virtual]

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

static vtkTimerLog* vtkTimerLog::SafeDownCast ( vtkObject * o ) [static]

Reimplemented from vtkObject.

void vtkTimerLog::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)		`[virtual]`

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

static void vtkTimerLog::SetLogging ( int v ) [inline, static]

This flag will turn loging of events off or on. By default, logging is on.

Definition at line 93 of file vtkTimerLog.h.

static int vtkTimerLog::GetLogging ( ) [inline, static]

This flag will turn loging of events off or on. By default, logging is on.

Definition at line 94 of file vtkTimerLog.h.

static void vtkTimerLog::LoggingOn ( ) [inline, static]

This flag will turn loging of events off or on. By default, logging is on.

Definition at line 95 of file vtkTimerLog.h.

static void vtkTimerLog::LoggingOff ( ) [inline, static]

This flag will turn loging of events off or on. By default, logging is on.

Definition at line 96 of file vtkTimerLog.h.

static void vtkTimerLog::SetMaxEntries ( int a ) [static]

Set/Get the maximum number of entries allowed in the timer log

static int vtkTimerLog::GetMaxEntries ( ) [static]

Set/Get the maximum number of entries allowed in the timer log

static void vtkTimerLog::FormatAndMarkEvent	(	const char *	EventString,
			...
	)		`[static]`

Record a timing event. The event is represented by a formatted string.

static void vtkTimerLog::DumpLog ( const char * filename ) [static]

Write the timing table out to a file. Calculate some helpful statistics (deltas and percentages) in the process.

static void vtkTimerLog::MarkStartEvent ( const char * EventString ) [static]

I want to time events, so I am creating this interface to mark events that have a start and an end. These events can be, nested. The standard Dumplog ignores the indents.

static void vtkTimerLog::MarkEndEvent ( const char * EventString ) [static]

I want to time events, so I am creating this interface to mark events that have a start and an end. These events can be, nested. The standard Dumplog ignores the indents.

static void vtkTimerLog::DumpLogWithIndents	(	ostream *	os,
		double	threshold
	)		`[static]`

I want to time events, so I am creating this interface to mark events that have a start and an end. These events can be, nested. The standard Dumplog ignores the indents.

static int vtkTimerLog::GetNumberOfEvents ( ) [static]

Programatic access to events. Indexed from 0 to num-1.

static int vtkTimerLog::GetEventIndent ( int i ) [static]

Programatic access to events. Indexed from 0 to num-1.

static double vtkTimerLog::GetEventWallTime ( int i ) [static]

Programatic access to events. Indexed from 0 to num-1.

static const char* vtkTimerLog::GetEventString ( int i ) [static]

Programatic access to events. Indexed from 0 to num-1.

static void vtkTimerLog::MarkEvent ( const char * EventString ) [static]

Record a timing event and capture wall time and cpu ticks.

static void vtkTimerLog::ResetLog ( ) [static]

Clear the timing table. walltime and cputime will also be set to zero when the first new event is recorded.

static void vtkTimerLog::AllocateLog ( ) [static]

Allocate timing table with MaxEntries elements.

static void vtkTimerLog::CleanupLog ( ) [static]

Remove timer log.

static double vtkTimerLog::GetUniversalTime ( ) [static]

Returns the elapsed number of seconds since January 1, 1970. This is also called Universal Coordinated Time.

static double vtkTimerLog::GetCPUTime ( ) [static]

Returns the CPU time for this process On Win32 platforms this actually returns wall time.

void vtkTimerLog::StartTimer ( )

Set the StartTime to the current time. Used with GetElapsedTime().

void vtkTimerLog::StopTimer ( )

Sets EndTime to the current time. Used with GetElapsedTime().

double vtkTimerLog::GetElapsedTime ( )

Returns the difference between StartTime and EndTime as a doubleing point value indicating the elapsed time in seconds.

static double vtkTimerLog::GetCurrentTime ( ) [static]

Deprecated:: Replaced by vtkTimerLog::GetUniversalTime() as of VTK 5.0.

static vtkTimerLogEntry* vtkTimerLog::GetEvent ( int i ) [static, protected]

static void vtkTimerLog::DumpEntry	(	ostream &	os,
		int	index,
		double	time,
		double	deltatime,
		int	tick,
		int	deltatick,
		const char *	event
	)		`[static, protected]`