quri_parts.circuit.transpile package#

class CircuitTranspilerProtocol(*args, **kwargs)#

Bases: Protocol

Protocol of callable class that transpiles NonParametricQuantumCircuit to NonParametricQuantumCircuit.

class GateDecomposer(*args, **kwargs)#

Bases: CircuitTranspilerProtocol, ABC

Abstract class that represents CircuitTranspiler, such that target gates are selected by decision function and each target gate is replaced by a sequence of multiple gates.

abstract is_target_gate(gate)#

Determine if a given gate is subject to decomposition.

Parameters:: gate (QuantumGate) – Gates in the circuit that are scanned from the front.
Return type:: bool

abstract decompose(gate)#

Describe the specific decomposition process. Only the target gates satisfying is_target_gate() method are passed.

Parameters:: gate (QuantumGate) – The gates to be decomposed.
Return type:: Sequence[QuantumGate]

class GateKindDecomposer(*args, **kwargs)#

Bases: GateDecomposer, ABC

Abstract class that represents CircuitTranspiler, such that each gate is identified by its gate name and the target gate is replaced by a sequence of multiple gates.

Classes inheriting from this class can be used for ParallelDecomposer.

abstract property target_gate_names: Sequence[str]#: Returns the set of gate names to be decomposed.

is_target_gate(gate)#

Determine if a given gate is subject to decomposition.

Parameters:: gate (QuantumGate) – Gates in the circuit that are scanned from the front.
Return type:: bool

class ParallelDecomposer(decomposers)#

Bases: CircuitTranspilerProtocol

CircuitTranspiler, which executes given GateKindDecomposer within a single loop traversing the gate from the front.

Parameters:: decomposers (Sequence[GateKindDecomposer]) – Sequence of GateKindDecomposer with no duplicate gate types to act on.

class SequentialTranspiler(transpilers)#

Bases: CircuitTranspilerProtocol

CircuitTranspiler, which applies CircuitTranspilers in sequence.

Parameters:: transpilers (Sequence[CircuitTranspiler]) – Sequence of CircuitTranspilers.

Examples

transpiler = SequentialTranspiler(
    [
        ATranspiler(),
        BTranspiler(arg..),
        ..
    ]
)
circuit = transpiler(circuit)

RZSetTranspiler()#: CircuitTranspiler to transpile a QuntumCircuit into another QuantumCircuit containing only X, SqrtX, CNOT, and RZ. (UnitaryMatrix gate for 3 or more qubits are not decomposed.)

RotationSetTranspiler()#: CircuitTranspiler to transpile a QuntumCircuit into another QuantumCircuit containing only RX, RY, RZ, and CNOT. (UnitaryMatrix gate for 3 or more qubits are not decomposed.)

class CliffordRZSetTranspiler(epsilon=1e-09)#

Bases: SequentialTranspiler

CircuitTranspiler to transpile a QuntumCircuit into another QuantumCircuit containing only H, X, Y, Z, SqrtX, SqrtXdag, SqrtY, SqrtYdag, S, Sdg, RZ, CZ, and CNOT.

Since this transpiler involves fusing rotation gates, converting rotation gates to named gates with a certain precision, and removing Identity gates, the action of the circuit before and after the conversion may not be completely equivalent.

Parameters:: epsilon (float) –

class CliffordApproximationTranspiler(*args, **kwargs)#

Bases: GateDecomposer

CircuitTranspiler, which replaces the non_clifford gate into sequence of non-parametric Clifford gates.

If the input gate has angles, this transpiler replaces them with the closest value in the set \(\{\pi n /2| n\in\mathbb{Z}\}\). Then by using the rotation gate transpilers, it is decomposed into a sequence of non-parametric Clifford gates.

is_target_gate(gate)#

Determine if a given gate is subject to decomposition.

Parameters:: gate (QuantumGate) – Gates in the circuit that are scanned from the front.
Return type:: bool

decompose(gate)#

Describe the specific decomposition process. Only the target gates satisfying is_target_gate() method are passed.

Parameters:: gate (QuantumGate) – The gates to be decomposed.
Return type:: Sequence[QuantumGate]

class IdentityEliminationTranspiler(*args, **kwargs)#

Bases: CircuitTranspilerProtocol

Generate a new circuit by removing all Identity gates from the given circuit.

class IdentityInsertionTranspiler#

Bases: CircuitTranspilerProtocol

If there are qubits to which any gate has not been applied, Identity gates are added for those qubits.

The application of this transpiler ensures that every qubit has at least one gate acting on it.

class Identity2RZTranspiler(*args, **kwargs)#

quri_parts.circuit.transpile package#

Submodules#