+
    åûj•<  ã                   óô  € ^ RI HtHt ^ RIHt ^ RIHtHtHt ^ RI	H
t
Ht ^ RIHtHt ^ RIHt ^ RIHt ^ RIHtHtHtHtHtHtHt ^ R	IHt ^ R
IHt ^ RIH t  ^ RI!H"t# ^RI$H%t% ^RI&H't' ^RI(H)t) ^RI*H*t* ^RI+H,t, ^RI-H.t.H/t/H0t0H1t1  ! R R]']4      t2]
Pf                  ! ]]23]24       R t4R t5R t6R t7R t8R t9R t:R t;R t<]<]5]7];]9]]! R 4      ]6]8]]:3t=]! ]! ]2]! ]=!  /4      4      t>R t?R  t@]@]R&   R!# )"é    )ÚaskÚQ)Úhandlers_dict)ÚBasicÚsympifyÚS)ÚmulÚMul)ÚNumberÚInteger©ÚDummy)Úadjoint)Úrm_idÚunpackÚtypedÚflattenÚexhaustÚdo_oneÚnew)ÚNonInvertibleMatrixError)Ú
MatrixBase)Úsympy_deprecation_warning)Úvalidate_matmul_integer)ÚInverse)Ú
MatrixExpr)ÚMatPow)Ú	transpose)ÚPermutationMatrix)Ú
ZeroMatrixÚIdentityÚGenericIdentityÚ	OneMatrixc                   óÈ   a a€ ] tR t^t oRtRt]! 4       tRRRRRR/R lt]	R	 4       t
]R
 4       tRR ltR tR tV 3R ltR tR tR tR tR tR tRR ltR tRtVtV ;t# )ÚMatMulzÚ
A product of matrix expressions

Examples
========

>>> from sympy import MatMul, MatrixSymbol
>>> A = MatrixSymbol('A', 5, 4)
>>> B = MatrixSymbol('B', 4, 3)
>>> C = MatrixSymbol('C', 3, 6)
>>> MatMul(A, B, C)
A*B*C
TÚevaluateFÚcheckNÚ_sympifyc               ó€  a € V'       g   S P                   # \        \        V 3R  lV4      4      pV'       d   \        \        \        V4      4      p\
        P                  ! S .VO5!  pVP                  4       w  rgVe   \        RRRR7       VRJd
   \        V!   V'       g   V# V'       d   S P                  V4      # V# )c                 ó"   <€ SP                   V 8g  # ©N)Úidentity)ÚiÚclss   &€Ú]C:\Ai_Coding\apps\studio\ComfyUI\.venv\Lib\site-packages\sympy\matrices\expressions\matmul.pyÚ<lambda>Ú MatMul.__new__.<locals>.<lambda>0   s   ø€  S§\¡\°QÒ%6ó    zaPassing check to MatMul is deprecated and the check argument will be removed in a future version.z1.11z,remove-check-argument-from-matrix-operations)Údeprecated_since_versionÚactive_deprecations_targetF)r,   ÚlistÚfilterÚmapr   r   Ú__new__Úas_coeff_matricesr   ÚvalidateÚ	_evaluate)r.   r&   r'   r(   ÚargsÚobjÚfactorÚmatricess   f$$$*   r/   r8   ÚMatMul.__new__*   s§   ø€ ßØ—<‘<Ðô ”FÔ6¸Ó=Ó>ˆßÜœœG TÓ*Ó+ˆDÜ�mŠm˜CÐ' $Ó'ˆØ×0Ñ0Ó2ÑˆàÒÜ%ØsØ)/Ø+Yõ[ð
 ˜ÓÜ�hÒçð ˆMçØ—=‘= Ó%Ð%àˆ
