
    \h                     `   S r SSKJrJrJrJr  S/rSSKJr  SSK	J
r
  SSKJr  SSKJr  SSKJrJrJr  \R$                  " \\-  5      r\R$                  " \S	-  \S
-  -  \\S-  -  -  5      r\R$                  " \\-  \S	-  \S	-  -  -  5      r " S S\5      r " S S\5      r " S S\5      rg)z
**Contains**

* Medium
    )secondmeterkilogramampereMedium)Basic)Str)_sympify)sqrt)speed_of_lightu0e0         c                   R    \ rS rSrSrS	S jr\S 5       r\S 5       r\S 5       r	Sr
g)
r      a  
This class represents an optical medium. The prime reason to implement this is
to facilitate refraction, Fermat's principle, etc.

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

An optical medium is a material through which electromagnetic waves propagate.
The permittivity and permeability of the medium define how electromagnetic
waves propagate in it.


Parameters
==========

name: string
    The display name of the Medium.

permittivity: Sympifyable
    Electric permittivity of the space.

permeability: Sympifyable
    Magnetic permeability of the space.

n: Sympifyable
    Index of refraction of the medium.


Examples
========

>>> from sympy.abc import epsilon, mu
>>> from sympy.physics.optics import Medium
>>> m1 = Medium('m1')
>>> m2 = Medium('m2', epsilon, mu)
>>> m1.intrinsic_impedance
149896229*pi*kilogram*meter**2/(1250000*ampere**2*second**3)
>>> m2.refractive_index
299792458*meter*sqrt(epsilon*mu)/second


References
==========

.. [1] https://en.wikipedia.org/wiki/Optical_medium

Nc                    [        U[        5      (       d  [        U5      nUb  [        U5      OUnUb  [        U5      OUnUb  [        U5      OUnUbd  Ub!  Uc  US-  [        S-  U-  -  n[	        XU5      $ Ub!  Uc  US-  [        S-  U-  -  n[	        XU5      $ Ub  Ub  [        S5      e[        X5      $ Ub  Ub  [	        XU5      $ Uc  Uc  [	        U[        [        5      $ [        S5      e)Nr   zBSpecifying all of permittivity, permeability, and n is not allowedz^Arguments are underspecified. Either specify n or any two of permittivity, permeability, and n)	
isinstancer	   r
   cMediumPP
ValueErrorMediumN_e0mksa_u0mksa)clsnamepermittivitypermeabilityns        S/var/www/auris/envauris/lib/python3.13/site-packages/sympy/physics/optics/medium.py__new__Medium.__new__H   s   $$$t9D1=1Ix-|1=1Ix-|=HQKa='L,@ !tQT,%67LAA)l.B !tQT,%67LAA)l.F !efft''%,*BD==!l&:D'733 3 4 4    c                      U R                   S   $ )Nr   argsselfs    r!   r   Medium.namec       yy|r$   c                 (    [         U R                  -  $ )z
Returns speed of the electromagnetic wave travelling in the medium.

Examples
========

>>> from sympy.physics.optics import Medium
>>> m = Medium('m')
>>> m.speed
299792458*meter/second
>>> m2 = Medium('m2', n=1)
>>> m.speed == m2.speed
True

)r   r    r(   s    r!   speedMedium.speedg   s    " 466zr$   c                 (    [         U R                  -  $ )z
Returns refractive index of the medium.

Examples
========

>>> from sympy.physics.optics import Medium
>>> m = Medium('m')
>>> m.refractive_index
1

)r   r-   r(   s    r!   refractive_indexMedium.refractive_indexz   s     $**r$    )NNN)__name__
__module____qualname____firstlineno____doc__r"   propertyr   r-   r0   __static_attributes__r2   r$   r!   r   r      sI    .`46    $  r$   c                   <   ^  \ rS rSrSrU 4S jr\S 5       rSrU =r	$ )r      al  
Represents an optical medium for which only the refractive index is known.
Useful for simple ray optics.

This class should never be instantiated directly.
Instead it should be instantiated indirectly by instantiating Medium with
only n specified.

