*hrtSSKJr SSKJr SSKJr SSKJr SSKJ r J r J r "SS\5r "S S \5r g ) )S)_sympify)KroneckerDelta) MatrixExpr) ZeroMatrixIdentity OneMatrixcx^\rSrSrSrU4Sjr\S5r\S5rSr Sr Sr S r \ =r rS rS rS rU=r$) PermutationMatrix a)A Permutation Matrix Parameters ========== perm : Permutation The permutation the matrix uses. The size of the permutation determines the matrix size. See the documentation of :class:`sympy.combinatorics.permutations.Permutation` for the further information of how to create a permutation object. Examples ======== >>> from sympy import Matrix, PermutationMatrix >>> from sympy.combinatorics import Permutation Creating a permutation matrix: >>> p = Permutation(1, 2, 0) >>> P = PermutationMatrix(p) >>> P = P.as_explicit() >>> P Matrix([ [0, 1, 0], [0, 0, 1], [1, 0, 0]]) Permuting a matrix row and column: >>> M = Matrix([0, 1, 2]) >>> Matrix(P*M) Matrix([ [1], [2], [0]]) >>> Matrix(M.T*P) Matrix([[2, 0, 1]]) See Also ======== sympy.combinatorics.permutations.Permutation c>SSKJn [U5n[X5(d[ SR U55e[ TU]X5$)Nr Permutationz({} must be a SymPy Permutation instance.) sympy.combinatorics.permutationsrr isinstance ValueErrorformatsuper__new__)clspermr __class__s c/home/mande/repo/quber/.venv/lib/python3.13/site-packages/sympy/matrices/expressions/permutation.pyrPermutationMatrix.__new__;sH@~$,,:AA$GI Iws))c:URSRnX4$Nr)argssize)selfr s rshapePermutationMatrix.shapeEsyy|  |rc4URSR$r)r is_Identityr!s rr%PermutationMatrix.is_IdentityJsyy|'''rc RUR(a[UR5$U$)N)r%r rows)r!hintss rdoitPermutationMatrix.doitNs   DII& & rc VURSn[URU5U5$r)rrapply)r!ijkwargsrs r_entryPermutationMatrix._entrySs$yy|djjmQ//rcT[URSU-5R5$r)r rr+)r!exps r _eval_powerPermutationMatrix._eval_powerWs# 1!45::<&>&rr cl^\rSrSrSr\R 4U4SjjrS Sjr\ S5r Sr Sr Sr U=r$) MatrixPermuteaSymbolic representation for permuting matrix rows or columns. Parameters ========== perm : Permutation, PermutationMatrix The permutation to use for permuting the matrix. The permutation can be resized to the suitable one, axis : 0 or 1 The axis to permute alongside. If `0`, it will permute the matrix rows. If `1`, it will permute the matrix columns. Notes ===== This follows the same notation used in :meth:`sympy.matrices.matrixbase.MatrixBase.permute`. Examples ======== >>> from sympy import Matrix, MatrixPermute >>> from sympy.combinatorics import Permutation Permuting the matrix rows: >>> p = Permutation(1, 2, 0) >>> A = Matrix([[1, 2, 3], [4, 5, 6], [7, 8, 9]]) >>> B = MatrixPermute(A, p, axis=0) >>> B.as_explicit() Matrix([ [4, 5, 6], [7, 8, 9], [1, 2, 3]]) Permuting the matrix columns: >>> B = MatrixPermute(A, p, axis=1) >>> B.as_explicit() Matrix([ [2, 3, 1], [5, 6, 4], [8, 9, 7]]) See Also ======== sympy.matrices.matrixbase.MatrixBase.permute c8>SSKJn [U5nUR(d[ SR U55e[U5n[ U[5(aURSn[ X$5(d[ SR U55e[U5nUS;a [ S5eURUnXRR:waURU5n[TU]5XX#5$![a [ SR X!U55ef=f)Nrrz#{} must be a SymPy matrix instance.z>{} must be a SymPy Permutation or a PermutationMatrix instance)rrzThe axis must be 0 or 1.zsSize does not match between the permutation {} and the matrix {} threaded over the axis {} and cannot be converted.)rrr is_Matrixrrrr rr"r resizerr)rrXraxisrmat_sizers rrMatrixPermute.__new__s @sm}}5<rrr rh)r!rqr*rXrrms rr+MatrixPermute.doits))4 ((...C990$0%0D   J ??qvv~(..(r22 cJ 2 3 3J c= ) )chhqkT.A !dXXa[.@$G G rc4URSR$r)rr"r&s rr"MatrixPermute.shapesyy|!!!rc URupEnUS:XaXERU5U4$US:XaXAURU54$g)Nrr)rr.)r!r/r0r1rXrrms rr2MatrixPermute._entrysN))4 19zz!}a'( ( QY$**Q-'( (rcSSKJn URupEnURSS5nU(aUR U5nUS:XaU"[ U5U5$US:XaU"U[ US-55$g)Nr)MatMulrqTrr9)matmulrzrgetrewriter )r!rr1rzrXrrmrqs r_eval_rewrite_as_MatMul%MatrixPermute._eval_rewrite_as_MatMul"sp"))4zz&$' ++f%C 19+D137 7 QY#0r:; ;rr[)T)r\r]r^r_r`rrsrr+rar"r2r~rdrerfs@rrhrhs@2f&'VV 5D0"") < rs4'*44\& \&~G