r2   c                ó   € \        V4      # r+   )Úcanonicalize)r.   Úexprs   &&r/   r;   ÚMatMul._evaluateJ   s   € ä˜DÓ!Ð!r2   c                ó´   € V P                    Uu. uF  qP                  '       g   K  VNK  	  ppV^ ,          P                  VR,          P                  3# u upi )r   éÿÿÿÿ)r<   Ú	is_MatrixÚrowsÚcols)ÚselfÚargr?   s   &  r/   ÚshapeÚMatMul.shapeN   sD   € à#'§9¢9Ó>¡9˜C·µ—C�C¡9ˆÐ>Ø˜•× Ñ  (¨2¥,×"3Ñ"3Ð4Ð4ùò ?s
   �A§Ac                ó>  a€ ^ RI Hp ^ RIHo V P	                  4       w  rg\        V4      ^8X  d   Wg^ ,          W3,          ,          # R.\        V4      ^,           ,          pR.\        V4      ^,
          ,          p	W^ &   W(R&   R p
VP                  RV
! 4       4      p\        ^\        V4      4       F  p\        V4      W�&   K  	  \        VRR 4       F!  w  rVP                  ^,          ^,
          W‘&   K#  	  \        V4       UUu. uF,  w  rVP                  W�,          W�^,           ,          VR7      NK.  	  ppp\        P                  ! V4      p\        ;QJ d    V3R lV 4       F  '       g   K   RM	  R	M! V3R lV 4       4      '       d   RpWe! V.\        V^R ^ .\        V	4      ,          V	4      O5!  ,          p\        ;QJ d    R
 V	 4       F  '       g   K   RM	  R	M! R
 V	 4       4      '       g   R	pV'       d   VP!                  4       # T# u uppi )r   )ÚSum)ÚImmutableMatrixNc               3   óN   "  € ^p  \        RV ,          4      x € V ^,          p K   5i)é   zi_%ir   )Úcounters    r/   ÚfÚMatMul._entry.<locals>.fb   s&   é € ØˆGØÜ˜F WÕ,Ó-Ò-Ø˜1•’ùó   ‚#%Údummy_generator)rW   c              3   óD   <"  € T F  qP                  S4      x € K  	  R # 5ir+   )Úhas)Ú.0ÚvrP   s   & €r/   Ú	<genexpr>Ú MatMul._entry.<locals>.<genexpr>q   s   øé € Ð8©x¨!�u‰u�_×%Ð%«xùs   ƒ TFc              3   óN   "  € T F  p\        V\        \        34      x € K  	  R # 5ir+   )Ú
isinstancer   Úint)rZ   r[   s   & r/   r\   r]   y   s   é € ÐE¹*°Q”:˜a¤'¬3 ×0Ð0»*ùrV   rF   )Úsympy.concrete.summationsrO   Úsympy.matrices.immutablerP   r9   ÚlenÚgetÚrangeÚnextÚ	enumeraterL   Ú_entryr
   ÚfromiterÚanyÚzipÚdoit)rJ   r-   ÚjÚexpandÚkwargsrO   Úcoeffr?   ÚindicesÚ
ind_rangesrT   rW   rK   Úexpr_in_sumÚresultrP   s   &&&&,          @r/   rh   ÚMatMul._entryS   s»  ø€ å1Ý<à×0Ñ0Ó2‰ˆäˆx‹=˜AÔØ A�; q tÕ,Õ,Ð,à�&œ#˜h›-¨!Õ+Õ,ˆØ�VœS ›]¨QÕ.Õ/ˆ
Ø�‰
Ø�‰ò	ð !Ÿ*™*Ð%6¹»Ó<ˆä�qœ#˜h›-Ö(ˆAÜ˜oÓ.ˆG‹Jñ )ô   ¨¨" Ö.‰FˆAØŸI™I a�L¨1Õ,ˆJ‹Mñ /ähqÐrzÔh{Ô|Ñh{Ñ^dÐ^_�C—J‘J˜w�z¨7°Qµ3­<È�JÖYÑh{ˆÑ|Ü—l’l 8Ó,ˆß‹3Ô8©xÓ8�3�3Š3Ô8©xÓ8×8Ò8ØˆFØ�sØðä�W˜Q˜r�] Q C¬¨J«Õ$7¸ÓDóõ ˆ÷ ‹sÑE¹*ÓE�s�sŠsÑE¹*ÓE×EÒEØˆFß &ˆv�{‰{‹}Ð2¨FÐ2ùó }s   Ä2Hc                ó  € V P                    Uu. uF  qP                  '       d   K  VNK  	  ppV P                    Uu. uF  qP                  '       g   K  VNK  	  pp\        V!  pVP                  R J d   \	        R4      hWC3# u upi u upi )Fz3noncommutative scalars in MatMul are not supported.)r<   rG   r
   Úis_commutativeÚNotImplementedError)rJ   ÚxÚscalarsr?   rp   s   &    r/   r9   ÚMatMul.as_coeff_matrices}   sq   € Ø"ŸišiÓ;™i˜¯{­{—1�1™iˆÐ;Ø#ŸyšyÓ8™y˜!¯K­K—A�A™yˆÐ8Ü�W‘ˆØ×Ñ 5Ó(Ü%Ð&[Ó\Ð\àˆÐùò <ùÚ8s   �B§B½B	ÁB	c                ó<   € V P                  4       w  rV\        V!  3# r+   )r9   r%   )rJ   rp   r?   s   &  r/   Úas_coeff_mmulÚMatMul.as_coeff_mmul†   s"   € Ø×0Ñ0Ó2‰ˆØ”f˜hÑ'Ð'Ð'r2   c                óN   <€ \         \        V `
  ! R/ VB pV P                  V4      # ©N© )Úsuperr%   rn   r;   )rJ   ro   ÚexpandedÚ	__class__s   &, €r/   rn   ÚMatMul.expandŠ   s&   ø€ Üœ Ò-Ñ7°Ñ7ˆØ�~‰~˜hÓ'Ð'r2   c           	     ó¬   € V P                  4       w  r\        V.VRRR1,           Uu. uF  p\        V4      NK  	  upO5!  P                  4       # u upi )aP  Transposition of matrix multiplication.

