Skip to main content

pylorenzmie

PyPI version Python versions License Documentation DOI Tests

Python routines for tracking and characterizing colloidal particles with in-line holographic video microscopy (HVM)

Explanation of the module

pylorenzmie provides a set of python classes for interacting with and analyzing holographic microscopy data. The hologram of a colloidal particle encodes comprehensive information about the particle's size, composition, and location in three dimensions. This package extracts that information by fitting a recorded hologram to a generative model based on the Lorenz-Mie theory of light scattering.

Typical Hologram

Interactive particle tracking and characterization

pylorenzmie includes a GUI application called LMTool.py for interacting with experimentally recorded holograms.

LMTool image screen LMTool profile screen LMTool fit screen

Authors

David G. Grier (New York University), Lauren Altman, Fook Chiong Cheong, Mark D. Hannel, Sanghyuk Lee, Michael O'Brien, Sarah Odeh, Kaitlynn Snyder, Jackie Sustiel

Licensing.

GPLv3

References:

Lorenz-Mie analysis of colloidal particles

  1. S.-H. Lee, Y. Roichman, G.-R. Yi, S.-H. Kim, S.-M. Yang, A. van Blaaderen, P. van Oostrum and D. G. Grier, "Characterizing and tracking single colloidal particles with video holographic microscopy," Optics Express 15, 18275-18282 (2007).
  2. C. Martin, L. E. Altman, S. Rawat, A. Wang, D. G. Grier and V. N. Manoharan, "In-line holographic microscopy with model-based analysis," Nature Reviews Methods Primers 2, 83 (2022).

Lorenz-Mie theory of light scattering

  1. C. F. Bohren and D. R. Huffman, Absorption and Scattering of Light by Small Particles (Wiley 1983).
  2. M. I. Mishchenko, L. D. Travis and A. A. Lacis, Scattering Absorption and Emission of Light by Small Particles (Cambridge University Press, 2002).
  3. G. Gouesbet and G. Gréhan, Generalized Lorenz-Mie Theories (Springer, 2011).

Computational methods

  1. W. Yang, "Improved recursive algorithm for light scattering by a multilayered sphere," Applied Optics 42, 1710--1720 (2003).
  2. O. Pena and U. Pal, "Scattering of electromagnetic radiation by a multilayered sphere," Computer Physics Communications 180, 2348-2354 (2009).
  3. W. J. Wiscombe, "Improved Mie scattering algorithms," Applied Optics 19, 1505-1509 (1980).
  4. A. A. R. Neves and D. Pisignano, "Effect of finite terms on the truncation error of Mie series," Optics Letters 37, 2481-2420 (2012).

Acknowledgements

Work on this project at New York University is supported by the National Science Foundation of the United States under award number DMR-2428983.

Metadata

Release files for pylorenzmie 2.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pylorenzmie 2.0.1
File Size Uploaded
pylorenzmie-2.0.1.tar.gz 2.2 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for pylorenzmie 2.0.1
File Interpreter ABI Platform
pylorenzmie-2.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 4.3 MB

Release files / pylorenzmie-2.0.1.tar.gz

Download URL pylorenzmie-2.0.1.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
54a803580e913786f0f444f9380d865d1c86b62cf9a9bcdbf040d584cfbae7ff
BLAKE2b-256 checksum
How to use checksums
1e5f075a178d7ac8e431904153b1666838a0df1ff1eb89833958fbb4106ba711
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.

Transparency log

Release files / pylorenzmie-2.0.1-py3-none-any.whl

Download URL pylorenzmie-2.0.1-py3-none-any.whl
Size 2.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
66d2a96c0ceac27817b27f49874451ee1f9a0ec5774c6d39c2dc25221b932cab
BLAKE2b-256 checksum
How to use checksums
804355763f4ca5f7e25e824f092de4f27f9e3a8fb1506986a7a67e4da661498d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 8, 2026.

Transparency log

Release history Release notifications | RSS feed

3.3.1

2 release files

3.3.0

2 release files

3.2.0

2 release files

3.1.1

2 release files

3.1.0

2 release files

3.0.0

2 release files

This release

2.0.1 This release

2 release files

2.0.0

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page