PyMieSim
PyMieSim is a software designed for comprehensive Mie scattering analysis, featuring a user-friendly installation and operation process. The characterization of the scattering event within PyMieSim is determined by a set of specific properties, as illustrated in the subsequent figure.
Currently, PyMieSim integrates three distinct solvers tailored to three different types of scatterers: spherical particles, infinite cylindrical particles, and core-shell spherical particles. Additional parameters governing the scattering event are contingent upon the attributes of the light source and the detector (when applicable). The attributes pertinent to each of these components are delineated in the ensuing figure.
The package also lets you construct an Experiment using SphereSet/CoreShellSet/CylinderSet, SourceSet and DetectorSet. Those class define the type of scatterers, light sources and detectors you want to study.
Getting started
PyMieSim was developed to be a used in Python script as shown in the documentation section. Although, since version 1.7.0 it is possible to use the new graphical user interface. To use is, you first need to install it:
>>> pip install PyMieSimOnce this is done you can run the graphic interface as follows:
>>> python -m PyMieSimClicking the “Calculate” button should render the following:
Documentation
All the latest available documentation is available here or you can click the following badge:
Google Colab
It’s 2024, you don’t need to run all your code on you computer anymore. Google Colab is a platform which allows to write/use python scripts remotely. You can open the PyMieSim.ipynb in the file to access it or click on the following “Open in Colab” badge:
Installation
For common version of Windows, Linux and MacOS, (on x86_64 architecture), the package can readily be installed using pip;
>>> pip install PyMieSimThe ready to install wheel is not available for arm chip of the newer mac M1, M2 product. You can however install manually the package.
If, however, this fail you can build the package from scratch following the steps on the Manual building section.
Note: Wheel support now extended to manylinux2014.
Manual building
To manually buld the project on your computer make sure that you do have gcc installed (c++ and fortran compiler), plus python version 3.7+. For windows system I recommend install MingGW with g++ and fortran compiler.
This being done, the following commands should do the trick.
Linux / MacOs
>>> git clone https://github.com/MartinPdeS/PyMieSim.git
>>> cd PyMieSim
>>> git submodule init && git submodule update
>>> mkdir build
>>> cd build
>>> cmake ../ -G"Unix Makefiles" (macOS, Linux)
>>> cmake ../ -G"MinGW Makefiles" (Windows)
>>> sudo make install
>>> cd ..
>>> python -m pip install .Testing
To test localy (with cloning the GitHub repository) you’ll need to install the dependencies and run the coverage command as
>>> git clone https://github.com/MartinPdeS/PyMieSim.git
>>> cd PyMieSim
>>> pip install -r requirements/requirements.txt
>>> coverage run --source=PyMieSim --module pytest --verbose tests
>>> coverage report --show-missingCoding examples
Plenty of examples are available online, I invite you to check the examples section of the documentation.
Scientific article
The associated article is free of access on this link article
Citing this work?
I spent a full year to develop this tool for you to use so if it helped you in your research, I would greatly appreciate you citing the article associated to my work. Many thanks!
@article{PoinsinetdeSivry-Houle:23,
author = {Martin Poinsinet de Sivry-Houle and Nicolas Godbout and Caroline Boudoux},
journal = {Opt. Continuum},
keywords = {Light scattering; Mie theory; Optical coherence tomography; Radiation pressure; Scattering theory; Surface plasmon resonance},
number = {3},
pages = {520--534},
publisher = {Optica Publishing Group},
title = {PyMieSim: an open-source library for fast and flexible far-field Mie scattering simulations},
volume = {2},
month = {Mar},
year = {2023},
url = {https://opg.optica.org/optcon/abstract.cfm?URI=optcon-2-3-520},
doi = {10.1364/OPTCON.473102},
abstract = {},
}Contact Information
As of 2024, the project is still under development. If you want to collaborate, it would be a pleasure! I encourage you to contact me.
PyMieSim was written by Martin Poinsinet de Sivry-Houle .
1 maintainer
Release files for PyMieSim 1.7.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 522.4 MB
Release files / PyMieSim-1.7.4-cp312-cp312-win_amd64.whl
| Download URL | PyMieSim-1.7.4-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 36.8 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
8e4508c99044c10315029a28fb2b383bd37d572bba58e3bec002b09506204799
|
|
BLAKE2b-256 checksum How to use checksums |
d34aa528f1f86aa63a5a195ea06424ef06b94a47946eac1e83990d34e1c43ba4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 36.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
75db6ac067a03704b8df626eec1c4c6ecd52ddf2804edfb3a3af8b439ec216c5
|
|
BLAKE2b-256 checksum How to use checksums |
e1bd9d509a8babe624d013da54bd87a2c6c81a20c6f4abeeb264b776d0be3e2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | PyMieSim-1.7.4-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 37.5 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c76a3836012c91c1c3cdd53883d6ce68c533083f36a698ffb1e8b8d58c070553
|
|
BLAKE2b-256 checksum How to use checksums |
f41e246167b3b9822f1c38974b054b9e02a426453b0ce536976ac66df0e653ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp312-cp312-macosx_10_13_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp312-cp312-macosx_10_13_x86_64.whl |
|---|---|
| Size | 37.5 MB |
| Tags | CPython 3.12 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
83689f4c8edae7de1dcd4f4fb6b394f299a7f81a3ba81e057aef2e9674d7b46d
|
|
BLAKE2b-256 checksum How to use checksums |
32ff9cb3d9cf7c9a33a69f8f415432c71cde5dae531d957e7b9cd88ebd2eea37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp312-cp312-macosx_10_13_universal2.whl
| Download URL | PyMieSim-1.7.4-cp312-cp312-macosx_10_13_universal2.whl |
|---|---|
| Size | 37.5 MB |
| Tags | CPython 3.12 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
9048635967be60d5a0b9904a652d99b54dae1f05618c025b5d207753d62d9a6c
|
|
BLAKE2b-256 checksum How to use checksums |
e419e416056625ab35ce794c3aeed9c442c85dddf1f6607b1632a0178157a8c1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp311-cp311-win_amd64.whl
| Download URL | PyMieSim-1.7.4-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 34.5 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
472ed9a2ae422d01150808544e5bc5eb299e2036d61ab71a4b174b04c25310a5
|
|
BLAKE2b-256 checksum How to use checksums |
ca25f596e380997bde53247ab31b1198df80bee78e30c50c17a3c9014c82413b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 34.7 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
384d1889d6ed7e2c2c2b1cca6849fcd9278665104ac3409012fb6fd936393238
|
|
BLAKE2b-256 checksum How to use checksums |
2750d470fd0de2d62d80bcbd3b8248401bd5f3b7a4f31471d700159a98e9e18f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | PyMieSim-1.7.4-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 35.0 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
6114b5a7b4926fa33b502ab8193948646197fa27135b22bcfba1526ab011fa55
|
|
BLAKE2b-256 checksum How to use checksums |
468b2b3f25b7be1fa41b93192d963965ee22a1e26a8809c7a8b55ded22da1053
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp311-cp311-macosx_10_13_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp311-cp311-macosx_10_13_x86_64.whl |
|---|---|
| Size | 35.0 MB |
| Tags | CPython 3.11 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
6bd50ea623a38c72ad2e73794a9ded23cc9b3ed5ac8518b104fa71c26b907b6c
|
|
BLAKE2b-256 checksum How to use checksums |
b4cddeb03fdfcee52546d2f6748368a91b26f43900b8189f2e3f9f60d24727d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp311-cp311-macosx_10_13_universal2.whl
| Download URL | PyMieSim-1.7.4-cp311-cp311-macosx_10_13_universal2.whl |
|---|---|
| Size | 35.0 MB |
| Tags | CPython 3.11 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
e2105e7784d7c7d71a5b91f37a62d4e6842fd3c4f188773dff4229fae60e7a65
|
|
BLAKE2b-256 checksum How to use checksums |
d67656042a37c1ccbf46889fb76052f4792272f08b86757e3cb81657a3da0c5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp310-cp310-win_amd64.whl
| Download URL | PyMieSim-1.7.4-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 32.1 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
527975b8a767f57fd1b42a1aea471f7fdd8743dc4f23280eb454ed2b8e35cbd2
|
|
BLAKE2b-256 checksum How to use checksums |
11eecc6bbfe3587f190a6123a7c9d64922a646d8a4bd556fd21af8685e2a6deb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 32.8 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
4497e909a76a0393112f04c315e609e76566199c776cc8ee11c3088aa54da8fb
|
|
BLAKE2b-256 checksum How to use checksums |
83145177e8f8cdf93a59c309fd00912a2914a46aa10954ee53abc9ce91184784
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | PyMieSim-1.7.4-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 32.5 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a55240a882b559bf28a1a49b76fed39e285e48b4fc65e9a50733cfc463ea24b8
|
|
BLAKE2b-256 checksum How to use checksums |
0cf0fca4d786c81b10a84de677f534337d389e1ec82e23a6fc3ac7e5a94ad46e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp310-cp310-macosx_10_13_x86_64.whl
| Download URL | PyMieSim-1.7.4-cp310-cp310-macosx_10_13_x86_64.whl |
|---|---|
| Size | 32.5 MB |
| Tags | CPython 3.10 macOS 10.13+ x86-64 |
|
SHA-256 checksum How to use checksums |
9b451df69b37d60bdf725759b817933bf001afe443c3ef108b34f3b6c301e265
|
|
BLAKE2b-256 checksum How to use checksums |
900d2c9e174616fbd924036bcadecddbb98b044d1bc6362db0d3a22ed24bd917
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
Release files / PyMieSim-1.7.4-cp310-cp310-macosx_10_13_universal2.whl
| Download URL | PyMieSim-1.7.4-cp310-cp310-macosx_10_13_universal2.whl |
|---|---|
| Size | 32.5 MB |
| Tags | CPython 3.10 macOS 10.13+ universal2 (ARM64, x86-64) |
|
SHA-256 checksum How to use checksums |
a6f2ff726fffab5589ee13172059eb32f033502593315443e19a1434c8dba901
|
|
BLAKE2b-256 checksum How to use checksums |
814ddb206c05080475ce33fb407e5017587e9763db8a5cff2cb361b130697241
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.19
|
