z iSrSSKJr SSKJrJrJrJr SSKJ r SSK J r SSK J r Jr SSKJr SSKJr SS KJr SS KJr "S S \5rSS jrSSjrSSjrg)zATranslate parameterized gates only, and leave others as they are.) annotations) InstructionParameterExpressionQubitClbit)EquivalenceLibrary)circuit_to_dag) DAGCircuit DAGOpNode) QiskitError)TransformationPass)BasisTranslator)TargetcR^\rSrSrSrSSU4SjjjrSSjrSrU=r$) TranslateParameterizedGatesu) Translate parameterized gates to a supported basis set. Once a parameterized instruction is found that is not in the ``supported_gates`` list, the instruction is decomposed one level and the parameterized sub-blocks are recursively decomposed. The recursion is stopped once all parameterized gates are in ``supported_gates``, or if a gate has no definition and a translation to the basis is attempted (this might happen e.g. for the ``UGate`` if it's not in the specified gate list). Example: The following, multiply nested circuit:: from qiskit.circuit import QuantumCircuit, ParameterVector from qiskit.transpiler.passes import TranslateParameterizedGates x = ParameterVector("x", 4) block1 = QuantumCircuit(1) block1.rx(x[0], 0) sub_block = QuantumCircuit(2) sub_block.cx(0, 1) sub_block.rz(x[2], 0) block2 = QuantumCircuit(2) block2.ry(x[1], 0) block2.append(sub_block.to_gate(), [0, 1]) block3 = QuantumCircuit(3) block3.ccx(0, 1, 2) circuit = QuantumCircuit(3) circuit.append(block1.to_gate(), [1]) circuit.append(block2.to_gate(), [0, 1]) circuit.append(block3.to_gate(), [0, 1, 2]) circuit.cry(x[3], 0, 2) supported_gates = ["rx", "ry", "rz", "cp", "crx", "cry", "crz"] unrolled = TranslateParameterizedGates(supported_gates)(circuit) is decomposed to:: ┌──────────┐ ┌──────────┐┌─────────────┐ q_0: ┤ Ry(x[1]) ├──■──┤ Rz(x[2]) ├┤0 ├─────■────── ├──────────┤┌─┴─┐└──────────┘│ │ │ q_1: ┤ Rx(x[0]) ├┤ X ├────────────┤1 circuit-92 ├─────┼────── └──────────┘└───┘ │ │┌────┴─────┐ q_2: ─────────────────────────────┤2 ├┤ Ry(x[3]) ├ └─────────────┘└──────────┘ c>[TU]5 UcSSKJn UnUb URnOUc [ S5eXlX0l[X!US9Ul g)aE Args: supported_gates: A list of suppported basis gates specified as string. If ``None``, a ``target`` must be provided. equivalence_library: The equivalence library to translate the gates. Defaults to the equivalence library of all Qiskit standard gates. target: A :class:`.Target` containing the supported operations. If ``None``, ``supported_gates`` must be set. Note that this argument takes precedence over ``supported_gates``, if both are set. Raises: ValueError: If neither of ``supported_gates`` and ``target`` are passed. Nr)_selz;One of ``supported_gates`` or ``target`` must be specified.)target) super__init__9qiskit.circuit.library.standard_gates.equivalence_libraryroperation_names ValueError_supported_gates_targetr _translator)selfsupported_gatesequivalence_libraryrr __class__s p/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/transpiler/passes/basis/translate_parameterized.pyr$TranslateParameterizedGates.__init__Osb&   & V"&   $44O  $Z[ [ / *+>X^_cUR5Hn[UR5(dM[X RUR 5(aMFURR nUbUR[U55nO/URR[UR55nURX$5 M U$![an[S5UeSnAff=f)zRun the transpiler pass. Args: dag: The DAG circuit in which the parameterized gates should be unrolled. Returns: A DAG where the parameterized gates have been unrolled. Raises: QiskitError: If the circuit cannot be unrolled. Nz Failed to translate final block.)op_nodes_is_parameterizedop _is_supportedrr definitionrunr r_instruction_to_dag Exceptionr substitute_node_with_dag)rdagnoder*unrolledexcs r"r+TranslateParameterizedGates.runusLLND ))-++T\\33"WW// )#xxz(BCHW#'#3#3#7#78KDGG8T#U ,,T<%#( %W)*LMSVVWs .C C, C''C,)rrr)NNN)rzlist[str] | Noner zEquivalenceLibrary | Noner Target | NonereturnNone)r/r r5r ) __name__ __module__ __qualname____firstlineno____doc__rr+__static_attributes__ __classcell__)r!s@r"rrsU1j-19= $ $`)$`7$` $`  $`$`L  r$rc:[SUR55$)Nc3# UH4n[U[5=(a [UR5S:v M6 g7f)rN) isinstancerlen parameters).0params r" $_is_parameterized..s5ZcQV 5-.L3u7G7G3H13LLZcs<>)anyparams)r(s r"r'r's" Z\ZcZc r$cUb%URURR5$URRU;$)zCheck whether the node is supported. If the target is provided, check using the target, otherwise the supported_gates are used. )instruction_supportedr(name)r0rrs r"r)r)s6 ++DGGLL99 77<rasHH"IIA,3);K+z"4zz +r$