Examples
========
>>> from sympy.physics.optics import Medium
>>> m = Medium('m', n=2)
>>> m
MediumN(Str('m'), 2)
c                 0   > [         [        U ]  XU5      nU$ Nsuperr   r"   )r   r   r    obj	__class__s       r!   r"   MediumN.__new__   s    FC(A6
r$   c                      U R                   S   $ )N   r&   r(   s    r!   r    	MediumN.n   r+   r$   r2   )
r3   r4   r5   r6   r7   r"   r8   r    r9   __classcell__rA   s   @r!   r   r      s!       r$   r   c                   l   ^  \ rS rSrSrU 4S jr\S 5       r\S 5       r\S 5       r	\S 5       r
SrU =r$ )	r      a  
Represents an optical medium for which the permittivity and permeability are known.

This class should never be instantiated directly. Instead it should be
instantiated indirectly by instantiating Medium with any two of
permittivity, permeability, and n specified, or by not specifying any
of permittivity, permeability, or n, in which case default values for
permittivity and permeability will be used.

Examples
========
>>> from sympy.physics.optics import Medium
>>> from sympy.abc import epsilon, mu
>>> m1 = Medium('m1', permittivity=epsilon, permeability=mu)
>>> m1
MediumPP(Str('m1'), epsilon, mu)
>>> m2 = Medium('m2')
>>> m2
MediumPP(Str('m2'), 625000*ampere**2*second**4/(22468879468420441*pi*kilogram*meter**3), pi*kilogram*meter/(2500000*ampere**2*second**2))
c                 0   > [         [        U ]  XX#5      nU$ r=   r>   )r   r   r   r   r@   rA   s        r!   r"   MediumPP.__new__   s    FC(LO
r$   c                 F    [        U R                  U R                  -  5      $ )a#  
Returns intrinsic impedance of the medium.

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

The intrinsic impedance of a medium is the ratio of the
transverse components of the electric and magnetic fields
of the electromagnetic wave travelling in the medium.
In a region with no electrical conductivity it simplifies
to the square root of ratio of magnetic permeability to
electric permittivity.

Examples
========

>>> from sympy.physics.optics import Medium
>>> m = Medium('m')
>>> m.intrinsic_impedance
149896229*pi*kilogram*meter**2/(1250000*ampere**2*second**3)

)r   r   r   r(   s    r!   intrinsic_impedanceMediumPP.intrinsic_impedance   s     0 D%%(9(99::r$   c                      U R                   S   $ )z
Returns electric permittivity of the medium.

Examples
========

>>> from sympy.physics.optics import Medium
>>> m = Medium('m')
>>> m.permittivity
625000*ampere**2*second**4/(22468879468420441*pi*kilogram*meter**3)

rD   r&   r(   s    r!   r   MediumPP.permittivity        yy|r$   c                      U R                   S   $ )z
Returns magnetic permeability of the medium.

Examples
========

>>> from sympy.physics.optics import Medium
>>> m = Medium('m')
>>> m.permeability
pi*kilogram*meter/(2500000*ampere**2*second**2)

r   r&   r(   s    r!   r   MediumPP.permeability   rQ   r$   c                 T    [         [        U R                  U R                  -  5      -  $ r=   )r   r   r   r   r(   s    r!   r    
MediumPP.n   s#    d''(9(99:::r$   r2   )r3   r4   r5   r6   r7   r"   r8   rM   r   r   r    r9   rF   rG   s   @r!   r   r      s]    , ; ;2     ; ;r$   r   N)r7   sympy.physics.unitsr   r   r   r   __all__sympy.core.basicr   sympy.core.symbolr	   sympy.core.sympifyr
   (sympy.functions.elementary.miscellaneousr   r   r   r   
convert_tor   r   r   r   r   r   r2   r$   r!   <module>r]      s   
 @ ?* " ! ' 9 6 6 eFl+
--	&!)+XeQh->?
@
--h	&!)(;<
=rU rjf 6W;v W;r$   