Node

class samplomatic.samplex.nodes.Node

Bases: object

Parent class for samplex node operations.

Attributes Summary

NODE_REGISTRY
num_parameters	The number of parameter values this node requires at sampling time.
outgoing_register_type	The virtual gate type of outgoing registers.
parameter_idxs	Which evaluated parameter expressions this node needs access to at sampling time.

Methods Summary

get_style()	Return the style of this node when plotted.
instantiates()	Return a manifest of new virtual registers that this node instantiates.
outputs_to()	Return the set of names of outputs this node mutates.
reads_from()	Return a manifest of which virtual register values this node needs to read from.
removes()	Return a manifest of virtual registers that this node removes.
validate_and_update(register_descriptions)	Validate provided register descriptions are compatible, update with changes.
writes_to()	Return a manifest of which virtual register values this node needs to write to.

Attributes Documentation

NODE_REGISTRY: set[type[Node]] = {<class 'samplomatic.samplex.nodes.change_basis_node.ChangeBasisNode'>, <class 'samplomatic.samplex.nodes.collect_template_values.CollectTemplateValues'>, <class 'samplomatic.samplex.nodes.collect_z2_to_output_node.CollectZ2ToOutputNode'>, <class 'samplomatic.samplex.nodes.combine_registers_node.CombineRegistersNode'>, <class 'samplomatic.samplex.nodes.conversion_node.ConversionNode'>, <class 'samplomatic.samplex.nodes.inject_noise_node.InjectNoiseNode'>, <class 'samplomatic.samplex.nodes.multiplication_node.LeftMultiplicationNode'>, <class 'samplomatic.samplex.nodes.multiplication_node.RightMultiplicationNode'>, <class 'samplomatic.samplex.nodes.pauli_past_clifford_node.PauliPastCliffordNode'>, <class 'samplomatic.samplex.nodes.slice_register_node.SliceRegisterNode'>, <class 'samplomatic.samplex.nodes.twirl_sampling_node.TwirlSamplingNode'>, <class 'samplomatic.samplex.nodes.u2_param_multiplication_node.LeftU2ParametricMultiplicationNode'>, <class 'samplomatic.samplex.nodes.u2_param_multiplication_node.RightU2ParametricMultiplicationNode'>}

num_parameters

The number of parameter values this node requires at sampling time.

outgoing_register_type

The virtual gate type of outgoing registers.

parameter_idxs

Which evaluated parameter expressions this node needs access to at sampling time.

Methods Documentation

get_style() → NodeStyle

Return the style of this node when plotted.

instantiates() → dict[str, tuple[int, VirtualType]]

Return a manifest of new virtual registers that this node instantiates.

Note

• To change the type or size of a register, both instantiate and remove it.

• Do not specify reads_from() or writes_to() for an instantiated register, these powers are implicit.

outputs_to() → set[str]

Return the set of names of outputs this node mutates.

reads_from() → dict[str, tuple[set[int], VirtualType]]

Return a manifest of which virtual register values this node needs to read from.

removes() → set[str]

Return a manifest of virtual registers that this node removes.

It is assumed that registers are removed as a last step; it is not ill-defined to read and write from a removed register.

validate_and_update(register_descriptions: dict[str, tuple[int, VirtualType]])

Validate provided register descriptions are compatible, update with changes.

This method can be used by a samplex to determine when a node execution order has well-defined dependencies before sampling begins.

Parameters:

register_descriptions – A map from existing register names to their size and type.

writes_to() → dict[str, tuple[set[int], VirtualType]]

Return a manifest of which virtual register values this node needs to write to.