API Reference: qbraid.interface

​
Generate random circuits

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

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

print(circuit)
Optionally specify number of qubits, circuit depth, and whether to measure over all qubits. 
circuit = random_circuit("cirq", num_qubits=2, depth=2, measure=True)

print(circuit)

​
Generate random unitaries

Generate random unitary matrices of any specified dimension (dim): 
from qbraid.interface import random_unitary_matrix

unitary = random_unitary_matrix(2)

print(unitary)

​
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)