z iWxSrSSKJr SSKrSSKJr SSKJr SSKJ r SSK J r "SS \5r "S S \5r g) zPermutation circuit (the old way to specify permutations, which is required for backward compatibility and which will be eventually deprecated) and the permutation gate (the new way to specify permutations, allowing a variety of synthesis algorithms). ) annotationsN)QuantumCircuit)Gate) CircuitError)deprecate_funcc\^\rSrSrSr\"SSSS9S S U4Sjjj5rSrU=r$) Permutationz(An n_qubit circuit that permutes qubits.z2.1zUse PermutationGate instead.z in Qiskit 3.0)sinceadditional_msgremoval_timelinec >UbC[U5[[U55:wa [S5e[R "U5nOF[R RU5n[R"U5nURU5 S[R"U5RSS5-n[T U]5XS9 SSKJn U"U5nXWlUR"nUR%UR'5U5 g) a Args: num_qubits: circuit width. pattern: permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation, that is ``pattern[k] = m`` when the permutation maps qubit ``m`` to position ``k``. As an example, the pattern ``[2, 4, 3, 0, 1]`` means that qubit ``2`` goes to position ``0``, qubit ``4`` goes to the position ``1``, etc. The pattern can also be ``None``, in which case a random permutation over ``num_qubits`` is created. seed: random seed in case a random permutation is requested. Raises: CircuitError: if permutation pattern is malformed. Reference Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import Permutation A = [2,4,3,0,1] circuit = Permutation(5, A) circuit.draw('mpl') Expanded Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.library import Permutation from qiskit.visualization.library import _generate_circuit_library_visualization A = [2,4,3,0,1] circuit = Permutation(5, A) _generate_circuit_library_visualization(circuit.decompose()) NGPermutation pattern must be some ordering of 0..num_qubits-1 in a list. permutation_ ,)namersynth_permutation_basic)sortedlistrangernparrayrandom default_rngarangeshuffle array_strreplacesuper__init__qiskit.synthesis.permutationrrqubitsappendto_gate) self num_qubitspatternseedrngrrcircuit all_qubits __class__s n/home/james-whalen/.local/lib/python3.13/site-packages/qiskit/circuit/library/generalized_gates/permutation.pyr"Permutation.__init__s`  g$uZ'8"99"]hhw'G))''-Cii +G KK  W 5 = =c3 GG / I)'2 [[  GOO%z2NN)r(intr)zlist[int] | np.ndarray | Noner*z int | NonereturnNone) __name__ __module__ __qualname____firstlineno____doc__rr"__static_attributes__ __classcell__r.s@r/r r sZ25(26 A3A3/A3 A3  A3  A3r1r cp^\rSrSrSrS U4SjjrS SjrSr\S Sj5r S SSjjr Sr S r U=r $)PermutationGatehzA gate that permutes qubits.c>[U5n[U5[[U55:wa [ S5e[ R "U[ RS9n[TU]%SX!/S9 g)aReturn a permutation gate. Args: pattern: permutation pattern, describing which qubits occupy the positions 0, 1, 2, etc. after applying the permutation, that is ``pattern[k] = m`` when the permutation maps qubit ``m`` to position ``k``. As an example, the pattern ``[2, 4, 3, 0, 1]`` means that qubit ``2`` goes to position ``0``, qubit ``4`` goes to the position ``1``, etc. Raises: CircuitError: if permutation pattern is malformed. Reference Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.quantumcircuit import QuantumCircuit from qiskit.circuit.library import PermutationGate A = [2, 4, 3, 0, 1] permutation = PermutationGate(A) circuit = QuantumCircuit(5) circuit.append(permutation, [0, 1, 2, 3, 4]) circuit.draw("mpl") Expanded Circuit: .. plot:: :alt: Diagram illustrating the previously described circuit. from qiskit.circuit.quantumcircuit import QuantumCircuit from qiskit.circuit.library import PermutationGate from qiskit.visualization.library import _generate_circuit_library_visualization A = [2, 4, 3, 0, 1] permutation = PermutationGate(A) circuit = QuantumCircuit(5) circuit.append(permutation, [0, 1, 2, 3, 4]) _generate_circuit_library_visualization(circuit.decompose()) rdtype permutation)rr(paramsN) lenrrrrrrint32r!r")r'r)r(r.s r/r"PermutationGate.__init__ks_V\ '?d5#45 5Y ((7"((3 m 9Ur1cUSLa [S5e[UR5n[R"SU-SU-4US9n[ SU-5Hln[ U5SSRU5SSS2nSRURVs/sHovUPM sn5n[USSS2S5n SXIU4'Mn U$s snf) z.Return a numpy.array for the Permutation gate.Fz9unable to avoid copy while creating an array as requestedrCN) ValueErrorrGr)rzerosrbinzfilljoinr4) r'rDcopynqmatrbitj permuted_bitprs r/ __array__PermutationGate.__array__s 5=XY Y  hh2q"u~U3q"uAa&*""2&tt,C77DLL#ALqFL#ABL\$B$'+BCAJ  $BsC cU$)zParameter validation.r2)r' parameters r/validate_parameter"PermutationGate.validate_parametersr1c URS$)z:Returns the permutation pattern defining this permutation.r)rF)r's r/r)PermutationGate.patterns{{1~r1c@SSKJn [U"UR5S9$)z'Returns the inverse of the permutation.r)_inverse_pattern)r)).qiskit.synthesis.permutation.permutation_utilsrer@r))r' annotatedres r/inversePermutationGate.inverses T'7 'EFFr1cSSKJn SSRSUR55S3nU"UR5nX#lUR 5$)Nrr permutation___c38# UHn[U5v M g7f)N)str).0ns r/ 6PermutationGate._qasm_decomposition..s'E 1A s)r#rrSr)rr&)r'rrouts r/_qasm_decomposition#PermutationGate._qasm_decompositionsFHsxx'E 'EEFaH%dll3{{}r1r2)r)z list[int]r5r6r3)r5znp.ndarray[bool])F)rgboolr5r@)r7r8r9r:r;r"r\r`propertyr)rhrtr<r=r>s@r/r@r@hsO&2V2V 2Vh$G  r1r@)r; __future__rnumpyrqiskit.circuit.quantumcircuitrrqiskit.circuit.exceptionsrqiskit.utils.deprecationrr r@r2r1r/r}s; #8.23I3.I3Xcdcr1