Struct Circuit 

pub struct Circuit { /* private fields */ }

A quantum circuit builder that constructs a tensor network representing a quantum circuit.

Implementations

impl Circuit

pub fn num_qubits(&self) -> usize

Returns the total number of qubits allocated in this circuit.

Examples

let mut circuit = Circuit::default();
let q1 = circuit.allocate_register(2);
let q2 = circuit.allocate_register(3);
assert_eq!(circuit.num_qubits(), 5);

pub fn allocate_register<'a>(&mut self, size: usize) -> QuantumRegister<'a>

Allocates a new quantum register. The qubits are initialized in the |0> state.

pub fn append_gate(&mut self, gate: TensorData, indices: &[Qubit<'_>])

Appends a gate to the circuit on the specified qubits.

pub fn into_amplitude_network(self, bitstring: &str) -> (Tensor, Permutor)

Converts the circuit to a tensor network that computes the amplitude for the given bitstring.

The bitstring can also contain wildcards *, in which case the tensor leg corresponding to this qubit is left open. For every wildcard, the output tensor will be doubled in size. In the extreme case where there’s only wildcards, the full statevector will be computed.

Since the final tensor can end up with arbitrary permutation, a Permutor is returned that can transpose the final tensor after contraction to the natural order, i.e., sorted by increasing qubit number. If the bitstring contains no wildcards, the final result is a scalar and the permutator can be ignored.

pub fn into_statevector_network(self) -> (Tensor, Permutor)

Converts the circuit to a tensor network that computes the full statevector.

Since the final tensor can end up with arbitrary permutation, a Permutor is returned that can transpose the final tensor after contraction to the natural order, i.e., sorted by increasing qubit number.

pub fn into_expectation_value_network(self) -> Tensor

Converts the circuit to a tensor network that computes the expectation value with respect to standard observables (Z) on all qubits.

The tensor network is roughly twice the size of the circuit, as it needs to compute the adjoint of the circuit as well.

Trait Implementations

impl Debug for Circuit

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Circuit

fn default() -> Circuit

Returns the “default value” for a type.