o
    §ƒðjw  ã                   @   s„   d Z ddlmZ ddlmZ ddlmZ ddlmZmZm	Z	 ddl
mZ g d¢ZG dd	„ d	eƒZG d
d„ deƒZG dd„ de	ƒZdS )zFermionic quantum operators.é    )ÚInteger©ÚS)ÚOperator)ÚHilbertSpaceÚKetÚBra)ÚKroneckerDelta)Ú	FermionOpÚFermionFockKetÚFermionFockBrac                   @   s„   e Zd ZdZedd„ ƒZedd„ ƒZedd„ ƒZdd	„ Z	d
d„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdS )r
   a"  A fermionic operator that satisfies {c, Dagger(c)} == 1.

    Parameters
    ==========

    name : str
        A string that labels the fermionic mode.

    annihilation : bool
        A bool that indicates if the fermionic operator is an annihilation
        (True, default value) or creation operator (False)

    Examples
    ========

    >>> from sympy.physics.quantum import Dagger, AntiCommutator
    >>> from sympy.physics.quantum.fermion import FermionOp
    >>> c = FermionOp("c")
    >>> AntiCommutator(c, Dagger(c)).doit()
    1
    c                 C   ó
   | j d S ©Nr   )Úargs©Úself© r   úŸ/tmp/claude-1000/-var-www-html-academy/3f42efd1-c2b7-4d08-9b05-30d86bb35479/scratchpad/piper/venv/lib/python3.10/site-packages/sympy/physics/quantum/fermion.pyÚname'   ó   
zFermionOp.namec                 C   s   t | jd ƒS )Né   )Úboolr   r   r   r   r   Úis_annihilation+   s   zFermionOp.is_annihilationc                 C   s   dS )N)ÚcTr   r   r   r   r   Údefault_args/   ó   zFermionOp.default_argsc                 O   sd   t |ƒdvrtd| ƒ‚t |ƒdkr|d tjf}t |ƒdkr)|d t|d ƒf}tj| g|¢R Ž S )N)r   é   z"1 or 2 parameters expected, got %sr   r   r   )ÚlenÚ
ValueErrorr   ÚOner   r   Ú__new__)Úclsr   Úhintsr   r   r   r    3   s   zFermionOp.__new__c                 K   s   d|v r|d rt jS d S )NÚindependent©r   ÚZero©r   Úotherr"   r   r   r   Ú_eval_commutator_FermionOp?   s   z$FermionOp._eval_commutator_FermionOpc                 K   sB   | j |j kr| js|jrtjS d S d|v r|d rd|  | S d S )Nr#   r   )r   r   r   r   r&   r   r   r   Ú_eval_anticommutator_FermionOpF   s   üz(FermionOp._eval_anticommutator_FermionOpc                 K   s   d|  | S )Nr   r   r&   r   r   r   Ú_eval_anticommutator_BosonOpR   s   z&FermionOp._eval_anticommutator_BosonOpc                 K   s   t jS ©Nr$   r&   r   r   r   Ú_eval_commutator_BosonOpV   s   z"FermionOp._eval_commutator_BosonOpc                 C   s   t t| jƒ| j ƒS r+   )r
   Ústrr   r   r   r   r   r   Ú_eval_adjointY   s   zFermionOp._eval_adjointc                 G   ó"   | j r
dt| jƒ S dt| jƒ S )Nz{%s}z{{%s}^\dagger}©r   r-   r   ©r   Úprinterr   r   r   r   Ú_print_contents_latex\   ó   zFermionOp._print_contents_latexc                 G   r/   )Nz%sz
Dagger(%s)r0   r1   r   r   r   Ú_print_contentsb   r4   zFermionOp._print_contentsc                 G   s:   ddl m} |j| jd g|¢R Ž }| jr|S ||dƒ S )Nr   )Ú
prettyFormu   â€ )Ú sympy.printing.pretty.stringpictr6   Ú_printr   r   )r   r2   r   r6   Úpformr   r   r   Ú_print_contents_prettyh   s
   z FermionOp._print_contents_prettyc                 C   sl   ddl m} |dkr|jS |dkr| S |dkdkr!|jdkr!|jS |dk dks,|jdkr0tdƒ‚t | |¡S )Nr   r   r   TFzBFermionic operators can only be raised to a positive integer power)Úsympy.core.singletonr   r   Ú
is_integerr%   r   r   Ú_eval_power)r   Úexpr   r   r   r   r=   p   s   zFermionOp._eval_powerN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Úpropertyr   r   Úclassmethodr   r    r(   r)   r*   r,   r.   r3   r5   r:   r=   r   r   r   r   r
      s$    


r
   c                   @   sL   e Zd ZdZdd„ Zedd„ ƒZedd„ ƒZedd	„ ƒZ	d
d„ Z
dd„ ZdS )r   zxFock state ket for a fermionic mode.

    Parameters
    ==========

    n : Number
        The Fock state number.

    c                 C   ó   |dvrt dƒ‚t | |¡S ©N)r   r   zn must be 0 or 1)r   r   r    ©r!   Únr   r   r   r    ˆ   ó   zFermionFockKet.__new__c                 C   r   r   ©Úlabelr   r   r   r   rH   �   r   zFermionFockKet.nc                 C   ó   t S r+   )r   r   r   r   r   Ú
dual_class‘   r   zFermionFockKet.dual_classc                 C   s   t ƒ S r+   )r   )r!   rK   r   r   r   Ú_eval_hilbert_space•   s   z"FermionFockKet._eval_hilbert_spacec                 K   s   t | j|jƒS r+   )r	   rH   )r   Úbrar"   r   r   r   Ú!_eval_innerproduct_FermionFockBra™   s   z0FermionFockKet._eval_innerproduct_FermionFockBrac                 K   s6   |j r| jdkrtdƒS tjS | jdkrtdƒS tjS )Nr   r   )r   rH   r   r   r%   )r   ÚopÚoptionsr   r   r   Ú_apply_from_right_to_FermionOpœ   s   

z-FermionFockKet._apply_from_right_to_FermionOpN)r?   r@   rA   rB   r    rC   rH   rD   rM   rN   rP   rS   r   r   r   r   r   }   s    



r   c                   @   s0   e Zd ZdZdd„ Zedd„ ƒZedd„ ƒZdS )	r   zxFock state bra for a fermionic mode.

    Parameters
    ==========

    n : Number
        The Fock state number.

    c                 C   rE   rF   )r   r   r    rG   r   r   r   r    ´   rI   zFermionFockBra.__new__c                 C   r   r   rJ   r   r   r   r   rH   ¹   r   zFermionFockBra.nc                 C   rL   r+   )r   r   r   r   r   rM   ½   r   zFermionFockBra.dual_classN)	r?   r@   rA   rB   r    rC   rH   rD   rM   r   r   r   r   r   ©   s    

r   N)rB   Úsympy.core.numbersr   r;   r   Úsympy.physics.quantumr   r   r   r   Ú(sympy.functions.special.tensor_functionsr	   Ú__all__r
   r   r   r   r   r   r   Ú<module>   s    l,