Notes
=====

The following rules are applied.

Transposition for matrix multiplied with another matrix:
`\left(A B\right)^{T} = B^{T} A^{T}`

Transposition for matrix multiplied with scalar:
`\left(c A\right)^{T} = c A^{T}`

References
==========

.. [1] https://en.wikipedia.org/wiki/Transpose
NrF   )r9   r%   r   rl   )rJ   rp   r?   rK   s   &   r/   Ú_eval_transposeÚMatMul._eval_transposeŽ   sT   € ð& ×0Ñ0Ó2‰ˆÜØð@Ø/7¹¸"¸®~Ó>©~¨”Y˜s–^©~Ñ>ó@ß@DÁÃð	GùÚ>s   ¨A
c                ó”   € \        V P                  R R R1,           Uu. uF  p\        V4      NK  	  up!  P                  4       # u upi )NrF   )r%   r<   r   rl   )rJ   rK   s   & r/   Ú_eval_adjointÚMatMul._eval_adjoint¥   s8   € Ü°·	±	¹$¸B¸$¶Ó@±¨œ ž±Ñ@ÑA×FÑFÓHÐHùÒ@s   žAc                ó|   € V P                  4       w  rV^8w  d#   ^RIHp W! VP                  4       4      ,          # R# )rR   )ÚtraceN)r}   r�   rl   )rJ   r>   Úmmulr�   s   &   r/   Ú_eval_traceÚMatMul._eval_trace¨   s7   € Ø×)Ñ)Ó+‰ˆØ�QŒ;Ý$Ø˜E $§)¡)£+Ó.Õ.Ð.ñ r2   c           	     ó¨   € ^ RI Hp V P                  4       w  r#\        V!  pW P                  ,          \        \        \        W4      4      !  ,          # )r   )ÚDeterminant)Ú&sympy.matrices.expressions.determinantr’   r9   Úonly_squaresrH   r
   r5   r7   )rJ   r’   r>   r?   Úsquare_matricess   &    r/   Ú_eval_determinantÚMatMul._eval_determinant®   sA   € ÝFØ×1Ñ1Ó3ÑˆÜ&¨Ñ1ˆØ—y‘yÕ ¤3¬¬S°Ó-NÓ(OÑ#PÕPÐPr2   c                ó  € \         ;QJ d&    R  V P                   4       F  '       d   K   RM	  RM! R  V P                   4       4      '       d3   \        R V P                  RRR1,           4       !  P                  4       # \	        V 4      # )c              3   ój   "  € T F)  p\        V\        4      '       g   K  VP                  x € K+  	  R # 5ir+   )r_   r   Ú	is_square©rZ   rK   s   & r/   r\   Ú'MatMul._eval_inverse.<locals>.<genexpr>µ   s   é € ÐQ©	 ´ZÀÄZ×5PŒ}ˆs�}Ž}«	ùs   ‚3Ÿ3FTc              3   ó€   "  € T F4  p\        V\        4      '       d   VP                  4       MVR,          x € K6  	  R# 5i)rR   NrF   )r_   r   Úinverser›   s   & r/   r\   rœ   ¶   s2   é € ð á.˜ô ",¨C´×!<Ò!<�—‘”À#ÀrÅ'ÔIÛ.ùs   ‚<>NrF   )Úallr<   r%   rl   r   )rJ   s   &r/   Ú_eval_inverseÚMatMul._eval_inverse´   sf   € ß‹3ÑQ¨¯	ª	ÓQ�3�3Š3ÑQ¨¯	ª	ÓQ×QÒQÜñ à#Ÿy™y©¨2¨žóñ ÷ ‰d‹fð	ô
 �t‹}Ðr2   c                ó  a€ SP                  R R4      pV'       dH   \        ;QJ d!    . V3R lV P                   4       F  NK  	  5M! V3R lV P                   4       4      pMV P                  p\        \	        V!  4      pV# )ÚdeepTc              3   óF   <"  € T F  qP                   ! R/ SB x € K  	  R # 5ir€   )rl   )rZ   rK   Úhintss   & €r/   r\   ÚMatMul.doit.<locals>.<genexpr>À   s   øé € Ð@±i¨sŸšÑ* EÖ*³iùs   ƒ!)rd   Útupler<   rB   r%   )rJ   r¥   r£   r<   rC   s   &l   r/   rl   ÚMatMul.doit½   sZ   ø€ Ø�y‰y˜ Ó&ˆßß”5Ô@°d·i²iÓ@—5‘5Ô@°d·i²iÓ@Ó@‰Dà—9‘9ˆDô œF D™MÓ*ˆØˆr2   c           	     óô  € V P                    Uu. uF  qDP                  '       g   K  VNK  	  ppV P                    Uu. uF  qDP                  '       d   K  VNK  	  ppV'       d„   \        V4      p\        V4      pV'       df   V'       d^   \        V4      V8w  dN   \	        R V Uu. uF0  p\        V P                   4      P                  V4      ^8”  g   K.  VNK2  	  up,          4      hWV.# u upi u upi u upi )z"repeated commutative arguments: %s)r<   rw   rc   ÚsetÚ
