miepy 0.4.0

Python module to solve Maxwell's equations for a cluster of particles using the generalized multiparticle Mie theory (GMMT)

MiePy is a Python module for the generalized multiparticle Mie theory (GMMT), also known as the aggregate T-matrix method. MiePy solves the electrodynamics of a collection of spherical or non-spherical scatterers with an arbitrary incident source.

Features

• Non-spherical particles using the T-matrix formulation via the null-field method with discrete sources (NFM-DS). Includes cylinders, spheroids, ellipsoids, cubes and polygonal prisms

• Arbitrary incident sources (plane waves, Gaussian beams, HG and LG beams, point dipoles) via near-field point matching or far-field integration

• Periodic boundary conditions with various lattice types (square, hexagonal, etc.) and mirror and discrete rotational symmetries for faster calculations

• Evaluation of cluster cross-sections and optical force and torque on individual particles

• OpenMP parallelization for systems with larger numbers of particles

Usage

For examples and use cases, see examples folder.

For full documentation, see docs folder.

Installation

If NumPy is not already installed, it must be installed prior to MiePy’s installation `shell pip install numpy ` Then install MiePy `shell pip install miepy `

To build MiePy from source, first install the required dependencies:

• [CMake](https://cmake.org/install/) (C++ build system)

• [Eigen](http://eigen.tuxfamily.org/index.php?title=Main_Page) (C++ linear algebra library)

• [GNU Scientific Library (GSL)](https://www.gnu.org/software/gsl/)

• GCC and GFORTRAN

• Python 3 and pip

Then, install MiePy using pip `shell pip install miepy --no-binary `

To build the latest development version, clone MiePy and its submodules: `shell git clone https://github.com/johnaparker/miepy.git miepy --recurse-submodules && cd miepy ` and install MiePy using pip `shell pip install . ` Optionally, run the tests to verify correctness: `shell pytest tests `

Sample Output

License

MiePy is licensed under the terms of the GPLv3 license.