PPOPS
Performance Prediction for Optical Particle Spectrometer
Documentation: https://rtd-ppops.readthedocs.io/
Overview
This repository simulates the performance of a simple Optical Particle Spectrometer (OPS) using a physics-based model. The default optical system is based on Gao et al., Aerosol Sci. Technol., 2016, which is also what the POPS instrument sold by Handix Scientific is based on. The PPOPS model is semi-validated in that PPOPS modeled signal was within 50% of the actual signal of a POPS unit from Handix Scientific (see validation section of PPOPS website for more information).
The PPOPS model calculates the amount and direction of scattered light by aerosols according to Mie theory. The scattered light is integrated over the solid-angle acceptance of the collection mirror to calculate a truncated scattering cross section (the effective scattering cross section). This truncated scattering cross section is then used to calculate the instrument signal and noise current.
To summarize, the PPOPS workflow includes,
- Use miepython to calculate the scattering amplitudes (
S₁,S₂) according to Mie theory.- Compute Mie coefficients (
a_n,b_n) for electric and magnetic scattering modes. - Generate angular functions (
π_n,τ_n) that describe angle-dependent intensity.
- Compute Mie coefficients (
- Integrating over the OPS collection mirror’s polar and azimuthal acceptance to compute the truncated scattering cross section.
- Convert the truncated scattering cross section to signal and noise current based on detector specifications.
- Optionally, convert signal current to digitizer bins for direct comparison with POPS data.
Assumptions
This package makes several assumptions:
- Particles are perfectly spherical.
- Scattering is elastic.
- All scattered light incident on the collection mirror is detected.
- The only noise sources are signal noise, dark noise, and preamp noise (i.e., we neglect stray scattering).
- The detector is shot noise limited.
Installation
PPOPS is available via PyPI
pip install ppops
Usage
See PPOPS website for more information.
import ppops
ops = ppops.OpticalParticleSpectrometer()
ops.estimate_signal_noise(diameters = [0.1, 0.5, 1.0], ior = 1.5+0.001j)
References
Gao, R.S., Telg, H., McLaughlin, R.J., Ciciora, S.J., Watts, L.A., Richardson, M.S., Schwarz, J.P., Perring, A.E., Thornberry, T.D., Rollins, A.W., Markovic, M.Z., Bates, T.S., Johnson, J.E., Fahey, D.W., 2016. A light-weight, high-sensitivity particle spectrometer for PM2.5 aerosol measurements. Aerosol Science and Technology 50, 88–99. https://doi.org/10.1080/02786826.2015.1131809
miepython: 10.5281/zenodo.7949263
Author Notes
This repository is intended as a transparent, well-documented implementation of Mie scattering and optical geometry for POPS performance prediction and analysis.
License
PPOPS is released under the MIT license.
Metadata
Release files for ppops 0.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ppops-0.0.0.tar.gz | 18.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ppops-0.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 32.8 kB
Release files / ppops-0.0.0.tar.gz
| Download URL | ppops-0.0.0.tar.gz |
|---|---|
| Size | 18.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b59d3a4f910f49b69f6f89036a6f7b33dff628694a9b74e411a71ffe07c1c134
|
|
BLAKE2b-256 checksum How to use checksums |
91e4d2c9bfd282749a0bf06ba39235f4f4e2395e4054741913a56775229b6ced
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Mar 4, 2026.
Transparency logRelease files / ppops-0.0.0-py3-none-any.whl
| Download URL | ppops-0.0.0-py3-none-any.whl |
|---|---|
| Size | 13.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
52f336d542e34a60bc2f9f6b62f5e1741485a021e6e7f192c08cfb0845a2efce
|
|
BLAKE2b-256 checksum How to use checksums |
c1b137dae718eef8a8ed4066fa2fa64c314eed0c9d6550b411d6b94d384f288e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Mar 4, 2026.
Transparency log