ValueErrorr5   Úcount)	rJ   ÚcsetÚwarnro   ry   Úcoeff_cÚcoeff_ncÚclenÚcis	   &&&,     r/   Úargs_cncÚMatMul.args_cncÉ   sÆ   € Ø"ŸišiÓ<™i˜×+;Õ+;—1�1™iˆÐ<Ø#ŸyšyÓA™y˜!×0@Õ0@—A�A™yˆÐAßÜ�w“<ˆDÜ˜'“lˆGßŸ¤ W£°Ô!5Ü Ð!EÙ/6Ó!X©w¨¼$¸t¿y¹y»/×:OÑ:OÐPRÓ:SÐVWÑ:W§" "©wÑ!Xõ"Yó Zð ZàÐ"Ð"ùò =ùÚAùò "Ys!   �C+§C+½C0ÁC0Â%+C5
ÃC5
c           	     ó2  € ^RI Hp \        V P                  4       UUu. uF   w  r4VP	                  V4      '       g   K  VNK"  	  ppp. pV EF;  pV P                  RV pV P                  V^,           R p	V	'       d   \
        P                  V	4      p
M\        V P                  ^,          4      p
V'       dW   \
        P                  \        V4       Uu. uF,  q3P                  '       d   V! V4      P                  4       MTNK.  	  up4      pM\        V P                  ^ ,          4      pV P                  V,          P                  V4      pV F6  pVP                  V4       VP                  V
