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.
- 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)
- Evaluation of cluster cross-sections and optical force and torque on individual particles
- Periodic boundary conditions with various lattice types (square, hexagonal, etc.) and mirror and discrete rotational symmetries for faster calculations
- Optional planar interface (substrate)
- 3D scene visualization using the the VPython library
- Image clusters using a simulated microscope
- OpenMP parallelization for systems with larger numbers of particles
For examples and use cases, see examples folder.
For an overview of the theory, see docs folder.
If NumPy is not already installed, it must be installed prior to MiePy's installation
pip install numpyThen install MiePy
pip install miepyMiePy is also available via Conda
conda install -c japarker miepyTo build MiePy from source, first install the required dependencies:
- CMake (C++ build system)
- Eigen (C++ linear algebra library)
- GNU Scientific Library (GSL)
- GCC and GFORTRAN
- Python 3 and pip
Then, install MiePy using pip
pip install miepy --no-binaryTo build the latest development version, clone MiePy and its submodules:
git clone https://github.com/johnaparker/miepy.git miepy --recurse-submodules && cd miepyand install MiePy using pip
pip install .Optionally, run the tests to verify correctness:
pytest testsMiePy is licensed under the terms of the GPLv3 license.