qpandalite.circuit_builder package

Submodules

qpandalite.circuit_builder.qcircuit module

Quantum circuit builder with OriginIR and OpenQASM 2.0 output.

This module provides a Circuit class for building quantum circuits programmatically. It supports various quantum gates, controlled operations, dagger (adjoint) blocks, and measurement operations. The circuit can be exported to OriginIR or OpenQASM format.

Key exports:

Circuit: Main quantum circuit builder class. OpcodeType: Type alias for opcode tuples.

class qpandalite.circuit_builder.qcircuit.Circuit

基类：object

Quantum circuit builder that generates OriginIR and OpenQASM output.

used_qubit_list

Qubits referenced in the circuit.

Type:

list[int]

circuit_str

Raw string builder used by context managers.

Type:

str

max_qubit

Highest qubit index used.

Type:

int

qubit_num

Total number of qubits.

Type:

int

cbit_num

Total number of classical bits.

Type:

int

measure_list

Qubits scheduled for measurement.

Type:

list[int]

opcode_list

Internal list of gate opcodes.

Type:

list[OpCode]

add_circuit(other)

Add all gates from another circuit into this circuit.

参数:

other (Circuit)

返回类型:

None

add_gate(operation, qubits, cbits=None, params=None, dagger=False, control_qubits=None)

Add a gate to the circuit.

参数:

• operation (str)

• qubits (int | list[int])

• cbits (int | list[int] | None)

• params (float | list[float] | tuple[float, ...] | None)

• dagger (bool)

• control_qubits (int | list[int])

返回类型:

None

barrier(*qubits)

Insert a barrier across the specified qubits.

参数:

*qubits (int) -- Qubit indices to include in the barrier.

返回类型:

None

cbit_num: int

property circuit: str

Generate the circuit in OriginIR format.

circuit_str: str

cnot(controller, target)

Apply CNOT (controlled-X) gate.

参数:

• controller (int) -- Control qubit index.

• target (int) -- Target qubit index.

返回类型:

None

control(*args)

Return a context manager that wraps gates in a CONTROL block.

All gates added inside the with block will be executed only when all specified control qubits are in state |1>.

参数:

*args (int) -- One or more control qubit indices.

返回:

A CircuitControlContext context manager.

抛出:

ValueError -- No control qubits were supplied.

返回类型:

CircuitControlContext

copy()

Return a deep copy of this circuit.

返回类型:

Circuit

cswap(q1, q2, q3)

Apply CSWAP (Fredkin) gate to three qubits.

参数:

• q1 (int)

• q2 (int)

• q3 (int)

返回类型:

None

cx(controller, target)

Apply CX gate (alias for CNOT).

参数:

• controller (int) -- Control qubit index.

• target (int) -- Target qubit index.

返回类型:

None

cz(q1, q2)

Apply controlled-Z gate to two qubits.

参数:

• q1 (int)

• q2 (int)

返回类型:

None

dagger()

Return a context manager that wraps gates in a DAGGER block.

All gates added inside the with block will be conjugate-transposed (adjoint).

返回:

A CircuitDagContext context manager.

返回类型:

CircuitDagContext

property depth: int

Calculate the depth of the quantum circuit.

h(qn)

Apply single-qubit Hadamard gate to qubit.

参数:

qn (int)

返回类型:

None

identity(qn)

Apply the identity (no-op) gate to qubit.

参数:

qn (int)

返回类型:

None

iswap(q1, q2)

Apply iSWAP gate to two qubits.

参数:

• q1 (int)

• q2 (int)

返回类型:

None

max_qubit: int

measure(*qubits)

Schedule qubits for measurement.

Appends the given qubits to the measurement list. Multiple calls accumulate measurements; classical bit indices are assigned in the order qubits are added.

参数:

*qubits (int) -- One or more qubit indices to measure.

抛出:

ValueError -- Called inside an active CONTROL or DAGGER context block.

返回类型:

None

measure_list: list[int]

opcode_list: list[tuple[str, int | list[int], int | list[int] | None, float | list[float] | tuple[float, ...] | None, bool, int | list[int]]]

property originir: str

Generate the circuit in OriginIR format.

phase2q(q1, q2, theta1, theta2, thetazz)

Apply two-qubit phase gate with local and ZZ terms.

参数:

• q1 (int) -- First qubit index.

• q2 (int) -- Second qubit index.

• theta1 (float) -- Local phase angle for q1 in radians.

• theta2 (float) -- Local phase angle for q2 in radians.

• thetazz (float) -- ZZ interaction angle in radians.

返回类型:

None

property qasm: str

Generate the circuit in OpenQASM format.