4       VP                  V4       K8  	  EK>  	  V# u uppi u upi )rR   )Ú	TransposeN)r   r¶   rg   r<   rY   r%   ri   r!   rL   ÚreversedrG   rl   Ú_eval_derivative_matrix_linesÚappend_firstÚappend_secondÚappend)rJ   ry   r¶   r-   rK   Ú
with_x_indÚlinesÚindÚ	left_argsÚ
right_argsÚ	right_matÚleft_revÚds   &&           r/   r¸   Ú$MatMul._eval_derivative_matrix_linesÔ   s4  € Ý(Ü&/°·	±	Ô&:ÔIÑ&:™F˜A¸c¿g¹gÀa¿j—a�aÑ&:ˆ
ÑIØˆÜˆCØŸ	™	 $ 3˜ˆIØŸ™ 3 q¥5 6Ð*ˆJçÜ"ŸO™O¨JÓ7‘	ä$ T§Z¡Z°¥]Ó3�	ßÜ!Ÿ?™?Ô_gÐhqÔ_rÓ+sÑ_rÐZ[Ç;Ç;À;©I°a«L×,=Ñ,=Ô,?ÐTUÒ,UÑ_rÑ+sÓt‘ä# D§J¡J¨q¥MÓ2�à—	‘	˜#•×<Ñ<¸QÓ?ˆAÛ�Ø—‘˜xÔ(Ø—‘ 	Ô*Ø—‘˜Q–ô ñ ð& ˆùó+ Jùò ,ts   ŸF¿FÃ2F
r�   ©T)FT)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Ú	is_MatMulr"   r,   r8   Úclassmethodr;   ÚpropertyrL   rh   r9   r}   rn   r‡   rŠ   r�   r–   r    rl   r³   r¸   Ú__static_attributes__Ú__classdictcell__Ú__classcell__)r„   Ú__classdict__s   @@r/   r%   r%      s¡   ù‡ € ñð €IáÓ €Hð Uð °$ð Àô ð@ ñ"ó ð"ð ñ5ó ð5ô(3òTò(õ(òGò.Iò/òQòò	ô	#÷ò r2   r%   c                  óR   € V ^ ,          ^8X  d
   V R,          p \        \        .V O5!  # )r   ºrR   NN)r   r%   )r<   s   *r/   ÚnewmulrÔ   ñ   s&   € ØˆA…w�!„|Ø�B�xˆÜŒvÐ˜ÓÐr2   c                 ód  € \         ;QJ d&    R  V P                   4       F  '       g   K   RM	  RM! R  V P                   4       4      '       d]   V P                   Uu. uF  qP                  '       g   K  VNK  	  pp\        V^ ,          P                  VR,          P
                  4      # V # u upi )c              3   óŠ   "  € T F9  pVP                   ;'       g!    VP                  ;'       d    VP                  x € K;  	  R # 5ir+   )Úis_zerorG   Úis_ZeroMatrixr›   s   & r/   r\   Úany_zeros.<locals>.<genexpr>÷   s8   é € ð ,Ù"*˜3ð �;‰;×?Ð?˜3Ÿ=™=×>Ð>¨S×->Ñ->Ô?Û"*ùs   ‚AšA®ATFrF   )rj   r<   rG   r    rH   rI   )r	   rK   r?   s   &  r/   Ú	any_zerosrÚ   ö   s‚   € ß
