Records execution trace during graph simulation. More...

#include <GraphExecutionTracer.h>

Public Member Functions
	GraphExecutionTracer ()

	~GraphExecutionTracer ()

void	Reset ()
	Clears all recorded events and resets state.

void	RecordNodeEntered (int32_t nodeId, const std::string &nodeName, const std::string &nodeType)
	Records that execution entered a node.

void	RecordNodeExited (int32_t nodeId, int32_t nextNodeId)
	Records that execution exited a node successfully.

void	RecordConditionEvaluated (int32_t nodeId, const std::string &expression, bool result, const std::string &message="")
	Records a condition evaluation result.

void	RecordBranchTaken (int32_t nodeId, const std::string &branchName, int32_t nextNodeId)
	Records that a branch was taken based on condition.

void	RecordError (int32_t nodeId, const std::string &nodeName, const std::string &errorMessage, const std::string &severity="Error")
	Records an execution error.

void	RecordExecutionBlocked (int32_t nodeId, const std::string &reason)
	Records that execution was blocked (dead-end, etc.).

void	RecordDataPinResolved (int32_t nodeId, const std::string &pinName, const std::string &value)
	Records data pin resolution.

void	RecordExecutionCompleted (bool success, const std::string &message)
	Records graph execution completion.

const std::vector< ExecutionEvent > &	GetEvents () const
	Returns all recorded events.

int32_t	GetStepCount () const
	Returns the number of steps executed.

bool	HasErrors () const
	Returns true if any errors were recorded.

const std::vector< int32_t > &	GetErrorNodes () const
	Returns the set of node IDs that encountered errors.

std::string	GetTraceLog () const
	Returns a formatted trace log as a multi-line string.

std::string	GetExecutionSummary () const
	Returns a summary of the execution (steps, errors, etc.).

Private Member Functions
void	AddEvent (const ExecutionEvent &event)

Private Attributes
std::vector< ExecutionEvent >	m_events

std::vector< int32_t >	m_errorNodes

int32_t	m_stepCount = 0

bool	m_executionComplete = false

bool	m_executionSuccess = false

Detailed Description

Records execution trace during graph simulation.

Used by GraphExecutionSimulator to capture execution flow. Can be queried to understand why a graph failed or which path was taken.

Definition at line 70 of file GraphExecutionTracer.h.

Constructor & Destructor Documentation

◆ GraphExecutionTracer()

Olympe::GraphExecutionTracer::GraphExecutionTracer ( )

Definition at line 15 of file GraphExecutionTracer.cpp.

◆ ~GraphExecutionTracer()

Olympe::GraphExecutionTracer::~GraphExecutionTracer ( )

Definition at line 20 of file GraphExecutionTracer.cpp.

Member Function Documentation

◆ AddEvent()

void Olympe::GraphExecutionTracer::AddEvent ( const ExecutionEvent & event )

private

Definition at line 240 of file GraphExecutionTracer.cpp.

References GetComponentTypeID_Static(), and m_events.

Referenced by RecordBranchTaken(), RecordConditionEvaluated(), RecordDataPinResolved(), RecordError(), RecordExecutionBlocked(), RecordExecutionCompleted(), RecordNodeEntered(), and RecordNodeExited().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetErrorNodes()

const std::vector< int32_t > & Olympe::GraphExecutionTracer::GetErrorNodes ( ) const

inline

Returns the set of node IDs that encountered errors.

Definition at line 164 of file GraphExecutionTracer.h.

References m_errorNodes.

◆ GetEvents()

const std::vector< ExecutionEvent > & Olympe::GraphExecutionTracer::GetEvents ( ) const

inline

Returns all recorded events.

Definition at line 149 of file GraphExecutionTracer.h.

References m_events.

Referenced by Olympe::ExecutionTestPanel::DisplayTrace(), and Olympe::ExecutionTestPanel::RenderTraceLog().

Here is the caller graph for this function:

◆ GetExecutionSummary()

std::string Olympe::GraphExecutionTracer::GetExecutionSummary ( ) const

Returns a summary of the execution (steps, errors, etc.).

Definition at line 204 of file GraphExecutionTracer.cpp.

