MieSimulatorGUI: A user-friendly tool to compute and visualize light scattering by spherical dielectric particles

MieSimulatorGUI: A user-friendly tool to compute and visualize light scattering by spherical dielectric particles - Published in JOSS (2026)

https://github.com/virtualphotonics/miesimulatorgui

Science Score: 87.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 7 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: wiley.com, iop.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software
Last synced: 9 days ago · JSON representation

Repository

Mie Simulator GUI

Basic Info
  • Host: GitHub
  • Owner: VirtualPhotonics
  • License: mit
  • Language: C++
  • Default Branch: master
  • Homepage:
  • Size: 12.9 MB
Statistics
  • Stars: 27
  • Watchers: 3
  • Forks: 9
  • Open Issues: 1
  • Releases: 10
Created over 8 years ago · Last pushed 16 days ago
Metadata Files
Readme Contributing License Code of conduct

README.MD

Mie Simulator GUI

The Mie Simulator GUI is an open-source, user-friendly tool designed to calculate the characteristics of Mie scatterers. It determines various properties, including the spectral dependence of the scattering coefficient, scattering cross-section, reduced scattering coefficient, phase function, average cosine of the phase function, and forward/backward scattering percentage. Additionally, it calculates scattering matrix entries for single or multiple wavelengths. Based on the Lorentz-Mie solution, these calculations can be performed for both mono-disperse and poly-disperse distributions. The tool can also estimate fitting parameters from the reduced scattering coefficient curve, though its capabilities are limited to the characteristics of the far-field scattering pattern.

This GUI tool is based on the BHMIE code. For absorbing spheres, the tool uses the complex refractive index definition (msphere = mreal – j mimag) as described in van de Hulst's Light Scattering by Small Particles (1957) book. To understand the Mie algorithm and other parameters within the GUI, refer to, read Bohren and Huffman's Absorption and Scattering of Light by Small Particles, (1983) book, Maetzler's research report and Scott Prahl's 'Mie Basics' web page. Phase function calculations for mixtures of spheres are based on the work by Gélébart et al. in Pure and Applied Optics, 5 (1996). The reduced scattering power law fitting functions are derived from Steve L. Jacques's review paper in Phys. Med & Bio. 58 (2013). All relevant documentation, including complete installation guides for Windows, Linux and macOS is available on the Mie Simulator GUI Wiki page.

Mie-Application

Downloads

To download the latest version, click here

Releases and Source Codes

To access all releases and source codes, click here.

Documentation

  • Getting started with the application and source code

    • For Windows, click here.
    • For Linux, click here.
    • For MacOS, click here.
  • Description of GUI panels and running application, click here

    • Guidelines for third parties
    • Contributing to the Software, click here.
    • Reporting Issues, and Seeking Support, click here.
    • Comparison
    • For an example demonstrating the comparison between MieSimulatorGUI and Scott Prahl's Mie Scattering Calculator, click here.

Acknowledgement

Use the following citation or acknowledgement in publications or applications that make use of this open source software or underlying technology and research:

"We acknowledge open-source software resources offered by the Virtual Photonics Technology Initiative (https://virtualphotonics.org), at the Beckman Laser Institute, University of California, Irvine."

In addition, for any work that utilizes the Mie Simulator GUI software, cite the following publication"

Janaka C. Ranasinghesagara, Carole K. Hayakawa, Lisa M. Glover, Vasan Venugopalan, "MieSimulatorGUI: A user-friendly tool to compute and visualize light scattering by spherical dielectric particles," Journal of Open Source Software 11(118), 9551 (2026) https://doi.org/10.21105/joss.09551

Software

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Copyright

Virtual Tissue Simulator (VTS) Project.

Copyright ©2026 Virtual Photonics Technology Initiative.

Owner

  • Name: Virtual Photonics
  • Login: VirtualPhotonics
  • Kind: organization
  • Location: UCI

Virtual Photonics Technology Initiative

JOSS Publication

MieSimulatorGUI: A user-friendly tool to compute and visualize light scattering by spherical dielectric particles
Published
February 11, 2026
Volume 11, Issue 118, Page 9551
Authors
Janaka C. Ranasinghesagara ORCID
Department of Chemical and Biomolecular Engineering, University of California, Irvine, California 92697, United States, Beckman Laser Institute and Medical Clinic, University of California, Irvine, California 92697, United States
Carole K. Hayakawa ORCID
Department of Chemical and Biomolecular Engineering, University of California, Irvine, California 92697, United States, Beckman Laser Institute and Medical Clinic, University of California, Irvine, California 92697, United States
Lisa M. Glover ORCID
Beckman Laser Institute and Medical Clinic, University of California, Irvine, California 92697, United States
Vasan Venugopalan ORCID
Department of Chemical and Biomolecular Engineering, University of California, Irvine, California 92697, United States, Beckman Laser Institute and Medical Clinic, University of California, Irvine, California 92697, United States
Editor
Henrik Finsberg ORCID
Tags
Mie scattering Lorenz-Mie theory Scattering Spherical particles Scattering efficiency Phase function

GitHub Events

Total
  • Release event: 2
  • Member event: 1
  • Issues event: 1
  • Watch event: 4
  • Issue comment event: 3
  • Push event: 99
  • Gollum event: 46
  • Create event: 4
Last Year
  • Release event: 2
  • Member event: 1
  • Issues event: 1
  • Watch event: 3
  • Issue comment event: 3
  • Push event: 99
  • Gollum event: 45
  • Create event: 4

Issues and Pull Requests

Last synced: 16 days ago

All Time
  • Total issues: 5
  • Total pull requests: 4
  • Average time to close issues: 7 months
  • Average time to close pull requests: 6 minutes
  • Total issue authors: 4
  • Total pull request authors: 2
  • Average comments per issue: 1.6
  • Average comments per pull request: 1.0
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 1.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • probonopd (2)
  • finsberg (1)
  • gtkenned (1)
  • swawa (1)
Pull Request Authors
  • janakarana (3)
  • lmalenfant (1)
Top Labels
Issue Labels
help wanted (2) bug (1)
Pull Request Labels