ƒsñ ,Ø"%§(¢(ó,‡s‡s‚sñ ,Ø"%§(¢(ó,÷ ,ò ,à#&§8¢8Ó=¡8˜C¯}­}—C�C¡8ˆÐ=Ü˜( 1�+×*Ñ*¨H°R­L×,=Ñ,=Ó>Ð>Ø€Jùò >s   ÁB-Á5B-c                óÞ  € \         ;QJ d&    R V P                   4       F  '       g   K   RM	  RM! R V P                   4       4      '       g   V # . pV P                  ^ ,          pV P                  R,           FX  p\        V\        \        34      '       d'   \        V\        \        34      '       d   W#,          pKE  VP                  V4       TpKZ  	  VP                  V4       \        V!  # )a7  Merge explicit MatrixBase arguments

>>> from sympy import MatrixSymbol, Matrix, MatMul, pprint
>>> from sympy.matrices.expressions.matmul import merge_explicit
>>> A = MatrixSymbol('A', 2, 2)
>>> B = Matrix([[1, 1], [1, 1]])
>>> C = Matrix([[1, 2], [3, 4]])
>>> X = MatMul(A, B, C)
>>> pprint(X)
  [1  1] [1  2]
A*[    ]*[    ]
  [1  1] [3  4]
>>> pprint(merge_explicit(X))
  [4  6]
A*[    ]
  [4  6]

>>> X = MatMul(B, A, C)
>>> pprint(X)
[1  1]   [1  2]
[    ]*A*[    ]
[1  1]   [3  4]
>>> pprint(merge_explicit(X))
[1  1]   [1  2]
[    ]*A*[    ]
[1  1]   [3  4]
c              3   óB   "  € T F  p\        V\        4      x € K  	  R # 5ir+   )r_   r   r›   s   & r/   r\   Ú!merge_explicit.<locals>.<genexpr>  s   é € ÐB±k¨sŒz˜#œz×*Ð*³kùs   ‚TFrÓ   )rj   r<   r_   r   r   r»   r%   )ÚmatmulÚnewargsÚlastrK   s   &   r/   Úmerge_explicitrá   ý   s­   € ÷8 ‹3ÑB°f·k²kÓB�3�3Š3ÑB°f·k²kÓB×BÒBØˆØ€GØ�;‰;�q�>€DØ�{‰{˜2�ˆˆÜ�cœJ¬Ð/×0Ò0´ZÀÄzÔSYÐFZ×5[Ò5[Ø•:ŠDà�N‰N˜4Ô ØŠDñ ð ‡N�N�4Ôä�7ÑÐr2   c                óŠ   € V P                   ! 4       w  r\        R 4      ! V4      pW28w  d   \        V.VP                  O5!  # V # )zÓRemove Identities from a MatMul

This is a modified version of sympy.strategies.rm_id.
This is necessary because MatMul may contain both MatrixExprs and Exprs
as args.

See Also
========

sympy.strategies.rm_id
c                 ó   € V P                   R J # rÅ   )Úis_Identity©ry   s   &r/   r0   Úremove_ids.<locals>.<lambda>6  s   € ˜QŸ]™]¨dÑ2r2   )r}   r   rÔ   r<   )r	   r>   rŽ   rt   s   &   r/   Ú
remove_idsrç   '  sB   € ð ×$Ò$Ó&�L€FäÑ2Ô3°DÓ9€FØ„~Ü�fÐ+˜vŸ{™{Ó+Ð+àˆ
r2   c                 óT   € V P                   ! 4       w  rV^8w  d   \        V.VO5!  # V # ©rR   )r9   rÔ   )r	   r>   r?   s   &  r/   Úfactor_in_frontrê   <  s/   € Ø×,Ò,Ó.Ñ€FØ�„{Ü�fÐ(˜xÓ(Ð(Ø€Jr2   c                óÞ  € V P                   ! 4       w  rV^ ,          .p\        ^\        V4      4       EF—  pVR,          pW$,          p\        V\        4      '       d   \        VP
                  \        4      '       d_   VP
                  P                  p\        V4      p\        V4      W8) R 8X  d+   VRV)  \        VP                  ^ ,          4      .,           pK©  \        V\        4      '       dš   \        VP
                  \        4      '       dz   VP
                  P                  p	\        V	4      p\        V	4      W$WH,            8X  dA   \        VP                  ^ ,          4      p
W£R&   \        WDV,           4       F  pW¢V&   K	  	  EKX  VP                  R8X  g   VP                  R8X  d   VP                  V4       EKŽ  \        V\        4      '       d   VP                  w  rÍMT\        P                  rÜ\        V\        4      '       d   VP                  w  rïMT\        P                  rþWÎ8X  d+   Wß,           p\        VV4      P!                  RR7      VR&   EK*  \        V\"        4      '       gG    VP%                  4       pVe2   VV8X  d+   Wß,
          p\        VV4      P!                  RR7      VR&   EK†  VP                  V4       EKš  	  \)        V.VO5!  #   \&         d    Rp Lgi ; i)zôCombine consecutive powers with the same base into one, e.g.
$$A \times A^2 \Rightarrow A^3$$

