+
    åûjò  ã                   ó†   € ^ RI Ht ^ RI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	 R
]4      tR tR# )é    )ÚBasic)ÚExprÚExprBuilder)ÚS)Údefault_sort_key)Úuniquely_named_symbol)Úsympify)Ú
MatrixBase)ÚNonSquareMatrixErrorc                   ól   a € ] tR t^t o RtRtRtR tR tR t	R t
]R 4       tR tR	 tR
 tR tRtV tR# )ÚTracea  Matrix Trace

Represents the trace of a matrix expression.

Examples
========

>>> from sympy import MatrixSymbol, Trace, eye
>>> A = MatrixSymbol('A', 3, 3)
>>> Trace(A)
Trace(A)
>>> Trace(eye(3))
Trace(Matrix([
[1, 0, 0],
[0, 1, 0],
[0, 0, 1]]))
>>> Trace(eye(3)).simplify()
3
Tc                óÔ   € \        V4      pVP                  '       g   \        R \        V4      ,          4      hVP                  RJ d   \        R4      h\        P                  ! W4      # )z#input to Trace, %s, is not a matrixFzTrace of a non-square matrix)r	   Ú	is_MatrixÚ	TypeErrorÚstrÚ	is_squarer   r   Ú__new__)ÚclsÚmats   &&Ú\C:\Ai_Coding\apps\studio\ComfyUI\.venv\Lib\site-packages\sympy\matrices\expressions\trace.pyr   ÚTrace.__new__"   sP   € Ü�c‹lˆà�}�}ˆ}ÜÐAÄCÈÃHÕLÓMÐMà�=‰=˜EÓ!Ü&Ð'EÓFÐFä�}Š}˜SÓ&Ð&ó    c                ó   € V # ©N© ©Úselfs   &r   Ú_eval_transposeÚTrace._eval_transpose-   s   € Øˆr   c                óö   € ^ RI Hp ^RIHp \	        W4      '       d!   V P                  V4      P                  V4      # V P                  4       p\	        V\        4      '       d   \        hVP                  V4      # )r   ©ÚSum)ÚMatrixElement)Úsympy.concrete.summationsr"   Úmatexprr#   Ú
isinstanceÚrewriteÚdiffÚdoitr   ÚNotImplementedErrorÚ_eval_derivative)r   Úvr"   r#   Úexprs   &&   r   r+   ÚTrace._eval_derivative0   s\   € Ý1Ý*Ü�a×'Ò'Ø—<‘< Ó$×)Ñ)¨!Ó,Ð,Ø�y‰y‹{ˆÜ�dœE×"Ò"ä%Ð%Ø×$Ñ$ QÓ'Ð'r   c           
     ór  € ^ RI HpHp V P                  ^ ,          P	                  V4      pV EF  pVP
                  ^8X  dO   \        V\        VVP                  ^ ,          VP                  ^,          .4      R.VP                  R7      Vn        MM\        V\        VVP                  ^ ,          VP                  ^,          VP
                  .4      RR.4      Vn        \        P                  \        P                  .Vn        VP                  Vn        VP                  Vn        ^ Vn        ^Vn        EK  	  V# )r   )ÚArrayTensorProductÚArrayContraction)Ú	validator)é   é   )r   é   )Ú0sympy.tensor.array.expressions.array_expressionsr0   r1   ÚargsÚ_eval_derivative_matrix_linesÚhigherr   Ú_linesÚ	_validater   ÚOneÚ_first_pointer_parentÚ_second_pointer_parentÚ_first_pointer_indexÚ_second_pointer_index)r   Úxr0   r1   ÚrÚlrs   &&    r   r8   Ú#Trace._eval_derivative_matrix_lines;   s  € ßiØ�I‰I�a�L×6Ñ6°qÓ9ˆÜˆBØ�y‰y˜AŒ~Ü'Ø$ä#Ø.à "§	¡	¨!¥Ø "§	¡	¨!¥ðóð ð	ð /×8Ñ8ô�•	ô  (Ø$ä#Ø.à "§	¡	¨!¥Ø "§	¡	¨!¥Ø "§	¡	ðóð  ð
ó�”	ô Ÿ™¤§¡˜ˆBŒIØ')§y¡yˆBÔ$Ø(*¯	©	ˆBÔ%Ø&'ˆBÔ#Ø'(ˆB×$ñI ðJ ˆr   c                ó(   € V P                   ^ ,          # )r   )r7   r   s   &r   ÚargÚ	Trace.arge   s   € à�y‰y˜�|Ðr   c                ó@  € VP                  R R4      '       d>   V P                  P                  ! R/ VB pVP                  4       pVe   V# \	        V4      # \        V P                  \        4      '       d   \        V P                  4      # \	        V P                  4      # )ÚdeepTr   )ÚgetrF   r)   Ú_eval_tracer   r&   r
   Útrace)r   ÚhintsrF   Úresults   &,  r   r)   Ú
