TwirlSamplingNode

class samplomatic.samplex.nodes.TwirlSamplingNode(lhs_register_name: str, rhs_register_name: str, distribution: Distribution)

Bases: SamplingNode

A node that produces samples for twirling.

Parameters:

• lhs_register_name – The name of the register to store the samples.

• rhs_register_name – The name of the register to store the inverses of the samples.

• distribution – The distribution to draw samples from.

Attributes Summary

outgoing_register_type

The virtual gate type of outgoing registers.

Methods Summary

get_style()	Return the style of this node when plotted.
instantiates()	Return a manifest of new virtual registers that this node instantiates.
sample(registers, rng, inputs, ...)	Sample this node.

Attributes Documentation

outgoing_register_type

Methods Documentation

get_style()

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.

sample(registers, rng, inputs, num_randomizations)

Sample this node.

Parameters:

• registers – Where to sample into.

• rng – A randomness generator.

• inputs – Inputs of the sampling program.

• num_randomizations – How many randomizations to draw.