Skip to content

Python wrapper for Mie theory libraries used in aerosol radiative calculations

License

Notifications You must be signed in to change notification settings

darothen/py-mie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mie Library

Build Status DOI

This library wraps several Fortran implementations of Mie theory calculators ([1], [2], ... ) with a Python interface. The Fortran code itself has not been changed from their original form, and two-levels of drivers are available to run them. At the moment, an interface to the raw Mie codes (with all input parameters and output quantities) is not provided, although this functionality will probably be added in the future.

Installation

Currently, you can install the package directly from the source code or via pip. To install directly from source, download the source code and execute:

    $ pip install -e .

The package can also be installed directly from GitHub via the command:

    $ pip install git+https://github.com/darothen/py-mie.git@branch-name

The only package dependency is f2py via numpy or scipy.

Unit Tests

To run the unit tests using nosetests, run the following:

    $ nosetests

Authors

This library was packaged by Daniel Rothenberg (Massachusetts Institute of Technology). The Mie code and specialized interfaces have been provided by:

  • Rahul Zaveri (Pacific Northwest National Labs)
  • Alexander Avramov (Massachusetts Institute of Technology)

Citation

If this wrapper library was useful to you, please consider citing its DOI along with the relevant scientific citation to one of the References below. It's up to us to change our academic culture and ensure that researchers who take the time to build useful tools are properly credited for their hard work!

References

  1. Owen B. Toon and T. P. Ackerman, "Algorithms for the calculation of scattering by stratified spheres," Appl. Opt. 20, 3657-3660 (1981)
  2. C. F. Bohren and D. R. Huffman, Absorption and Scattering of Light by Small Particles, New York, Wiley, 1983, 530 pages