Metadata-Version: 2.1
Name: miepython
Version: 2.0.1
Summary: Mie scattering of a plane wave by a sphere
Home-page: https://github.com/scottprahl/miepython.git
Author: Scott Prahl
Author-email: scott.prahl@oit.edu
License: MIT
Description: miepython
        =========
        
        .. image:: https://colab.research.google.com/assets/colab-badge.svg
           :target: https://colab.research.google.com/github/scottprahl/miepython/blob/master
        
        .. image:: https://img.shields.io/badge/readthedocs-latest-blue.svg
           :target: https://miepython.readthedocs.io
        
        .. image:: https://img.shields.io/badge/github-code-green.svg
           :target: https://github.com/scottprahl/miepython
        
        .. image:: https://img.shields.io/badge/MIT-license-yellow.svg
           :target: https://github.com/scottprahl/miepython/blob/master/LICENSE.txt
        
        __________
        
        ``miepython`` is a pure Python module to calculate light scattering by
        non-absorbing, partially-absorbing, or perfectly conducting spheres. Mie
        theory is used, following `the procedure described by Wiscombe
        <http://opensky.ucar.edu/islandora/object/technotes:232>`_. This code has
        been validated against his results. 
        
        This code provides functions for calculating the extinction efficiency, scattering efficiency, backscattering, and scattering asymmetry. Moreover, a set of angles can be given to calculate the scattering for a sphere.
        
        Pay Attention!
        --------------
        
        When comparing different Mie scattering codes, make sure that you're aware of the conventions used by each code.  ``miepython`` makes the following assumptions
        
        #. the imaginary part of the complex index of refraction for absorbing spheres is *negative*.  
        
        #. the scattering phase function is normalized so it equals the *single scattering albedo* when integrated over 4π steradians.
        
        Using miepython
        ---------------
        
        1. You can install locally using pip::
            
            pip install --user miepython
        
        2. or `run this code in the cloud using Google Collaboratory <https://colab.research.google.com/github/scottprahl/miepython/blob/master>`_ by selecting the Jupyter notebook that interests you.
        
        An example
        ----------
        
        The following code::
        
            import miepython
            
            m = 1.5-1j
            x = 1
            qext, qsca, qback, g = miepython.mie(m,x)
        
            print("The extinction efficiency  is %.3f" % qext)
            print("The scattering efficiency  is %.3f" % qsca)
            print("The backscatter efficiency is %.3f" % qback)
            print("The scattering anisotropy  is %.3f" % g)
        
        should produce::
        
            The extinction efficiency  is 2.336
            The scattering efficiency  is 0.663
            The backscatter efficiency is 0.573
            The scattering anisotropy  is 0.192
        
        Here are a few short scripts in the github repository.
        
        * `Extinction Efficiency of Absorbing and Non-Absorbing Spheres <https://github.com/scottprahl/miepython/blob/master/miepython/examples/01_dielectric.py>`_ 
        * `Four Micron Glass Spheres <https://github.com/scottprahl/miepython/blob/master/miepython/examples/02_glass.py>`_ 
        * `One Micron Water Droplets <https://github.com/scottprahl/miepython/blob/master/miepython/examples/03_droplets.py>`_ 
        * `Gold Nanospheres <https://github.com/scottprahl/miepython/blob/master/miepython/examples/04_gold.py>`_ 
        
        Detailed documentation is available at <https://miepython.readthedocs.io>
        
        
        License
        -------
        
        ``miepython`` is licensed under the terms of the MIT license.
        
Keywords: mie,scattering,rainbow,droplet,backscatter,sphere,nanoparticle,sphere,cloud,phase function,efficiency,rayleigh,backscattering
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/x-rst
