z i3 SrSSKJr SSKrSSKJr SSKJrJ r SSK J r SSK J r JrJrJr SSKJr \R&(aSS KJr \ R,\R,\R,\R,S .rS S S jjrg)zThe twirling module.) annotationsN) twirl_circuit)QuantumCircuit_copy_metadata)Gate)CXGateECRGateCZGate iSwapGate) QiskitError)Target)cxecrcziswapcSn[U[5(a-[RUS5nUc[ SUS35eU/nGO![U[ 5(a/n/nUHn[U[5(a;[RUS5nUc[ SUS35eUR U5 MS[USS5nUcUR U5 MvU[R5;aUR U5 MUR U5 M U(dSnU(dSnO=Ub8[USS5nUcSnU/nO$U[R5;aU/nOSnU/nOUnUn U cSn [URUUUU U5n Ub?/n U H5n [R"U 5n [X 5 U R U 5 M7 U $[R"U S5n[X5 U$)aB Create copies of a given circuit with Pauli twirling applied around specified two qubit gates. If you're running this function with the intent to twirl a circuit to run on hardware this may not be the most efficient way to perform twirling. Especially if the hardware vendor has implemented the :mod:`.primitives` execution interface with :class:`.SamplerV2` and :class:`.EstimatorV2` this most likely is not the best way to apply twirling to your circuit and you'll want to refer to the implementation of :class:`.SamplerV2` and/or :class:`.EstimatorV2` for the specified hardware vendor. If the intent of this function is to be run after :func:`.transpile` or :meth:`.PassManager.run` the optional ``target`` argument can be used so that the inserted 1 qubit Pauli gates are synthesized to be compatible with the given :class:`.Target` so the output circuit(s) are still compatible. Args: circuit: The circuit to twirl twirling_gate: The gate to twirl, defaults to `None` which means twirl all default gates: :class:`.CXGate`, :class:`.CZGate`, :class:`.ECRGate`, and :class:`.iSwapGate`. If supplied it can either be a single gate or a list of gates either as either a gate object or its string name. Currently only the names `"cx"`, `"cz"`, `"ecr"`, and `"iswap"` are supported. If a gate object is provided outside the default gates it must have a matrix defined from its :class:`~.Gate.to_matrix` method for the gate to potentially be twirled. If a valid twirling configuration can't be computed that particular gate will be silently ignored and not twirled. seed: An integer seed for the random number generator used internally by this function. If specified this must be between 0 and 18,446,744,073,709,551,615. num_twirls: The number of twirling circuits to build. This defaults to ``None`` and will return a single circuit. If it is an integer a list of circuits with `num_twirls` circuits will be returned. target: If specified an :class:`.Target` instance to use for running single qubit decomposition as part of the Pauli twirling to optimize and map the pauli gates added to the circuit to the specified target. Returns: A copy of the given circuit with Pauli twirling applied to each instance of the specified twirling gate. NzThe specified gate name z is not supported_standard_gater) isinstancestr NAME_TO_CLASSgetr listappendgetattrvaluestwirl_rs_datar_from_circuit_datar)circuit twirling_gateseed num_twirlstarget custom_gatesgatetwirling_std_gatestd_gate out_twirlsnew_dataout_listcircnew_circout_circs Q/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/twirling.pypauli_twirl_2q_gatesr0$s\L-%%  5 < 8GXYZ Z!F M4 ( ( !D$$$$((t4<%(@O`&abb!((. '.> E  ( ''-$ (<(<(>>)00?$++D1" L $   "=*:DA   $ )?L=//11%-J!$(! - )J    HD%88>H 7 - OOH %!44Xa[Aw))NNNN) r rr!z*None | str | Gate | list[str] | list[Gate]r" int | Noner#r2r$z Target | Nonereturnz%QuantumCircuit | list[QuantumCircuit])__doc__ __future__rtypingqiskit._accelerate.twirlingrrqiskit.circuit.quantumcircuitrrqiskit.circuit.gater%qiskit.circuit.library.standard_gatesrr r r qiskit.exceptionsr TYPE_CHECKINGqiskit.transpiler.targetr rrr0r1r/r?s" AH$TT) /     ! !     % %  AE! m m=m m m  m + mr1