Interface

Generate random circuits, unitary matrices, and test circuit equivalence.

API Reference: qbraid.interface

Generate random circuits

Generate a random quantum circuit object of any registered program type from qbraid.NATIVE_REGISTRY. For example:

Input

from qbraid import random_circuit

circuit = random_circuit("qiskit")  # Swap "cirq", "braket", "qasm3", etc.

print(circuit)

q_0: ─────────────■──────────────■─
                  │              │
q_1: ─────────────■──────────────X─
     ┌─────────────────────────┐ │
q_2: ┤ U(3.8035,5.0708,2.3633) ├─X─
     └─────────────────────────┘

Optionally specify number of qubits, circuit depth, and whether to measure over all qubits.

Input

circuit = random_circuit("cirq", num_qubits=2, depth=2, measure=True)

print(circuit)

q_0: ───×───Rz(1.34π)───────────M('c_0')───
        │
q_1: ───×───U3(0.0, 0.0, 0.0)───M('c_1')───

Generate random unitaries

Generate random unitary matrices of any specified dimension (dim):

Input

from qbraid.interface import random_unitary_matrix

unitary = random_unitary_matrix(2)

print(unitary)

[[-0.46060623-0.33349006j -0.82238991+0.01735275j]
 [ 0.48450787-0.66473935j  0.01019327+0.56856822j]]

Check circuit unitary equivalence

Check whether two quantum circuits have equivalent unitary representations, regardless of their types. All input circuits must be registered in qbraid.programs.NATIVE_REGISTRY. Below is an example demonstrating the comparison between two circuits that each create a Bell state using different quantum programming libraries (Cirq and Qiskit).

import cirq
import qiskit

from qbraid.interface import circuits_allclose

def cirq_bell():
    circuit = cirq.Circuit()
    q0, q1 = cirq.LineQubit.range(2)
    circuit.append(cirq.H(q0))
    circuit.append(cirq.CNOT(q0, q1))
    return circuit

def qiskit_bell():
    circuit = qiskit.QuantumCircuit(2)
    circuit.h(0)
    circuit.cx(0,1)
    return circuit

# Returns True if the unitary matrices of the two circuits are equivalent
print(circuits_allclose(cirq_bell(), qiskit_bell())) # Output: True

This function also supports several optional keyword arguments that allow customization of the equivalence checking process:

• index_contig: If set to True, maps both circuits to use sequential qubit indexing prior to computing their unitaries. Defaults to False.
• allow_rev_qubits: If set to True, allows the function to consider circuits as equivalent even if their qubits are in reversed order. Defaults to False.
• strict_gphase: If set to False, ignores differences in global phase between the circuits. Defaults to True.
• atol: Sets the absolute tolerance level for the numerical comparison of unitaries, using np.allclose. Defaults to 1e-7.

Here are some examples of how these arguments could be used:

# ignore global phase and use an increased error margin
circuits_allclose(circuit0, circuit1, strict_gphase=False, atol=1e-6)

# allow for non-sequential qubit indexing and reversed qubit order
circuits_allclose(circuit2, circuit3, index_contig=True, allow_rev_qubits=True)