qubit_num: int

record_qubit(qubits)

Record the qubits used in the circuit.

参数:

qubits (int | list[int])

返回类型:

None

remapping(mapping)

Create a new circuit with qubits remapped according to mapping.

参数:

mapping (dict[int, int])

返回类型:

Circuit

rphi(qn, theta, phi)

Apply RPhi rotation gate.

参数:

• qn (int) -- Target qubit index.

• theta (float) -- Polar rotation angle in radians.

• phi (float) -- Azimuthal angle in radians.

返回类型:

None

rx(qn, theta)

Apply RX rotation gate.

参数:

• qn (int) -- Target qubit index.

• theta (float) -- Rotation angle in radians.

返回类型:

None

ry(qn, theta)

Apply RY rotation gate.

参数:

• qn (int) -- Target qubit index.

• theta (float) -- Rotation angle in radians.

返回类型:

None

rz(qn, theta)

Apply RZ rotation gate.

参数:

• qn (int) -- Target qubit index.

• theta (float) -- Rotation angle in radians.

返回类型:

None

s(qn)

Apply S (phase) gate to qubit.

参数:

qn (int)

返回类型:

None

sdg(qn)

Apply S-dagger (inverse phase) gate to qubit.

参数:

qn (int)

返回类型:

None

set_control(*args)

Manually open a CONTROL block (low-level API; prefer control()).

参数:

*args (int) -- Control qubit indices.

返回类型:

None

set_dagger()

Manually open a DAGGER block (low-level API; prefer dagger()).

返回类型:

None

swap(q1, q2)

Apply SWAP gate to two qubits.

参数:

• q1 (int)

• q2 (int)

返回类型:

None

sx(qn)

Apply square-root-of-X (SX) gate to qubit.

参数:

qn (int)

返回类型:

None

sxdg(qn)

Apply conjugate-transpose of SX gate to qubit.

参数:

qn (int)

返回类型:

None

t(qn)

Apply T gate to qubit.

参数:

qn (int)

返回类型:

None

tdg(qn)

Apply T-dagger (inverse T) gate to qubit.

参数:

qn (int)

返回类型:

None

toffoli(q1, q2, q3)

Apply Toffoli (CCNOT) gate to three qubits.

参数:

• q1 (int)

• q2 (int)

• q3 (int)

返回类型:

None

u1(qn, lam)

Apply U1 single-parameter unitary gate.

参数:

• qn (int) -- Target qubit index.

• lam (float) -- Phase angle lambda in radians.

返回类型:

None

u2(qn, phi, lam)

Apply U2 two-parameter unitary gate.

参数:

• qn (int) -- Target qubit index.

• phi (float) -- Phi angle in radians.

• lam (float) -- Lambda angle in radians.

返回类型:

None

u3(qn, theta, phi, lam)

Apply U3 three-parameter unitary gate.

参数:

• qn (int) -- Target qubit index.

• theta (float) -- Theta angle in radians.

• phi (float) -- Phi angle in radians.

• lam (float) -- Lambda angle in radians.

返回类型:

None

unset_control()

Manually close a CONTROL block (low-level API; prefer control()).

返回类型:

None

unset_dagger()

Manually close a DAGGER block (low-level API; prefer dagger()).

返回类型:

None

used_qubit_list: list[int]

uu15(q1, q2, params)

Apply general two-qubit UU15 gate with 15 parameters.

参数:

• q1 (int) -- First qubit index.

• q2 (int) -- Second qubit index.

• params (list[float]) -- List of 15 rotation parameters in radians.

返回类型:

None

x(qn)

Apply Pauli-X (NOT) gate to qubit.

参数:

qn (int)

返回类型:

None

xx(q1, q2, theta)

Apply XX Ising interaction gate.

参数:

• q1 (int) -- First qubit index.

• q2 (int) -- Second qubit index.

• theta (float) -- Interaction angle in radians.

返回类型:

None

y(qn)

Apply Pauli-Y gate to qubit.

参数:

qn (int)

返回类型:

None

yy(q1, q2, theta)

Apply YY Ising interaction gate.

参数:

• q1 (int) -- First qubit index.

• q2 (int) -- Second qubit index.

• theta (float) -- Interaction angle in radians.

返回类型:

None

z(qn)

Apply Pauli-Z gate to qubit.

参数:

qn (int)

返回类型:

None

zz(q1, q2, theta)

Apply ZZ Ising interaction gate.

参数:

• q1 (int) -- First qubit index.

• q2 (int) -- Second qubit index.

• theta (float) -- Interaction angle in radians.

返回类型:

None

Module contents