This also cancels out the possible matrix inverses using the
knowledgebase of :class:`~.Inverse`, e.g.,
$$ Y \times X \times X^{-1} \Rightarrow Y $$
NF)r£   rF   )r9   re   rc   r_   r   rK   r%   r<   r5   r!   rL   rš   r»   r   r   ÚOnerl   r   rž   r   rÔ   )r	   r>   r<   Únew_argsr-   ÚAÚBÚBargsÚlÚAargsr,   rm   ÚA_baseÚA_expÚB_baseÚB_expÚnew_expÚ
B_base_invs   &                 r/   Úcombine_powersrù   B  sQ  € ð ×(Ò(Ó*�L€FØ�Q•ˆy€Hä�1”c˜$“i× ˆØ�R�LˆØ�Gˆä�aœ×!Ò!¤j°·±¼×&?Ò&?Ø—E‘E—J‘JˆEÜ�E“
ˆAÜ�E‹{˜h r s˜mÔ+Ø# C a R˜=¬H°Q·W±W¸QµZÓ,@Ð+AÕA�Ùä�aœ×!Ò!¤j°·±¼×&?Ò&?Ø—E‘E—J‘JˆEÜ�E“
ˆAÜ�E‹{˜d Q¥S˜kÔ)Ü# A§G¡G¨A¥JÓ/�Ø'˜‘Ü˜q A¥#ž�AØ&˜“Gñ 'âà�;‰;˜%Ô 1§;¡;°%Ô#7Ø�O‰O˜AÔÚä�aœ× Ò ØŸF™F‰MˆF�EàœqŸu™u�Eä�aœ× Ò ØŸF™F‰MˆF�EàœqŸu™u�EàÔØ•mˆGÜ! &¨'Ó2×7Ñ7¸UÐ7ÓCˆH�R‰LÚÜ˜F¤J×/Ò/ð"Ø#Ÿ^™^Ó-�
ð Ò%¨&°JÔ*>Ø�-�Ü% f¨gÓ6×;Ñ;ÀÐ;ÓG�˜‘ÚØ�‰˜×ña !ôd �&Ð$˜8Ó$Ð$øô ,ô "Ø!’
ð"ús   É4KËK,Ë+K,c                ó¢  € V P                   p\        V4      pV^8  d   V # V^ ,          .p\        ^V4       F�  pVR,          pW,          p\        V\        4      '       dS   \        V\        4      '       d=   VP                   ^ ,          pVP                   ^ ,          p\	        Wx,          4      VR&   K|  VP                  V4       K�  	  \        V!  # )zGRefine products of permutation matrices as the products of cycles.
    rF   )r<   rc   re   r_   r   r»   r%   )	r	   r<   rñ   rt   r-   rî   rï   Úcycle_1Úcycle_2s	   &        r/   Úcombine_permutationsrý   �  s¬   € ð �8‰8€DÜˆD‹	€AØˆ1„uØˆ
à�1�gˆY€FÜ�1�aŽ[ˆØ�2�JˆØ�GˆÜ�aÔ*×+Ò+Ü�qÔ+×,Ò,Ø—f‘f˜Q•iˆGØ—f‘f˜Q•iˆGÜ*¨7Õ+<Ó=ˆF�2‹Jà�M‰M˜!Öñ ô �6‰?Ðr2   c                óÒ  € V P                   ! 4       w  rV^ ,          .pVR,           F±  pVR,          p\        V\        4      '       d   \        V\        4      '       g   VP                  V4       KK  VP	                  4        VP                  \        VP
                  ^ ,          VP
                  ^,          4      4       WP
                  ^,          ,          pK³  	  \        V.VO5!  # )z^
Combine products of OneMatrix

e.g. OneMatrix(2, 3) * OneMatrix(3, 4) -> 3 * OneMatrix(2, 4)
rÓ   rF   )r9   r_   r#   r»   ÚpoprL   rÔ   )r	   r>   r<   rí   rï   rî   s   &     r/   Úcombine_one_matricesr   —  s®   € ð ×(Ò(Ó*�L€FØ�Q•ˆy€Hà�"�XˆXˆØ�R�LˆÜ˜!œY×'Ò'¬z¸!¼Y×/GÒ/GØ�O‰O˜AÔÙØ�‰ŒØ�‰œ	 !§'¡'¨!¥*¨a¯g©g°a­jÓ9Ô:Ø—'‘'˜!•*ÕŠñ ô �&Ð$˜8Ó$Ð$r2   c           
     ó<  € V P                   p\        V4      ^8X  dö   ^RIHp V^ ,          P                  '       d_   V^,          P
                  '       dF   T! V^ ,          P                    Uu. uF#  p\        W1^,          4      P                  4       NK%  	  up!  # V^,          P                  '       d`   V^ ,          P
                  '       dG   T! V^,          P                    Uu. uF$  p\        V^ ,          V4      P                  4       NK&  	  up!  # V # u upi u upi )zb
Simplify MatMul expressions but distributing
rational term to MatMul.

e.g. 2*(A+B) -> 2*A + 2*B
)ÚMatAdd)r<   rc   Úmataddr  Ú	is_MatAddÚis_Rationalr%   rl   )r	   r<   r  Úmats   &   r/   Údistribute_monomr  «  sÑ   € ð �8‰8€DÜ
ˆ4ƒy�A„~Ý"Ø��7××Ð  a¥×!4×!4Ð!4ÙÀ4ÈÅ7Ç<Â<ÓPÁ<¸CœF 3¨Q­Ó0×5Ñ5Ö7Á<ÑPÑQÐQØ��7××Ð  a¥×!4×!4Ð!4ÙÀ4ÈÅ7Ç<Â<ÓPÁ<¸CœF 4¨¥7¨CÓ0×5Ñ5Ö7Á<ÑPÑQÐQØ€Jùò QùâPs   Á,)DÃ#*Dc                 ó   € V ^8H  # ré   r�   rå   s   &r/   r0   r0   ¼  s   € ÐklÐpqÒkqr2   c            	     óT  € V ^ ,          P                   V R,          P                  8w  d   \        R4      h. p^ p\        V 4       F`  w  r4VP                  W,          P                   8X  g   K(  VP	                  \        WV^,            !  P                  4       4       V^,           pKb  	  V# )z'factor matrices only if they are squarez!Invalid matrices being multipliedrF   )rH   rI   ÚRuntimeErrorrg   r»   r%   rl   )r?   ÚoutÚstartr-   ÚMs   *    r/   r”   r”   Á  sŒ   € à�…{×Ñ˜8 B�<×,Ñ,Ô,ÜÐ>Ó?Ð?Ø
€CØ€EÜ˜(Ö#‰ˆØ�6‰6�X•_×)Ñ)Ö)Ø�J‰J”v˜x¨a°­cÐ2Ñ3×8Ñ8Ó:Ô;Ø�a•CŠEñ $ð €Jr2   c                ó€  € . p. pV P                    F9  pVP                  '       d   VP                  V4       K(  VP                  V4       K;  	  V^ ,          pVR,           FÂ  pWeP                  8X  dE   \	        \
        P                  ! V4      V4      '       d   \        VP                  ^ ,          4      pKW  WeP                  4       8X  dE   \	        \
        P                  ! V4      V4      '       d   \        VP                  ^ ,          4      pK¯  VP                  V4       TpKÄ  	  VP                  V4       \        V!  # )zÄ
>>> from sympy import MatrixSymbol, Q, assuming, refine
>>> X = MatrixSymbol('X', 2, 2)
>>> expr = X * X.T
>>> print(expr)
X*X.T
>>> with assuming(Q.orthogonal(X)):
...     print(refine(expr))
I
rÓ   )r<   rG   r»   ÚTr   r   Ú
orthogonalr!   rL   Ú	conjugateÚunitaryr%   )rC   Úassumptionsrß   Úexprargsr<   rà   rK   s   &&     r/   Úrefine_MatMulr  Î  så   € ð €GØ€Hà—	”	ˆØ�>�>ˆ>Ø�O‰O˜DÖ!à�N‰N˜4Ö ñ	 ð �A�;€DØ˜�|ˆ|ˆØ—&‘&Œ=œS¤§¢¨cÓ!2°K×@Ò@Ü˜CŸI™I a�LÓ)ŠDØ—N‘NÓ$Ô$¬¬Q¯YªY°s«^¸[×)IÒ)IÜ˜CŸI™I a�LÓ)ŠDà�N‰N˜4Ô ØŠDñ ð ‡N�N�4Ôä�7ÑÐr2   N)AÚsympy.assumptions.askr   r   Úsympy.assumptions.refiner   Ú
sympy.corer   r   r   Úsympy.core.mulr	   r
   Úsympy.core.numbersr   r   Úsympy.core.symbolr   Úsympy.functionsr   Úsympy.strategiesr   r   r   r   r   r   r   Úsympy.matrices.exceptionsr   Úsympy.matrices.matrixbaser   Úsympy.utilities.exceptionsr   Ú!sympy.matrices.expressions._shaper   r:   rž   r   Úmatexprr   Úmatpowr   r   Úpermutationr   Úspecialr    r!   r"   r#   r%   Úregister_handlerclassrÔ   rÚ   rá   rç   rê   rù   rý   r   r  ÚrulesrB   r”   r  r�   r2   r/   Ú<module>r(     s   ðß (Ý 2ß (Ñ (ß #ß .Ý #Ý #÷÷ ñ å >Ý 0Ý @Ý Qå Ý Ý Ý  Ý *ß EÓ EôSˆZ˜ô Sðj × Ò ˜3 ˜-¨Ô 0òò
ò(òTò*ò=%ò~ò,%ò(ð" �i Ð-AÀ>ÐSYÑ[`ÑaqÓ[rØ�O WÐ.Bð	D€ñ ‘u˜f¡f¨e¡nÐ5Ó6Ó7€ò
òðD (€ˆhÓ r2   