References Olympe::ConditionEvaluated, Olympe::ErrorOccurred, GetComponentTypeID_Static(), m_errorNodes, m_events, m_executionComplete, m_executionSuccess, m_stepCount, and Olympe::NodeEntered.

Referenced by Olympe::ExecutionTestPanel::GetTestSummary(), Olympe::ExecutionTestPanel::RenderSummary(), and Olympe::ExecutionTestPanel::RunExecutionTest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetStepCount()

int32_t Olympe::GraphExecutionTracer::GetStepCount ( ) const

inline

Returns the number of steps executed.

Definition at line 154 of file GraphExecutionTracer.h.

References m_stepCount.

◆ GetTraceLog()

std::string Olympe::GraphExecutionTracer::GetTraceLog ( ) const

Returns a formatted trace log as a multi-line string.

Definition at line 144 of file GraphExecutionTracer.cpp.

References Olympe::BranchTaken, Olympe::ConditionEvaluated, Olympe::DataPinResolved, Olympe::ErrorOccurred, Olympe::ExecutionBlocked, Olympe::ExecutionCompleted, GetComponentTypeID_Static(), m_errorNodes, m_events, m_executionComplete, m_executionSuccess, m_stepCount, Olympe::NodeEntered, Olympe::NodeExited, and Olympe::ExecutionEvent::nodeId.

Referenced by Olympe::ExecutionTestPanel::GetExecutionLog(), and Olympe::ExecutionTestPanel::RenderSummary().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HasErrors()

bool Olympe::GraphExecutionTracer::HasErrors ( ) const

inline

Returns true if any errors were recorded.

Definition at line 159 of file GraphExecutionTracer.h.

References m_errorNodes.

◆ RecordBranchTaken()

void Olympe::GraphExecutionTracer::RecordBranchTaken	(	int32_t	nodeId,
		const std::string &	branchName,
		int32_t	nextNodeId
	)

Records that a branch was taken based on condition.

Parameters

nodeId	ID of the branch node.
branchName	Name of the branch taken ("True", "False", case name, etc.).
nextNodeId	ID of the node being branched to.

Definition at line 79 of file GraphExecutionTracer.cpp.

References AddEvent(), Olympe::BranchTaken, GetComponentTypeID_Static(), m_stepCount, and Olympe::ExecutionEvent::type.

Here is the call graph for this function:

◆ RecordConditionEvaluated()

void Olympe::GraphExecutionTracer::RecordConditionEvaluated	(	int32_t	nodeId,
		const std::string &	expression,
		bool	result,
		const std::string &	message = `""`
	)

Records a condition evaluation result.

Parameters

nodeId	ID of the node containing the condition.
expression	String representation of the condition.
result	Whether the condition evaluated to true.
message	Optional additional details.

Definition at line 62 of file GraphExecutionTracer.cpp.

References AddEvent(), Olympe::ConditionEvaluated, GetComponentTypeID_Static(), m_stepCount, and Olympe::ExecutionEvent::type.

Here is the call graph for this function:

◆ RecordDataPinResolved()

void Olympe::GraphExecutionTracer::RecordDataPinResolved	(	int32_t	nodeId,
		const std::string &	pinName,
		const std::string &	value
	)

Records data pin resolution.

Parameters

nodeId	ID of the node.
pinName	Name of the pin.
value	Resolved value as string.

Definition at line 121 of file GraphExecutionTracer.cpp.

References AddEvent(), Olympe::DataPinResolved, GetComponentTypeID_Static(), m_stepCount, and Olympe::ExecutionEvent::type.

Here is the call graph for this function:

◆ RecordError()

void Olympe::GraphExecutionTracer::RecordError	(	int32_t	nodeId,
		const std::string &	nodeName,
		const std::string &	errorMessage,
		const std::string &	severity = `"Error"`
	)

Records an execution error.

Parameters

nodeId	ID of the node where error occurred (NODE_INDEX_NONE for graph-level).
nodeName	Name of the node (if applicable).
errorMessage	Description of the error.
severity	"Error" or "Critical".

Definition at line 89 of file GraphExecutionTracer.cpp.

References AddEvent(), Olympe::ErrorOccurred, GetComponentTypeID_Static(), m_errorNodes, m_stepCount, and Olympe::ExecutionEvent::type.

Here is the call graph for this function: