o
    §ƒðj:'  ã                   @   sÔ   d Z dgZddlmZ ddlmZ ddlmZmZ ddl	m
Z
mZmZ ddlmZ ddlmZmZ dd	lmZ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mZm Z  e !ee  ¡Z"G dd„ deƒZ#dS )zb
This module has all the classes and functions related to waves in optics.

**Contains**

* TWave
ÚTWaveé    )ÚBasic)ÚExpr)Ú
DerivativeÚFunction)ÚNumberÚpiÚI)ÚS)ÚSymbolÚsymbols)Ú_sympifyÚsympify)Úexp)Úsqrt)Úatan2ÚcosÚsin)Úspeed_of_lightÚmeterÚsecondc                   @   sø   e Zd ZdZdejdedƒfdd„Zedd„ ƒZ	edd	„ ƒZ
ed
d„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZedd„ ƒZdd„ Ze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.d/„ ZdS )0r   a4  
    This is a simple transverse sine wave travelling in a one-dimensional space.
    Basic properties are required at the time of creation of the object,
    but they can be changed later with respective methods provided.

    Explanation
    ===========

    It is represented as :math:`A \times cos(k*x - \omega \times t + \phi )`,
    where :math:`A` is the amplitude, :math:`\omega` is the angular frequency,
    :math:`k` is the wavenumber (spatial frequency), :math:`x` is a spatial variable
    to represent the position on the dimension on which the wave propagates,
    and :math:`\phi` is the phase angle of the wave.


    Arguments
    =========

    amplitude : Sympifyable
        Amplitude of the wave.
    frequency : Sympifyable
        Frequency of the wave.
    phase : Sympifyable
        Phase angle of the wave.
    time_period : Sympifyable
        Time period of the wave.
    n : Sympifyable
        Refractive index of the medium.

    Raises
    =======

    ValueError : When neither frequency nor time period is provided
        or they are not consistent.
    TypeError : When anything other than TWave objects is added.


    Examples
    ========

    >>> from sympy import symbols
    >>> from sympy.physics.optics import TWave
    >>> A1, phi1, A2, phi2, f = symbols('A1, phi1, A2, phi2, f')
    >>> w1 = TWave(A1, f, phi1)
    >>> w2 = TWave(A2, f, phi2)
    >>> w3 = w1 + w2  # Superposition of two waves
    >>> w3
    TWave(sqrt(A1**2 + 2*A1*A2*cos(phi1 - phi2) + A2**2), f,
        atan2(A1*sin(phi1) + A2*sin(phi2), A1*cos(phi1) + A2*cos(phi2)), 1/f, n)
    >>> w3.amplitude
    sqrt(A1**2 + 2*A1*A2*cos(phi1 - phi2) + A2**2)
    >>> w3.phase
    atan2(A1*sin(phi1) + A2*sin(phi2), A1*cos(phi1) + A2*cos(phi2))
    >>> w3.speed
    299792458*meter/(second*n)
    >>> w3.angular_velocity
    2*pi*f

    NÚnc           	      C   s²   |d urt |ƒ}tj| }|d ur)t |ƒ}tj| }|d ur)|tj| kr)tdƒ‚|d u r5|d u r5tdƒ‚|d u r;|}|d u rA|}t |ƒ}t |ƒ}t|ƒ}t | |||||¡}|S )Nz/frequency and time_period should be consistent.z*Either frequency or time period is needed.)r   r
   ÚOneÚ
ValueErrorr   r   Ú__new__)	ÚclsÚ	amplitudeÚ	frequencyÚphaseÚtime_periodr   Ú
_frequencyÚ_time_periodÚobj© r#   úœ/tmp/claude-1000/-var-www-html-academy/3f42efd1-c2b7-4d08-9b05-30d86bb35479/scratchpad/piper/venv/lib/python3.10/site-packages/sympy/physics/optics/waves.pyr   Y   s(   

zTWave.__new__c                 C   ó
   | j d S )a!  
        Returns the amplitude of the wave.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.amplitude
        A
        r   ©Úargs©Úselfr#   r#   r$   r   v   s   
zTWave.amplitudec                 C   r%   )a?  
        Returns the frequency of the wave,
        in cycles per second.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.frequency
        f
        é   r&   r(   r#   r#   r$   r   ‡   ó   
zTWave.frequencyc                 C   r%   )a5  
        Returns the phase angle of the wave,
        in radians.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.phase
        phi
        é   r&   r(   r#   r#   r$   r   ™   r+   zTWave.phasec                 C   r%   )aI  
        Returns the temporal period of the wave,
        in seconds per cycle.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.time_period
        1/f
        é   r&   r(   r#   r#   r$   r   «   r+   zTWave.time_periodc                 C   r%   )z<
        Returns the refractive index of the medium
        é   r&   r(   r#   r#   r$   r   ½   s   
zTWave.nc                 C   s   t | j| j  S )aš  
        Returns the wavelength (spatial period) of the wave,
        in meters per cycle.
        It depends on the medium of the wave.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.wavelength
        299792458*meter/(second*f*n)
        )Úcr   r   r(   r#   r#   r$   Ú
wavelengthÄ   s   zTWave.wavelengthc                 C   s   | j | j S )a�  
        Returns the propagation speed of the wave,
        in meters per second.
        It is dependent on the propagation medium.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.speed
        299792458*meter/(second*n)
        )r0   r   r(   r#   r#   r$   ÚspeedØ   s   zTWave.speedc                 C   s   dt  | j S )aS  
        Returns the angular velocity of the wave,
        in radians per second.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.angular_velocity
        2*pi*f
        r,   )r   r   r(   r#   r#   r$   Úangular_velocityë   ó   zTWave.angular_velocityc                 C   s   dt  | j S )a_  
        Returns the wavenumber of the wave,
        in radians per meter.

        Examples
        ========

        >>> from sympy import symbols
        >>> from sympy.physics.optics import TWave
        >>> A, phi, f = symbols('A, phi, f')
        >>> w = TWave(A, f, phi)
        >>> w.wavenumber
        pi*second*f*n/(149896229*meter)
        r,   )r   r0   r(   r#   r#   r$   Ú
wavenumberý   r3   zTWave.wavenumberc                 C   s    ddl m} t| ƒj|| jƒ S )z!String representation of a TWave.r   )Ússtr)Úsympy.printingr5   ÚtypeÚ__name__r'   )r)   r5   r#   r#   r$   Ú__str__  s   zTWave.__str__c              	   C   s¼   t |tƒrU| j|jkrQ| j|jkrQtt| jd |jd  d| j |j t| j|j ƒ  ƒ| jt| jt	| jƒ |jt	|jƒ  | jt| jƒ |jt|jƒ  ƒƒS t
dƒ‚tt|ƒjd ƒ‚)z�
        Addition of two waves will result in their superposition.
        The type of interference will depend on their phase angles.
        r,   zJInterference of waves with different frequencies has not been implemented.z# and TWave objects cannot be added.)Ú
isinstancer   r   r0   r   r   r   r   r   r   ÚNotImplementedErrorÚ	TypeErrorr7   r8   ©r)   Úotherr#   r#   r$   Ú__add__  s,   
ÿÿ
ÿÿÿÿþü
zTWave.__add__c                 C   sD   t |ƒ}t|tƒrt| j| g| jdd… ¢R Ž S tt|ƒjd ƒ‚)zT
        Multiplying a wave by a scalar rescales the amplitude of the wave.
        r*   Nz( and TWave objects cannot be multiplied.)	r   r:   r   r   r   r'   r<   r7   r8   r=   r#   r#   r$   Ú__mul__,  s   
 zTWave.__mul__c                 C   s   |   d| ¡S ©Néÿÿÿÿ©r?   r=   r#   r#   r$   Ú__sub__6  s   zTWave.__sub__c                 C   s
   |   d¡S rA   ©r@   r(   r#   r#   r$   Ú__neg__9  ó   
zTWave.__neg__c                 C   ó
   |   |¡S ©NrC   r=   r#   r#   r$   Ú__radd__<  rG   zTWave.__radd__c                 C   rH   rI   rE   r=   r#   r#   r$   Ú__rmul__?  rG   zTWave.__rmul__c                 C   s   |    |¡S rI   )rJ   r=   r#   r#   r$   Ú__rsub__B  s   zTWave.__rsub__c                 O   s8   | j t| jtdƒ | jtdƒ  | j td  dd� S )NÚxÚtr,   F)Úevaluate)r   r   r4   r   r2   r   r   ©r)   r'   Úkwargsr#   r#   r$   Ú_eval_rewrite_as_sinE  s   ÿÿÿÿzTWave._eval_rewrite_as_sinc                 O   s,   | j t| jtdƒ | jtdƒ  | j ƒ S ©NrM   rN   )r   r   r4   r   r2   r   rP   r#   r#   r$   Ú_eval_rewrite_as_cosI  s
   ÿÿzTWave._eval_rewrite_as_cosc                 O   sD   t dƒ\}}}}tdƒ}t|||ƒ|dƒ|| t|||ƒ|dƒ  S )Nzmu, epsilon, x, tÚEr,   )r   r   r   )r)   r'   rQ   ÚmuÚepsilonrM   rN   rU   r#   r#   r$   Ú_eval_rewrite_as_pdeM  s   ,zTWave._eval_rewrite_as_pdec                 O   s0   | j tt| jtdƒ | jtdƒ  | j  ƒ S rS   )r   r   r	   r4   r   r2   r   rP   r#   r#   r$   Ú_eval_rewrite_as_expR  s
   ÿ
ÿzTWave._eval_rewrite_as_exp)r8   Ú
__module__Ú__qualname__Ú__doc__r
   ÚZeror   r   Úpropertyr   r   r   r   r   r0   r1   r2   r4   r9   Ú__repr__r?   r@   rD   rF   rJ   rK   rL   rR   rT   rX   rY   r#   r#   r#   r$   r      sL    ?
ú









N)$r\   Ú__all__Úsympy.core.basicr   Úsympy.core.exprr   Úsympy.core.functionr   r   Úsympy.core.numbersr   r   r	   Úsympy.core.singletonr
   Úsympy.core.symbolr   r   Úsympy.core.sympifyr   r   Ú&sympy.functions.elementary.exponentialr   Ú(sympy.functions.elementary.miscellaneousr   Ú(sympy.functions.elementary.trigonometricr   r   r   Úsympy.physics.unitsr   r   r   Ú
convert_tor/   r   r#   r#   r#   r$   Ú<module>   s    