Skip to main content

Light scattering by multiple particles in thin-film systems

Project description Documentation Status

SMUTHI stands for ‘scattering by multiple particles in thin-film systems’. The software allows to simulate light scattering by multiple particles near (or between) planar interfaces. It is based on the T-matrix method for the single particle scattering, and on the scattering-matrix method for the propagation through the layered medium.

Target group: Scientists and engineers in the field of optics and optoelectronics.

License: SMUTHI is provided under the MIT license.

Author: Amos Egel (

The following persons have contributed to the project: Amos Egel, Dominik Theobald, Krzysztof Czajkowski, Konstantin Ladutenko, Alexey Kuznetsov, Lorenzo Pattelli.

We thank Adrian Doicu, Thomas Wriedt and Yuri Eremin for allowing us to use their NFM-DS Fortran code, Giacomo Mazzamuto, Ilia Rasskazov as well as Fabio Mangini for bug reports, useful comments and smaller code additions and HÃ¥kan T Johansson for making his pywigjxpf software availible through PyPi and also under Windows.

For a guide how to install and use the software, see the documentation.

If you are using Smuthi, please subscribe to the Smuthi mailing list. The list is also a good place to ask for support from the developers or from experienced users.

To report a bug, you can also open an issue in Gitlab.

Contributions are highly welcome! Please refer to the contribution guidelines.

What’s new in version 1.2

Several small bug fixes, support of STL-format for custom shaped particles, support for layered spheroids, accelerated near field evaluations in CPU mode, improved algorithms for automatic parameter selection, support for magnetic field calculations.

The following changes break backward compatibility: - Extinction cross section is now by default a single number, as opposed to a dictionary with “top” and “bottom” part - Angular resolution parameters are now provided in radians (like all other angular quantities).

What’s new in version 1.1

The interface to NFM-DS has undergone a major revision and is now offered in the form of an F2Py Fortran extension (no more dealing with input and output text files or temporary NFM-DS directories). Several new particle classes were added (anisotropic sphere, custom shape particles). Advanced automatic parameter selection. Binary wheels on PyPi, such that no Fortran compiler is necessary on Windows machines. The release workflow was automatized using GitLab CI and Appveyor. Revision of the graphical output. New application examples and user guide sections were added to the online documentation. The simulation from input data files (rather than Python scripts) is no longer supported. Several smaller changes and bug fixes.

What’s new in version 1.0

A major bug that significantly slowed down Smuthi under Windows was fixed. The module structure has undergone a major review (unfortunately, backwards compatibility cannot be granted and you might need to adapt some import statements in your scripts when updating to version 1.0). For spheres, the calculation of internal fields (i.e., inside the particle) was implemented. A module for automatic selection of numerical parameters has been added (still in beta). For non-spherical particles, Smuthi now requires the GNU Fortran compiler also under Windows (MinGW). The use of the precompiled executable is deprecated. Pywigxjpf is now also available for Windows - however, the sympy fallback solution for the calculation of the Wigner3j symbols is still provided. Convenience functions for the definition of reasonable Sommerfeld contours have been added and can be managed through the simulation class (call to “set_default_k_parallel” no more necessary). Plenty of smaller changes and bug fixes. Advanced logging.

What’s new in version 0.9

MPI support for the parallel execution of many simulations, acceleration with Numba JIT, faster evaluation of Wigner3j symbols through pywigxjpf

What’s new in version 0.8

Support for rotated particles, GPU support for the calculation of the near field.

What’s new in version 0.7

Iterative solver (GMRES), lookup tables and GPU support were added for fast simulations including large particle numbers.

What’s new in version 0.6

Dipole sources are supported as initial field.

What’s new in version 0.5

Gaussian beams (more precisely: beams with transverse Gaussian footprint) are supported as initial field.

What’s new in version 0.4

The data structure has been updated to a more consequent object oriented approach, including a PlaneWaveExpansion class and a SphericalWaveExpansion class. Smuthi’s API is now also documented.

What’s new in version 0.3

The software now allows to compute the electric near field. The fields can be plotted as png figure files and as gif animations. All generated output can be stored as figure files or as text files. The simulation object can be exported as binary file.

What’s new in version 0.2.2

Finite cylinders were added.

What’s new in version 0.2

In addition to spherical particles, spheroids can now be selected as scattering particles, too. Spheroids are ellipsoidal particles with one axis of rotational symmetry (which is currently fixed to be the direction perpendicular to the layer interfaces).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for SMUTHI, version 1.2.4
Filename, size File type Python version Upload date Hashes
Filename, size SMUTHI-1.2.4-cp36-cp36m-manylinux2010_x86_64.whl (2.4 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp36-cp36m-win_amd64.whl (2.0 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp37-cp37m-manylinux2010_x86_64.whl (2.4 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp37-cp37m-win_amd64.whl (2.0 MB) File type Wheel Python version cp37 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp38-cp38-manylinux2010_x86_64.whl (2.4 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp38-cp38-win_amd64.whl (2.0 MB) File type Wheel Python version cp38 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp39-cp39-manylinux2010_x86_64.whl (2.4 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size SMUTHI-1.2.4-cp39-cp39-win_amd64.whl (2.0 MB) File type Wheel Python version cp39 Upload date Hashes View
Filename, size SMUTHI-1.2.4.tar.gz (101.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page