Custom widget that renders the network topology and quantum state. More...

Inheritance diagram for q2nsviz.ui.canvas.NetworkCanvas:

Collaboration diagram for q2nsviz.ui.canvas.NetworkCanvas:

Public Member Functions
	set_snapshot (self, Snapshot snap)
	Display the state carried by snap and repaint.

	reset (self)
	Clear all transient qubit sets and repaint an empty canvas.

	mouseMoveEvent (self, event)
	Hit-test nodes and in-flight qubits on hover and update the tooltip.

	paintEvent (self, event)
	Render one frame of the network visualization.

bool	toggle_legend (self)
	Toggle legend visibility and repaint.

bool	toggle_node_labels (self)
	Toggle node label visibility and repaint.

	apply_theme (self)
	Repaint the canvas with the currently active color palette.

Public Attributes
	state_manager

	current_time

	inflight_qubits

	removed_qubits

	gate_qubits

	measuring_qubits

	graph_measuring_qubits

	inflight_cbits

	removed_cbits

	lost_qubits

	entangled_qubits

	NODE_WIDTH

	QUBIT_RADIUS

	CHANNEL_WIDTH

Static Public Attributes
int	NODE_WIDTH = 120

int	NODE_HEIGHT = 70

int	QUBIT_RADIUS = 8

int	CHANNEL_WIDTH = 6

int	LAYOUT_MARGIN_X = 100

int	LAYOUT_MARGIN_Y = 75

int	LEGEND_RESERVE = 210

Detailed Description

Custom widget that renders the network topology and quantum state.

Paint order (back to front)

Background fill
Channel lines
Node boxes (each with its resident qubits and classical bits)
Lost-qubit crosses
Measured-qubit markers
In-flight qubits (colored circles on the channel lane)
In-flight classical packets (sendPacket)
In-flight classical bits (sendCbit)
Entanglement links (colored lines between qubit circles)
Legend overlay (optional)
Current-time traceText overlay

A qubit inside an operation window wears a ring whose style names the operation: dashed single for entangle, solid single for measure, solid double for graphMeasure.

The widget owns no state of its own beyond the Snapshot pushed by the QuantumVisualizerWindow controller via set_snapshot() and the qubit sets derived from it. The shared state_manager is read only for the static topology and the raw event list (in-flight animation geometry and traceText overlays). The widget is not thread-safe; call only from the Qt main thread.

Definition at line 32 of file canvas.py.

Member Function Documentation

◆ apply_theme()

q2nsviz.ui.canvas.NetworkCanvas.apply_theme ( self )

Repaint the canvas with the currently active color palette.

Call after toggle_dark() to reflect palette changes.

Definition at line 912 of file canvas.py.

Referenced by q2nsviz.ui.window.QuantumVisualizerWindow.load_file().

Here is the caller graph for this function:

◆ mouseMoveEvent()

q2nsviz.ui.canvas.NetworkCanvas.mouseMoveEvent	(	self,
		event
	)

Hit-test nodes and in-flight qubits on hover and update the tooltip.

Tests each node bounding box first; on a miss, scans in-flight qubits. Updates the Qt tooltip text so the OS displays it near the cursor.

Parameters

event Qt mouse-move event providing the current cursor position.

Definition at line 142 of file canvas.py.

Referenced by q2nsviz.ui.canvas.NetworkCanvas.mouseMoveEvent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ paintEvent()

q2nsviz.ui.canvas.NetworkCanvas.paintEvent	(	self,
		event
	)

Render one frame of the network visualization.

Computes node and qubit screen positions once, then executes the layered draw passes listed in the class docstring. Caches qubit positions in _qubit_positions_cache for use by the tooltip hit-test in mouseMoveEvent.

Definition at line 174 of file canvas.py.

Here is the call graph for this function:

◆ reset()

q2nsviz.ui.canvas.NetworkCanvas.reset ( self )

Clear all transient qubit sets and repaint an empty canvas.

Called when the user loads a new file or the application starts.

Definition at line 120 of file canvas.py.

Referenced by q2nsviz.logic.SimulationStateManager.load_events().

Here is the caller graph for this function:

◆ set_snapshot()

q2nsviz.ui.canvas.NetworkCanvas.set_snapshot	(		self,
		Snapshot	snap
	)

Display the state carried by snap and repaint.

Called by the QuantumVisualizerWindow controller, which performs the per-frame snapshot_at() query and pushes the resulting Snapshot here. Unpacks the inflight, removed, and in-progress-operation qubit sets, then triggers a full repaint. Must be called from the Qt main thread.

Parameters