z inSrSSKrSSKJr SSKJr SSKJr \R"\ 5r "SS\5r g)zTRemove any swap gates in the circuit by pushing it through into a qubit permutation.N)TransformationPass)Layout)elide_permutationsc\rSrSrSrSrSrg)ElidePermutationsaRemove permutation operations from a pre-layout circuit This pass is intended to be run before a layout (mapping virtual qubits to physical qubits) is set during the transpilation pipeline. This pass iterates over the :class:`~.DAGCircuit` and when a :class:`~.SwapGate` or :class:`~.PermutationGate` are encountered it permutes the virtual qubits in the circuit and removes the swap gate. This will effectively remove any :class:`~SwapGate`\s or :class:`~PermutationGate` in the circuit prior to running layout. If this pass is run after a layout has been set it will become a no-op (and log a warning) as this optimization is not sound after physical qubits are selected and there are connectivity constraints to adhere to. For tracking purposes this pass sets 3 values in the property set if there are any :class:`~.SwapGate` or :class:`~.PermutationGate` objects in the circuit and the pass isn't a no-op. * ``original_layout``: The trivial :class:`~.Layout` for the input to this pass being run * ``original_qubit_indices``: The mapping of qubit objects to positional indices for the state of the circuit as input to this pass. * ``virtual_permutation_layout``: A :class:`~.Layout` object mapping input qubits to the output state after eliding permutations. These three properties are needed for the transpiler to track the permutations in the out :attr:`.QuantumCircuit.layout` attribute. The elision of permutations is equivalent to a ``final_layout`` set by routing and all three of these attributes are needed in the case cURSb[RS5 U$[R"U5nUcU$Uup4[ UR 5VVs0sHupVXe_M nnn[U5URS'URScXpRS'[[ U5VV s0sHupUR U U_M sn n5n URS=n (aOU RU RUR UR 5UR 5URS'U$XRS'U$s snnfs sn nf)zRun the ElidePermutations pass on ``dag``. Args: dag (DAGCircuit): the DAG to be optimized. Returns: DAGCircuit: the optimized DAG. layoutzpElidePermutations is not valid after a layout has been set. This indicates an invalid pass manager construction.original_layoutoriginal_qubit_indicesvirtual_permutation_layout) property_setloggerwarningelide_permutations_rsrun enumeratequbitsrcomposeinverse) selfdagresultnew_dag qubit_mappingindexqubitinput_qubit_mappingidxout new_layoutcurrent_layouts r/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/transpiler/passes/optimization/elide_permutations.pyrElidePermutations.run5sY   X & 2 NN8 J&**3/ >J$* @I#**@UV@U u|@UV/56I/J+,   5 6 >:M  6 7)MBZ[BZhcSZZ_c1BZ[\ !../KL L> L>H>P>P&&szz3::> ?D  : ; ?I  : ;W \s E9E N)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__r%r#rrs 6&r,r) r*loggingqiskit.transpiler.basepassesrqiskit.transpiler.layoutrqiskit._acceleraterr getLoggerr&rrr%r,r#r2s6[;+J   8 $B*Br,