Trace.doiti   sx   € Ø�9‰9�V˜T×"Ò"Ø—(‘(—-’-Ñ( %Ñ(ˆCØ—_‘_Ó&ˆFØÒ!Ø�ä˜S“zÐ!ô ˜$Ÿ(™(¤J×/Ò/Ü˜TŸX™X“Ð&ä˜TŸX™X“Ð&r   c                ód   € \        V P                  P                  4       4      P                  4       # r   )r   rF   Úas_explicitr)   r   s   &r   rQ   ÚTrace.as_explicitx   s#   € Ü�T—X‘X×)Ñ)Ó+Ó,×1Ñ1Ó3Ð3r   c                ó  aa€ ^ RI Hp ^ RIHo V P                  o\        SV4      '       dÔ   VV3R lp\        \        \        SP                  4      4      VR7      p\        SP                  V,          S4      '       dD   S! S4      P                  4       o\        \        \        SP                  4      4      V3R lR7      pVP                  SP                  VR SP                  RV ,           4      o\        S4      # V # )r   )ÚMatMul)Ú	Transposec                 ó|   <€ SP                   V ,          p\        VS4      '       d   VP                  p\        V4      # r   )r7   r&   rF   r   )rA   ÚarU   Ú	trace_args   & €€r   Úget_arg_keyÚ%Trace._normalize.<locals>.get_arg_key„   s2   ø€ Ø—N‘N 1Õ%�Ü˜a ×+Ò+ØŸ™�AÜ'¨Ó*Ð*r   )Úkeyc                 ó<   <€ \        SP                  V ,          4      # r   )r   r7   )rA   rX   s   &€r   Ú<lambda>Ú"Trace._normalize.<locals>.<lambda>�   s   ø€ ÔGWÐXa×XfÑXfÐghÕXiÔGjr   N)Ú!sympy.matrices.expressions.matmulrT   Ú$sympy.matrices.expressions.transposerU   rF   r&   ÚminÚrangeÚlenr7   r)   Úfromiterr   )r   rT   rY   ÚindminrU   rX   s   &   @@r   Ú
_normalizeÚTrace._normalize{   sÁ   ù€ õ 	=ÝBØ—H‘Hˆ	Ü�i ×(Ò(ö+ô œœs 9§>¡>Ó2Ó3¸ÔEˆFÜ˜)Ÿ.™.¨Õ0°)×<Ò<Ù% iÓ0×5Ñ5Ó7�	ÜœU¤3 y§~¡~Ó#6Ó7Ô=jÔk�ØŸ™¨	¯©°v°wÐ(?À)Ç.Á.ÐQXÐRXÐBYÕ(YÓZˆIÜ˜Ó#Ð#Øˆr   c                óº   € ^ RI Hp \        RV.4      pV! V P                  WD3,          V^ V P                  P                  ^,
          34      pVP                  4       # )r   r!   Úi)r$   r"   r   rF   Úrowsr)   )r   r-   Úkwargsr"   ri   Úss   &&,   r   Ú_eval_rewrite_as_SumÚTrace._eval_rewrite_as_Sum’   sH   € Ý1Ü! #¨ vÓ.ˆÙ�—‘˜˜•  A t§x¡x§}¡}°qÕ'8Ð 9Ó:ˆØ�v‰v‹xˆr   r   N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__Úis_TraceÚis_commutativer   r   r+   r8   ÚpropertyrF   r)   rQ   rf   rm   Ú__static_attributes__Ú__classdictcell__)Ú__classdict__s   @r   r   r      sX   ø‡ € ñð& €HØ€Nò	'òò	(ò(ðT ñó ðò'ò4ò÷.ð r   r   c                ó4   € \        V 4      P                  4       # )zòTrace of a Matrix.  Sum of the diagonal elements.

Examples
========

>>> from sympy import trace, Symbol, MatrixSymbol, eye
>>> n = Symbol('n')
>>> X = MatrixSymbol('X', n, n)  # A square matrix
>>> trace(2*X)
2*Trace(X)
>>> trace(eye(3))
3
)r   r)   )r-   s   &r   rL   rL   ™   s   € ô �‹;×ÑÓÐr   N)Úsympy.core.basicr   Úsympy.core.exprr   r   Úsympy.core.singletonr   Úsympy.core.sortingr   Úsympy.core.symbolr   Úsympy.core.sympifyr	   Úsympy.matrices.matrixbaser
   Úsympy.matrices.exceptionsr   r   rL   r   r   r   Ú<module>rƒ      s1   ðÝ "ß -Ý "Ý /Ý 3Ý &Ý 0Ý :ôKˆDô Kô\r   