gEdZddlmZddlZddlmZddlmZm Z ddl m Z ddl m Z mZmZmZddlmZejrdd lmZe jejejejd Z dddZdS)zThe twirling module.) annotationsN) twirl_circuit)QuantumCircuit_copy_metadata)Gate)CXGateECRGateCZGate iSwapGate) QiskitError)Target)cxecrcziswapcircuitr twirling_gate*None | str | Gate | list[str] | list[Gate]seed int | None num_twirlstarget Target | Nonereturn%QuantumCircuit | list[QuantumCircuit]c"d}t|tr5t|d}|t d|d|g}n3t|t rg}g}|D]}t|trFt|d}|t d|d||]t|dd}||||tvr|||||sd}|sd}nB|>t|dd}|d}|g}n'|tvr|g}nd}|g}n|}|} | d} t|j |||| |} |Cg} | D]<} tj | } t|| d| | =| Stj | d}t||d|S)a 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_gatealiker) isinstancestr NAME_TO_CLASSgetr listappendgetattrvaluestwirl_rs_datar_from_circuit_datar)rrrrr custom_gatesgatetwirling_std_gatestd_gate out_twirlsnew_dataout_listcircnew_circout_circs M/granary/edev/quantum/lib/python3.11/site-packages/qiskit/circuit/twirling.pypauli_twirl_2q_gatesr6$s\L-%%(*  55 <YYYYZZ Z!F M4 ( (#* ! 2 2D$$$ 2$((t44<%&a&a&a&abbb!((.... '.> E E  ( ''----$ (<(<(>(>>>)00????$++D1111 L  % $   "=*:DAA   $ )?LL=//1111%-J!!$(! - )J    H & &D%8>>H 7Hg 6 6 6 OOH % % % %!4Xa[AAw'222)NNNN) rrrrrrrrrrrr)__doc__ __future__rtypingqiskit._accelerate.twirlingrr(qiskit.circuit.quantumcircuitrrqiskit.circuit.gater%qiskit.circuit.library.standard_gatesrr r r qiskit.exceptionsr TYPE_CHECKINGqiskit.transpiler.targetr rr"r6r7r5rCs"""""" AAAAAAHHHHHHHH$$$$$$TTTTTTTTTTTT)))))) 0//////    !    %  AE! mmmmmmmr7