z iSrSSKJr SSKJrJrJr SSKJr SSK J r SSK J r SSK Jr SSKJr SS KJrJr "S S \ 5rg ) zG A generic InverseCancellation pass for any set of gate-inverse pairs. ) annotations)ListTupleUnion)Gate) DAGCircuit)TransformationPass)TranspilerError) control_flow)inverse_cancellation'run_inverse_cancellation_standard_gatescf^\rSrSrSrSSU4Sjjjr\RSSj5rSr U=r $) InverseCancellation zUCancel specific Gates which are inverses of each other when they occur back-to- back.c>/Ul/Ul[5Ul[5UlX lUc SUlGOSUlUHn[U[5(a.X3R5:wa[SURS35eMF[U[5(af[U5S:wa[SUS35eUS US R5:wa,[SUS RS US RS 35eM[S [U5S35e UHn[U[5(aBURRU5 URR!UR5 MZURRU5 URR#SU55 M [$TU]M5 g)aInitialize InverseCancellation pass. Args: gates_to_cancel: List describing the gates to cancel. Each element of the list is either a single gate or a pair of gates. If a single gate, then it should be self-inverse. If a pair of gates, then the gates in the pair should be inverses of each other. If ``None`` a default list of self-inverse gates and a default list of inverse gate pairs will be used. The current default list of self-inverse gates is: * :class:`.CXGate` * :class:`.ECRGate` * :class:`.CYGate` * :class:`.CZGate` * :class:`.XGate` * :class:`.YGate` * :class:`.ZGate` * :class:`.HGate` * :class:`.SwapGate` * :class:`.CHGate` * :class:`.CCXGate` * :class:`.CCZGate` * :class:`.RCCXGate` * :class:`.CSwapGate` * :class:`.C3XGate` and the default list of inverse gate pairs is: * :class:`.TGate` and :class:`.TdgGate` * :class:`.SGate` and :class:`.SdgGate` * :class:`.SXGate` and :class:`.SXdgGate` * :class:`.CSGate` and :class:`.CSdgGate` run_default: If set to true and ``gates_to_cancel`` is set to a list then in addition to the gates listed in ``gates_to_cancel`` the default list of gate inverses (the same as when ``gates_to_cancel`` is set to ``None``) will be run. The order of evaluation is significant in how sequences of gates are cancelled and the default gates will be evaluated after the provided gates in ``gates_to_cancel``. If ``gates_to_cancel`` is ``None`` this option has no impact. Raises: TranspilerError: Input is not a self-inverse gate or a pair of inverse gates. NTFzGate z is not self-inversezToo many or too few inputs: z. Only two are allowed.rz and z are not inverse.z2InverseCancellation pass does not take input type z. Input must be a Gate.c38# UHoRv M g7f)N)name).0xs t/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/transpiler/passes/optimization/inverse_cancellation.py /InverseCancellation.__init__..ws8OAs)self_inverse_gatesinverse_gate_pairssetself_inverse_gate_namesinverse_gate_pairs_names _also_default_use_standard_gates isinstancerinverser rtuplelentypeappendaddupdatesuper__init__)selfgates_to_cancel run_defaultgates __class__s rr+InverseCancellation.__init__$sb#%"$'*u$(+%(  "'+D $',D $(eT** /-ejj\AU.VWW0u--5zQ-:5'AXYQx58#3#3#55-#E!HMM?%a FWX6 *LTRW[MZ##)&)eT**++22590044UZZ@++225911888O8OO ) cUR(a [U5 U$[UURURUR UR UR5 U$)zRun the InverseCancellation pass on `dag`. Args: dag: the directed acyclic graph to run on. Returns: DAGCircuit: Transformed DAG. )r!r r rrrrr )r,dags rrunInverseCancellation.runzs]  # # 3C 8  !''''--,,""   r2)r r!rrrr)NF)r-z+List[Union[Gate, Tuple[Gate, Gate]]] | Noner.bool)r4r) __name__ __module__ __qualname____firstlineno____doc__r+r trivial_recurser5__static_attributes__ __classcell__)r0s@rrr sM HL!TDTTTl!!"r2rN)r< __future__rtypingrrrqiskit.circuitrqiskit.dagcircuitrqiskit.transpiler.basepassesr qiskit.transpiler.exceptionsr qiskit.transpiler.passes.utilsr 'qiskit._accelerate.inverse_cancellationr r rr2rrIs8#%%(;87 o,or2